# Tokenomics Overview MCP

> Tokenomics Overview MCP is an open-source MCP server for ai models and llm tooling. Read-only guidance on AI token costs: Big-T notation, cache metrics and cost levers. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://aaronmsoto.github.io/finops-framework-mcp/
- **Repository:** https://github.com/aaronmsoto/finops-framework-mcp
- **MCP Registry name:** io.github.aaronmsoto/tokenomics-overview-mcp
- **Categories:** AI models and LLM tooling, cloud and infrastructure
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `get_tokenomics_info`: Returns an overview of the tokenomics data set.

## 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

- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Agent Yurt](https://ai-powered.com/mcp/agent-yurt): Agent Yurt is a free MCP server for knowledge and memory.
- [Proofline](https://ai-powered.com/mcp/proofline): Proofline is a freemium MCP server for developer tools.
- [signafAIde](https://ai-powered.com/mcp/signafaide): signafAIde is a freemium MCP server for security.
- [Toolkien](https://ai-powered.com/mcp/toolkien): Toolkien is an open-source MCP server for ai models and llm tooling.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [Lugh](https://ai-powered.com/mcp/lugh): Lugh is an open-source MCP server for ai models and llm tooling.
- [HypePaper](https://ai-powered.com/mcp/hypepaper): HypePaper is a freemium MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/tokenomics-overview-mcp
