# io.github.aaronmsoto/finops-framework-mcp (npm · finops-framework-mcp)

Unofficial MCP server for the FinOps Framework: phases, domains, capabilities, maturity, KPIs.

- Trust score: 82/100 (high trust)
- Change this week: 0
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-04

## Components

- npm · `finops-framework-mcp`: 82/100 (this document), [markdown](https://verifymcp.io/servers/aaronmsoto-finops-framework-mcp/finops-framework-mcp.md), [page](https://verifymcp.io/servers/aaronmsoto-finops-framework-mcp/finops-framework-mcp)

## Channel facts

- Registry: `npm`
- Package: `finops-framework-mcp`
- Version: `0.2.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-04.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 30 of 92 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 100/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to aaronmsoto/finops-framework-mcp).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 14 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 82/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 2494 tokens (~45/item across 55 items; 11 tools + 44 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 92/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 73% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 11 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 13 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### How do I install the io.github.aaronmsoto/finops-framework-mcp server?

io.github.aaronmsoto/finops-framework-mcp runs locally as an npm package, launched with npx -y finops-framework-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add aaronmsoto-finops-framework-mcp -- npx -y finops-framework-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "aaronmsoto-finops-framework-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "finops-framework-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "aaronmsoto-finops-framework-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "finops-framework-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add aaronmsoto-finops-framework-mcp -- npx -y finops-framework-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "aaronmsoto-finops-framework-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "finops-framework-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add aaronmsoto-finops-framework-mcp --command npx --arg -y --arg finops-framework-mcp
```

### Hermes

```yaml
mcp_servers:
  aaronmsoto-finops-framework-mcp:
    command: "npx"
    args: ["-y", "finops-framework-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "aaronmsoto-finops-framework-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "finops-framework-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add aaronmsoto-finops-framework-mcp -t stdio -c npx -a -y finops-framework-mcp
```

### Other

```json
{
  "mcpServers": {
    "aaronmsoto-finops-framework-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "finops-framework-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-21 (score 82, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-10-20 (score 67)

First indexed and scored.

## MCP tools (11)

### `get_framework_info` (~41 tokens)

Framework & server orientation

Start here. Returns the framework's structure (entity counts), the data version/crawl date/license, and how to navigate this server's tools. No parameters.

Output parameters:

- `counts` (object)
- `crawled_at` (string)
- `data_version` (string)
- `license` (string)
- `overview_md` (string)

### `search_framework` (~204 tokens)

Search the framework

Ranked keyword search over every entity (capabilities, KPIs, personas, principles, phases, domains, technology categories, maturity levels, scopes). Returns slug + uri per hit. Feed the slug to `get_kpis(slug: …)`, or pass it as `capability: <slug>` to get_capability/get_maturity_assessment/assess_maturity_path/map_personas and as `persona: <slug>` where a persona filter is accepted. Other entity types (principles, phases, domains, technology categories, scopes) are read via get_entity(entity_type: …) or the hit's finops:// resource uri. Use this whenever you don't already know a slug.

Input parameters:

- `cursor` (string): Opaque cursor from a previous call
- `entity_types` (array): Restrict to these entity types (default: all)
- `limit` (integer)
- `query` (string, required): Keywords, e.g. 'unallocated spend tagging'

Output parameters:

- `nextCursor` (string)
- `results` (array)
- `total` (number)

### `list_capabilities` (~133 tokens)

List capabilities

All 22 capabilities (slug, title, domain, one-line summary), optionally filtered by `domain` and/or `persona` (both take a slug, e.g. domain="understand-usage-and-cost", persona="finance"). The framework does not assign capabilities to phases, so there is deliberately no phase filter. Default limit returns the full list in one call.

Input parameters:

- `cursor` (string)
- `domain` (string): Domain slug, e.g. 'understand-usage-and-cost'
- `limit` (integer)
- `persona` (string): Persona slug, e.g. 'finance'

Output parameters:

- `capabilities` (array)
- `nextCursor` (string)
- `note` (string)
- `total` (number)

### `get_capability` (~158 tokens)

Get one capability

One capability's content, section-selectable via `include` to control size. Default include is [summary, definition] (~1-2k tokens). Approximate extra cost per section: maturity ~2.5k tokens, activities ~3k (filter with `persona`), kpis ~1k, headline_groups/inputs_outputs <1k; requesting ALL sections is roughly 7k tokens — prefer the finops://framework/capabilities/{slug} resource for the full document.

Input parameters:

- `capability` (string, required): Capability slug, e.g. 'allocation'
- `include` (array): Sections to return (default [summary, definition])
- `persona` (string): With include:['activities']: return only this persona's activities

Output parameters:

- `domain` (string)
- `license` (string)
- `sections` (object)
- `slug` (string)
- `source_url` (string)
- `title` (string)
- `uri` (string)

### `get_maturity_assessment` (~85 tokens)

Get official maturity assessment

The official FinOps Framework maturity assessment prose for a capability, verbatim, at one level (crawl|walk|run) or all three. This is the Foundation's published assessment text, not a parsed breakdown.

Input parameters:

- `capability` (string, required): Capability slug, e.g. 'allocation'
- `level` (string): One level; omit for all three official levels

Output parameters:

- `capability` (string)
- `levels` (array)

### `get_kpis` (~190 tokens)

Get KPIs (full records)

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. Look up one KPI with `slug`, or filter by capability and/or featured_only — filters combine (AND), so a `slug` that doesn't match the `capability` filter returns zero records. Without filters, pages through the whole 88-entry library.

Input parameters:

- `capability` (string): Only KPIs featured on or officially related to this capability
- `cursor` (string)
- `featured_only` (boolean): With `capability`: only KPIs featured on that capability's own page; alone: only KPIs featured on some page
- `limit` (integer)
- `slug` (string): Exact KPI slug for a single-record lookup, e.g. 'allocation-accuracy-index-aai'

Output parameters:

- `kpis` (array)
- `nextCursor` (string)
- `total` (number)

### `assess_maturity_path` (~113 tokens)

Maturity gap between two levels

For one capability, the official maturity assessment text at each level between current and target — evidence to look for when maturing. To get one level's assessment text on its own (or all three at once), use get_maturity_assessment instead.

Input parameters:

- `capability` (string, required): Capability slug, e.g. 'allocation'
- `current_level` (string, required): Starting maturity level, exclusive — the gap begins above this
- `target_level` (string, required): Ending maturity level, inclusive — must be above current_level

Output parameters:

- `capability` (string)
- `gap` (array)

### `map_personas` (~134 tokens)

Persona ↔ capability mapping

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'). With `capability`: every persona active in it, with activities. With neither: the full persona index (slugs, categories) — use it to discover persona slugs. Passing both is an error — pick one direction per call. Allied personas are mapped at group level by the framework; responses say so explicitly.

Input parameters:

- `capability` (string): Capability slug, e.g. 'allocation'
- `persona` (string): Persona slug, e.g. 'finance'

Output parameters:

- `entries` (array)
- `license` (string)
- `mode` (string)
- `note` (string)
- `personas` (array)

### `get_entity` (~107 tokens)

Get full text of a small framework entity

Full rendered markdown for entity types that have no dedicated tool. Required param: `entity_type` (principles | phases | domains | technology-categories | scopes | persona). Collections return whole (they are small); entity_type 'persona' also needs `slug`. For capabilities use get_capability; for KPIs get_kpis; for maturity levels get_maturity_model.

Input parameters:

- `entity_type` (string, required)
- `slug` (string): Required for entity_type 'persona'; ignored otherwise

Output parameters:

- `entity_type` (string)
- `markdown` (string)
- `slug` (string)
- `uri` (string)

### `get_maturity_model` (~65 tokens)

Get the maturity model

The official FinOps maturity model: Crawl/Walk/Run with each level's characteristics and the community's sample goals/KPIs (e.g. allocation coverage targets per level). Capability-agnostic — for one capability's per-level assessment use get_maturity_assessment.

Output parameters:

- `official_levels` (array)
- `unofficial_extension` (object)

### `get_changelog` (~92 tokens)

Data changelog

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; the same data is at finops://framework/meta/changelog). Reflects crawl-to-crawl differences in finops.org content, not a Foundation-published changelog.

Input parameters:

- `limit` (integer)

Output parameters:

- `current_version` (string)
- `entries` (array)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/aaronmsoto-finops-framework-mcp/finops-framework-mcp#diagnostics

## Score history

- 2026-11-04: 82
- 2026-11-03: 82
- 2026-11-02: 82
- 2026-11-01: 82
- 2026-10-31: 82
- 2026-10-30: 82
- 2026-10-29: 82
- 2026-10-28: 82
- 2026-10-27: 82
- 2026-10-26: 82
- 2026-10-25: 82
- 2026-10-24: 82
- 2026-10-23: 82
- 2026-10-22: 82
- 2026-10-21: 82
- 2026-10-20: 67

## Common questions

### What is the io.github.aaronmsoto/finops-framework-mcp server?

io.github.aaronmsoto/finops-framework-mcp is listed in the public MCP registry as io.github.aaronmsoto/finops-framework-mcp. Unofficial MCP server for the FinOps Framework: phases, domains, capabilities, maturity, KPIs. This page covers its npm package (finops-framework-mcp).

### Is the io.github.aaronmsoto/finops-framework-mcp server safe to use?

io.github.aaronmsoto/finops-framework-mcp scores 82 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 4 November 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the io.github.aaronmsoto/finops-framework-mcp server expose?

io.github.aaronmsoto/finops-framework-mcp exposes 11 tools: get_framework_info, search_framework, list_capabilities, get_capability, get_maturity_assessment, and 6 more. Their descriptions and schemas cost roughly 1,322 tokens of context every time the server is loaded.

### Is the io.github.aaronmsoto/finops-framework-mcp server still maintained?

io.github.aaronmsoto/finops-framework-mcp is still listed as active in the MCP registry. We last reached this channel on 4 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the io.github.aaronmsoto/finops-framework-mcp server under?

io.github.aaronmsoto/finops-framework-mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- npm package: https://www.npmjs.com/package/finops-framework-mcp
- Socket report: https://socket.dev/npm/package/finops-framework-mcp
- Repository: https://github.com/aaronmsoto/finops-framework-mcp
- Website: https://aaronmsoto.github.io/finops-framework-mcp/
- Changelog RSS feed: https://verifymcp.io/servers/aaronmsoto-finops-framework-mcp/finops-framework-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/aaronmsoto-finops-framework-mcp/finops-framework-mcp.json
- HTML version of this page: https://verifymcp.io/servers/aaronmsoto-finops-framework-mcp/finops-framework-mcp