Documentation

Quick Start

  1. Create an account at tokenmeter.sh/login
  2. Copy your API key from Settings
  3. Add to your MCP client:
    {
  "mcpServers": {
    "tokenmeter": {
      "url": "https://mcp.tokenmeter.sh",
      "headers": {
        "Authorization": "Bearer tm_your_api_key"
      }
    }
  }
}
  4. Start using AI. Token Meter tracks your spend automatically.

Alternative: Local Client

If your MCP client doesn't support remote URLs, use the local client:

TOKENMETER_API_KEY=tm_your_key npx @yawlabs/tokenmeter-mcp

Or add to Claude Code:

claude mcp add tokenmeter -e TOKENMETER_API_KEY=tm_your_key -- npx @yawlabs/tokenmeter-mcp

Gateway Setup (Pro+)

Route your LLM requests through Token Meter for smart routing and failover. Swap your provider base URL:

# Instead of:
OPENAI_BASE_URL=https://api.openai.com/v1

# Use:
OPENAI_BASE_URL=https://gateway.tokenmeter.sh/v1
OPENAI_API_KEY=tm_your_api_key

Token Meter translates requests to the correct provider format and handles routing, failover, and retries.

MCP Tools Reference

Free Tier

get_spend_summary

Total spend for today, this week, and this month by provider.

get_session_cost

Cost of the current conversation/session.

get_model_pricing

Per-token pricing for any model.

model: optional — model ID
provider: optional — provider name
get_budget_status

Current spend against configured budgets.

get_providers

List connected providers and their status.

Pro Tier ($19/mo)

get_spend_breakdown

Detailed spend filtered by provider, model, date range.

provider: optional
days: default: 7
get_cost_trend

Daily spend over time.

days: default: 14
get_top_models

Models ranked by spend or token volume.

sortBy: 'cost' or 'tokens'
days: default: 30
get_cost_estimate

Estimate cost for X tokens on given models.

models: array of model IDs
inputTokens: number
outputTokens: default: 500
compare_models

Side-by-side cost comparison.

inputTokens: number
outputTokens: number
callsPerDay: default: 100
set_budget_alert

Create spend threshold notification.

name: string
limit: dollars
period: 'daily'|'weekly'|'monthly'

Gateway Tier ($49/mo)

get_rate_limits

Rate limit status per provider and model.

get_routing_status

Provider health: healthy, degraded, or rate-limited.

set_fallback_chain

Define provider failover order.

chain: array of {provider, model}
set_model_alias

Map friendly name to provider/model.

alias: string
provider: string
model: string

Supported Providers

Anthropic
OpenAI
Google Gemini
Groq
DeepSeek
Mistral
Cohere
Ollama
Azure OpenAI
AWS Bedrock