Skip to content
MCP server

TokenZero

MCP server for AI spend: signed receipts, token-waste audits and model cost comparison

Install
Pricing
Freemium
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
0.3.0
Listing updated
3 days ago

About TokenZero

TokenZero is a freemium MCP server for ai models and llm tooling. It can run locally on your machine or as a hosted remote server.

The MCP server is the agent-facing part of a ledger that records every model call. The gateway issues one signed, chained receipt per call that anyone can verify, and you can either point your SDK's base URL at it or push usage you already log. You bring your own provider keys and pay providers directly.

Four named tools: audit_repo_token_waste looks for wasted tokens in a repository, optimize_prompt_payload makes a prompt cache-friendly, calculate_model_arbitrage compares model costs, and workspace_metrics reads a workspace using a tz_live_ key. The site gives example prompts such as audit this repo for token waste.

It supports OpenAI, Anthropic and Google SDK styles, plus LangChain and the Vercel AI SDK. A free sandbox endpoint answers without a key.

Install

Run in a terminal

claude mcp add --transport http mcp https://api.tokenzero.sh/mcp

Add to Settings → Connectors → Add custom connector

https://api.tokenzero.sh/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://api.tokenzero.sh/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://api.tokenzero.sh/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://api.tokenzero.sh/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://api.tokenzero.sh/mcp"
    }
  }
}

Configuration

  • TOKENZERO_URLGateway base URL (default https://tokenzero.sh)
  • TOKENZERO_KEYWorkspace key (tz_live_…) for workspace_metrics; optional

Tools this server provides (4)

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

audit_repo_token_waste
Audits a repository for wasted tokens.
optimize_prompt_payload
Makes a prompt payload cache-friendly.
calculate_model_arbitrage
Compares model costs.
workspace_metrics
Reads metrics for a workspace.

What it does

Signed receipts
Issues a verifiable receipt for each call.
Waste audit
Scans a repository for token waste.
Model arbitrage
Compares model options by cost.
Cache-friendly prompts
Rewrites prompt payloads for caching.
Record-only mode
Accepts logged usage without proxying calls.

Good for

  • Audit a codebase for wasteful prompts
  • Attribute AI spend by workspace
  • Verify billing records independently
  • Compare models before switching

Pricing

Freemium

Free to start; bring your own provider keys

Prices change. Check tokenzero.sh before you buy.

TokenZero FAQ

Does it hold my provider keys?

No. You bring your own keys and pay providers directly.

Is there a free option?

The site says BYOK and free to start.

Which transports are available?

stdio via npm or streamable HTTP at api.tokenzero.sh/mcp.

Is TokenZero free?

TokenZero has a free plan, with paid plans for more usage or features.

How do I add TokenZero to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://api.tokenzero.sh/mcp

What are the best alternatives to TokenZero?

The closest alternatives to TokenZero are Agent-Native Analytics, Claude Code Ultimate Guide, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP and World Monitor.

Alternatives to TokenZero

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. 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
  3. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data