Skip to content
MCP server

Tokenomics Overview MCP

Read-only guidance on AI token costs: Big-T notation, cache metrics and cost levers

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.2.1
Listing updated
2 days ago

About Tokenomics Overview MCP

Tokenomics Overview MCP is an open-source MCP server for ai models and llm tooling. It runs locally on your machine and is started by your AI client.

This server serves published AI cost guidance from the Tokenomics Foundation so an assistant quotes it rather than improvising. It is part of a trio of unofficial servers by the same author, alongside ones for the FinOps Framework and the FOCUS billing specification, and it is labelled unofficial.

It works offline once installed, with no telemetry, and cites a source URL and licence on every response. Its data covers 14 source documents, each shown with its publication status because most Foundation guidance is draft or release candidate, plus reference metrics such as Cache Hit Rate and Cache Cost Efficiency, a Seven-Layer Stack from energy to demand, Big-T complexity classes and consumption levers like caching, right-sizing and model routing. Cards map to FOCUS 1.5 AI-cost capabilities.

A curated crosswalk to the other servers is unofficial and appears only with FINOPS_MCP_EXPERIMENTAL=1. Needs Node 22 or newer; code is MIT and content CC BY 4.0.

Install

Run in a terminal

claude mcp add tokenomics-overview-mcp -- npx -y tokenomics-overview-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "tokenomics-overview-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tokenomics-overview-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tokenomics-overview-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tokenomics-overview-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "tokenomics-overview-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "tokenomics-overview-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "tokenomics-overview-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tokenomics-overview-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "tokenomics-overview-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tokenomics-overview-mcp"
      ]
    }
  }
}

Configuration

  • TOKENOMICS_MCP_DATAOverride the bundled data artifact directory (defaults to the packaged data/tokenomics).

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

get_tokenomics_info
Returns an overview of the tokenomics data set.

What it does

Sourced guidance
Every answer carries source URL and licence.
Publication status
States whether a source is draft or release candidate.
Cache metrics
Definitions such as Cache Hit Rate and Cache Cost Efficiency.
Consumption levers
Caching, right-sizing, model routing and budgets.
FOCUS 1.5 AI cards
Capabilities for AI cost reporting.
Offline and read-only
No network access at runtime.

Good for

  • Check whether prompt caching is paying off
  • Explain Big-T complexity classes to a finance team
  • Find levers to reduce LLM spend
  • Map AI cost reporting to FOCUS capabilities

Pricing

Open source

MIT code, CC BY 4.0 content

Prices change. Check aaronmsoto.github.io before you buy.

Tokenomics Overview MCP FAQ

Is it official?

No. It is an independent, unofficial interface and labels derived answers as unofficial.

Does it need network access?

No, it runs offline once installed.

What Node version is required?

Node 22 or newer.

What licences apply?

MIT for code, CC BY 4.0 for content.

Is Tokenomics Overview MCP free?

Yes. Tokenomics Overview MCP is open source, so you can use and self-host it for free.

How do I add Tokenomics Overview MCP to Claude Code?

Run this command in your terminal: claude mcp add tokenomics-overview-mcp -- npx -y tokenomics-overview-mcp

What are the best alternatives to Tokenomics Overview MCP?

The closest alternatives to Tokenomics Overview MCP are Claude Code Ultimate Guide, Agent Yurt, Proofline, signafAIde and Toolkien.

Alternatives to Tokenomics Overview MCP

  1. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  2. Agent Yurt

    MCP server

    Back up agent memory, files and dashboards, then recover from a reviewed snapshot

    Not checked yet
    • Remote
    • Free
    • Knowledge and memory
  3. Proofline

    MCP server

    Production-aware review of changes against your AWS or Google Cloud setup, via MCP

    • Remote
    • Freemium
    • Developer tools
  4. signafAIde

    MCP server

    Local MCP server to set up, verify and check coverage of signed agent action records

    Runs locally
    • 5 tools
    • Freemium
    • Security
  5. Toolkien

    MCP server

    One MCP gateway for all your MCP servers, with code mode, permissions and audit

    Not checked yet
    • 3 tools
    • Remote
    • Open source
    • AI models and LLM tooling
  6. filex

    MCP server

    Self-hosted file manager in one Go binary with a built-in MCP server for agents

    Not checked yet
    • Remote
    • Open source
    • Files and documents