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

Unofficial MCP server for the FOCUS spec: columns, attributes, requirements, cross-version diffs.

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

## Components

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

## Channel facts

- Registry: `npm`
- Package: `finops-focus-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-05.

- **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 15 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 83/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 5494 tokens (~41/item across 134 items; 9 tools + 125 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**: 91/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 70% 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 9 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 11 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-focus-mcp server?

io.github.aaronmsoto/finops-focus-mcp runs locally as an npm package, launched with npx -y finops-focus-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-focus-mcp -- npx -y finops-focus-mcp
```

### Cursor

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

### VS Code

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

### Codex

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

### opencode

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

### OpenClaw

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

### Hermes

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

### Netclaw

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

### Vellum

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

### Other

```json
{
  "mcpServers": {
    "aaronmsoto-finops-focus-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "finops-focus-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 (9)

### `list_versions` (~45 tokens)

List FOCUS spec versions

Every FOCUS spec version this server serves, with its source git tag and column/attribute counts. Start here to discover valid `version` values for the other tools. No parameters.

Output parameters:

- `latest` (string)
- `versions` (array)

### `get_column` (~118 tokens)

Get one FOCUS column

Full record for one FOCUS column: description, content constraints (type, feature level, nulls, data type, value format), allowed values, normative requirements, and the version it was introduced in. Look up by the `column` parameter — a Column ID or its lowercase slug, e.g. 'BilledCost'.

Input parameters:

- `column` (string, required): Column ID or slug, e.g. 'BilledCost'
- `version` (string): FOCUS spec version (1.0|1.2); default "1.2"

Output parameters:

- `column` (object)
- `spec_version` (string)
- `uri` (string)

### `list_columns` (~136 tokens)

List FOCUS columns

All columns for one spec version, optionally filtered by feature_level (Mandatory|Conditional|Recommended) or column_type (Metric|Dimension); the extra enum value 'unknown' is a crawler parse fallback that matches no column in the shipped data. Default limit returns the full list in one call (43 in 1.0, 57 in 1.2).

Input parameters:

- `column_type` (string)
- `cursor` (string)
- `feature_level` (string)
- `limit` (integer)
- `version` (string): FOCUS spec version (1.0|1.2); default "1.2"

Output parameters:

- `columns` (array)
- `nextCursor` (string)
- `spec_version` (string)
- `total` (number)

### `search_focus` (~107 tokens)

Search FOCUS columns and attributes

Ranked keyword search over one spec version's columns and attributes. Returns slug + uri per hit — feed into get_column/get_attribute. Use when you don't already know a Column ID.

Input parameters:

- `cursor` (string)
- `entity_types` (array)
- `limit` (integer)
- `query` (string, required): Keywords, e.g. 'commitment discount'
- `version` (string): FOCUS spec version (1.0|1.2); default "1.2"

Output parameters:

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

### `get_attribute` (~131 tokens)

Get one FOCUS attribute

Full record for one cross-cutting FOCUS attribute (naming/formatting conventions like currency codes, datetime format, key-value format): description, normative requirements, exceptions. Look up by the `attribute` parameter — an attribute ID or its lowercase slug, e.g. 'datetime_format'. Attribute names can change between versions; discover current slugs via search_focus with entity_types=['attribute'].

Input parameters:

- `attribute` (string, required): Attribute ID or slug, e.g. 'datetime_format'
- `version` (string): FOCUS spec version (1.0|1.2); default "1.2"

Output parameters:

- `attribute` (object)
- `spec_version` (string)
- `uri` (string)

### `get_requirements` (~86 tokens)

Get a column's normative requirements

The normative MUST/SHOULD bullets for one column, verbatim from the spec text (plus source_url/license attribution). Use get_column for the full record.

Input parameters:

- `column` (string, required): Column ID or slug, e.g. 'BilledCost'
- `version` (string): FOCUS spec version (1.0|1.2); default "1.2"

Output parameters:

- `column` (string)
- `license` (string)
- `requirements` (array)
- `source_url` (string)
- `spec_version` (string)

### `compare_versions` (~94 tokens)

Compare FOCUS 1.0 to 1.2

The 1.0→1.2 column diff — an UNOFFICIAL derivation computed by this server from the two tagged spec releases, source-cited per entry. Without `column`: the full diff (14 added, 0 removed, 43 changed). With `column`: that one column's status and detail.

Input parameters:

- `column` (string): Column ID to narrow to, e.g. 'BilledCost'

Output parameters:

- `added_columns` (array)
- `changed_columns` (array)
- `changed_fields` (array)
- `column` (string)
- `from` (string)
- `from_source_url` (string)
- `official` (boolean)
- `removed_columns` (array)
- `source_url` (string)
- `status` (string)
- `to` (string)
- `to_source_url` (string)

### `get_kpi_mapping` (~186 tokens)

Get the KPI-to-FOCUS-column mapping

UNOFFICIAL, derived-by-this-server mapping from framework KPIs (effective savings rate, commitment discounts, forecast accuracy, unit economics, allocation, variance) to the FOCUS columns needed to compute each, with a FOCUS-terms formula translation. Not published or endorsed by the FinOps Foundation or the FOCUS project. Filter by `kpi` slug or `capability` slug (if both are passed, `kpi` wins and `capability` is ignored), or pass neither to list everything for a `version`.

Input parameters:

- `capability` (string): Framework capability slug to filter by, e.g. 'rate-optimization'
- `kpi` (string): Framework KPI slug, e.g. 'effective-savings-rate-percentage'
- `version` (string): FOCUS spec version (1.0|1.2); default "1.2"

Output parameters:

- `kpis` (array)
- `methodology` (string)
- `official` (boolean)
- `spec_version` (string)
- `total` (number)

### `calculate_kpi` (~224 tokens)

Calculate a mapped KPI over bundled sample data

UNOFFICIAL: computes one of the KPIs from get_kpi_mapping using this server's own derived FOCUS-terms formula, over a bundled sample dataset — never user-supplied data. The default version (1.2) bundles only this project's seeded synthetic sample; pass version:'1.0' to compute over the official FOCUS-Sample-Data sample. Not every mapped KPI has a registered formula: some need an external input (a forecast or budget figure) FOCUS doesn't carry, or ambiguous free-text unit matching this server won't guess at; those error with guidance instead.

Input parameters:

- `kpi` (string, required): Framework KPI slug, e.g. 'effective-savings-rate-percentage'
- `sample` (string): Which bundled sample to compute over; defaults to 'official' where the version has one (currently only 1.0), else 'synthetic'. Requesting 'official' for a version without one errors.
- `version` (string): FOCUS spec version (1.0|1.2); default "1.2"

Output parameters:

- `caveat` (string|null)
- `focus_formula` (string)
- `kpi_slug` (string)
- `kpi_title` (string)
- `kpi_uri` (string)
- `official` (boolean)
- `sample` (object)
- `spec_version` (string)
- `unit` (string)
- `value` (number)

## Diagnostics

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

## Score history

- 2026-11-05: 82
- 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-focus-mcp server?

io.github.aaronmsoto/finops-focus-mcp is listed in the public MCP registry as io.github.aaronmsoto/finops-focus-mcp. Unofficial MCP server for the FOCUS spec: columns, attributes, requirements, cross-version diffs. This page covers its npm package (finops-focus-mcp).

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

io.github.aaronmsoto/finops-focus-mcp scores 82 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 5 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-focus-mcp server expose?

io.github.aaronmsoto/finops-focus-mcp exposes 9 tools: list_versions, get_column, list_columns, search_focus, get_attribute, and 4 more. Their descriptions and schemas cost roughly 1,127 tokens of context every time the server is loaded.

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

io.github.aaronmsoto/finops-focus-mcp is still listed as active in the MCP registry. We last reached this channel on 5 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-focus-mcp server under?

io.github.aaronmsoto/finops-focus-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-focus-mcp
- Socket report: https://socket.dev/npm/package/finops-focus-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-focus-mcp/finops-focus-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/aaronmsoto-finops-focus-mcp/finops-focus-mcp.json
- HTML version of this page: https://verifymcp.io/servers/aaronmsoto-finops-focus-mcp/finops-focus-mcp