finops-focus-mcp

An unofficial MCP server that gives AI agents a structured, version-aware interface to the FOCUS (FinOps Open Cost & Usage Specification) published by the FinOps Foundation / FinOps-Open-Cost-and-Usage-Spec project. FOCUS columns are added, renamed, deprecated, and re-semanticized across releases — this server pins every answer to a spec version (1.0 or 1.2, default 1.2) instead of blending them.

This package is a publish shim: it ships the built focus MCP server from the finops-framework-mcp monorepo as its own installable npm package, decoupled from the companion finops-framework-mcp package (the companion unofficial server for the FinOps Framework published at finops.org/framework). See that repository for source, tests, and contribution docs.

Quickstart

npx -y finops-focus-mcp

(-y skips npx's first-run install prompt, which can hang non-interactive MCP clients; pin a version with npx -y finops-focus-mcp@latest or @0.1.)

Claude Code:

claude mcp add focus-spec -- npx -y finops-focus-mcp

Claude Desktop (claude_desktop_config.json):

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

Generic stdio client:

{
  "command": "npx",
  "args": ["-y", "finops-focus-mcp"]
}

Tool surface

list_versions, get_column, list_columns, search_focus, get_attribute, get_requirements, compare_versions, get_kpi_mapping, calculate_kpi. Version-parameterized tools take an optional version parameter (defaults to 1.2) and echo spec_version in their structured content; list_versions and compare_versions are version-independent.

get_kpi_mapping and calculate_kpi are derived, unofficial extensions — no official FOCUS-to-FinOps-KPI mapping exists upstream. Every record from these two tools is marked official: false with an in-text UNOFFICIAL banner; see NOTICE.md.

The full prompts/resources/tools hierarchy of this server (and its sibling finops-framework-mcp) — names, args, URIs, param defaults/limits — is generated from live MCP output in the monorepo at docs/mcp-surface.md.

Data & licensing

FOCUS spec text, attributes, glossary, and the official sample dataset are © FinOps Foundation / FOCUS project contributors, licensed CC BY 4.0. See NOTICE.md for full attribution and the no-endorsement note. Code in this package is MIT-licensed (LICENSE).

Version

npx -y finops-focus-mcp --version