Tokenomics Overview MCP
Read-only guidance on AI token costs: Big-T notation, cache metrics and cost levers
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"tokenomics-overview-mcp": {
"command": "npx",
"args": [
"-y",
"tokenomics-overview-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tokenomics-overview-mcp": {
"command": "npx",
"args": [
"-y",
"tokenomics-overview-mcp"
]
}
}
}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

Claude Code Ultimate Guide
MCP serverMCP 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

Agent Yurt
MCP serverBack up agent memory, files and dashboards, then recover from a reviewed snapshot
Not checked yet- Remote
- Free
- Knowledge and memory

Proofline
MCP serverProduction-aware review of changes against your AWS or Google Cloud setup, via MCP
- Remote
- Freemium
- Developer tools

signafAIde
MCP serverLocal MCP server to set up, verify and check coverage of signed agent action records
Runs locally- 5 tools
- Freemium
- Security

Toolkien
MCP serverOne 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

filex
MCP serverSelf-hosted file manager in one Go binary with a built-in MCP server for agents
Not checked yet- Remote
- Open source
- Files and documents