io.github.aaronmsoto/finops-framework-mcp

What it mainly works on, as our AI model read its tool descriptions: nothing outside itself: it only answers questions.

None of its 11 tools are described as changing anything.

• get_framework_inforeads or searches

  “Start here.”

  Publisher declares: read-only yes · idempotent yes · open-world no

  Takes no inputs.

• search_frameworkreads or searches

  “Ranked keyword search over every entity (capabilities, KPIs, personas, principles, phases, domains, technology categories, maturity levels, scopes).”

  Publisher declares: read-only yes · idempotent yes · open-world no

  4 inputs, 1 required

  • querystringrequired“Keywords, e.g.”
  • entity_typesarray“Restrict to these entity types (default: all)”
  • limitinteger
  • cursorstring“Opaque cursor from a previous call”
• list_capabilitieson 109 other serversreads or searches

  “All 22 capabilities (slug, title, domain, one-line summary), optionally filtered by `domain` and/or `persona` (both take a slug, e.g.”

  Publisher declares: read-only yes · idempotent yes · open-world no

  4 inputs

  • domainstring“Domain slug, e.g.”
  • personastring“Persona slug, e.g.”
  • limitinteger
  • cursorstring
• get_capabilityon 20 other serversreads or searches

  “One capability's content, section-selectable via `include` to control size.”

  Publisher declares: read-only yes · idempotent yes · open-world no

  3 inputs, 1 required

  • capabilitystringrequired“Capability slug, e.g.”
  • includearray“Sections to return (default [summary, definition])”
  • personastring“With include:['activities']: return only this persona's activities”
• get_maturity_assessmentreads or searches

  “The official FinOps Framework maturity assessment prose for a capability, verbatim, at one level (crawl|walk|run) or all three.”

  Publisher declares: read-only yes · idempotent yes · open-world no

  2 inputs, 1 required

  • capabilitystringrequired“Capability slug, e.g.”
  • levelstring“One level; omit for all three official levels”
• get_kpison 3 other serversreads or searches

  “Full KPI records: description, formula + candidate data sources (present for the 44 KPIs the site details in capability-page popups), official related capabilities, and where each is featured.”

  Publisher declares: read-only yes · idempotent yes · open-world no

  5 inputs

  • slugstring“Exact KPI slug for a single-record lookup, e.g.”
  • capabilitystring“Only KPIs featured on or officially related to this capability”
  • featured_onlyboolean“With `capability`: only KPIs featured on that capability's own page; alone: only KPIs featured on some page”
  • limitinteger
  • cursorstring
• assess_maturity_pathreads or searches

  “For one capability, the official maturity assessment text at each level between current and target — evidence to look for when maturing.”

  Publisher declares: read-only yes · idempotent yes · open-world no

  3 inputs, 3 required

  • capabilitystringrequired“Capability slug, e.g.”
  • current_levelstringrequired“Starting maturity level, exclusive — the gap begins above this”
  • target_levelstringrequired“Ending maturity level, inclusive — must be above current_level”
• map_personasreads or searches

  “With `persona`: every capability that persona works in, WITH that persona's activity bullets inline (one call answers 'what does X do across the framework').”

  Publisher declares: read-only yes · idempotent yes · open-world no

  2 inputs

  • capabilitystring“Capability slug, e.g.”
  • personastring“Persona slug, e.g.”
• get_entityon 45 other serversreads or searches

  “Full rendered markdown for entity types that have no dedicated tool.”

  Publisher declares: read-only yes · idempotent yes · open-world no

  2 inputs, 1 required

  • entity_typestringrequired
  • slugstring“Required for entity_type 'persona'; ignored otherwise”
• get_maturity_modelreads or searches

  “The official FinOps maturity model: Crawl/Walk/Run with each level's characteristics and the community's sample goals/KPIs (e.g.”

  Publisher declares: read-only yes · idempotent yes · open-world no

  Takes no inputs.

• get_changelogon 12 other serversreads or searches

  “What changed between data versions of this server's crawled artifact (rolling window of the 20 most recent refreshes — the crawler caps the log at 20, so this tool covers the full retained history; t…”

  Publisher declares: read-only yes · idempotent yes · open-world no

  1 input

  • limitinteger

Each quoted sentence is the first sentence of the publisher’s own description. The kind of tool and the “changes data” mark are our AI model’s reading of that description, not something we tested: two differently worded runs had to agree, otherwise no label is shown, and nobody has checked them by hand. A tool without the “changes data” mark is described as only reading, searching or calculating, or the two runs did not agree. No tool was called. Read the publisher’s full description before relying on it. “Publisher declares” lists the hints the server itself sends with the tool (MCP annotations: read-only, destructive, idempotent, open-world); they are the publisher's claims, not checked by us. Inputs are the parameters in the tool's own input schema: name, declared type, whether it is required, and the first sentence of its description. Read 2026-10-23.

The registry verifies a package once, when it is published, and does not re-check it. A difference below is about the listing, not a judgement of the publisher.