How do I install TokenOracle?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does TokenOracle need an API key?

The publisher lists these environment variables: TOKEN_ORACLE_API_KEY, TOKEN_ORACLE_BASE_URL, TOKEN_ORACLE_SUBJECT.

What transport does TokenOracle use?

TokenOracle is reached over HTTP.

When was TokenOracle last checked?

Last checked 2026-11-08. Hosted MCP server for LLM cost estimation, model comparison, and budget-aware routing.

TokenOracle MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://mcp.guffeyholdings.com/TokenOracle

Credentials from the publisher

TOKEN_ORACLE_API_KEY — Hosted API key for TokenOracle
TOKEN_ORACLE_BASE_URL — Optional override for the hosted TokenOracle MCP endpoint
TOKEN_ORACLE_SUBJECT — Optional end-user subject forwarded to the hosted service

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http com.guffeyholdings-token-oracle https://mcp.guffeyholdings.com/TokenOracle

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.guffeyholdings-token-oracle": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://mcp.guffeyholdings.com/TokenOracle"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

THIS REPO IS ARCHIVED AND THE SERVICE HAS BEEN SHUTDOWN

TokenOracle MCP

Token Oracle is a Model Context Protocol (MCP) server that estimates, compares, and controls LLM API costs before agents spend tokens. It exposes nine tools, four read-only Resources, and a cost_analysis_workflow Prompt template. It uses a proprietary pricing algorithm without a backing LLM to ensure deterministic budget workflows.

Designed to work with agent swarms backing one or zero employee companies, Token Oracle acts as a tiny CFO within your OpenClaw swarm keeping spend down and making suggestions to improve promptings.

Save them tokens, call Token Oracle today!

MCP tools exposed:

estimate_cost — Estimates the USD cost of a single LLM API call before execution. Input: task_description, prompt_text, task_type, or explicit token_count. Output: cost_usd, recommended_model, confidence, will_fit_context, pricing_updated. Annotations: readOnlyHint:true, idempotentHint:true, openWorldHint:false.
estimate_cost_batch — Prices up to 100 LLM tasks in a single call. Returns per-task breakdown, total_cost_usd, and cheapest_model_for_all. Use before starting any multi-step pipeline.
compare_models — Ranks LLM pricing across all supported providers for a given task. Returns models sorted by cost with speed_tier and quality_tier. Supports filtering by min_quality, max_cost_usd, and provider. Input: task_type, token_count, or prompt_text.
budget_check — Checks whether a planned task fits within a monthly budget. Returns can_proceed (boolean), remaining_budget_usd, budget_consumed_pct, and cheaper_alternatives with savings_pct. Input: monthly_budget_usd, current_spend_usd, and task description.
find_cheapest_for_budget — Inverse of budget_check. Given a budget_usd cap and task, returns the best model/quality combination within budget plus all alternatives ranked by quality then cost.

MCP Resources exposed:

token-oracle://meta — Machine-readable server capability document (version, model_count, pricing metadata)
token-oracle://models — Model IDs with metadata for discovery and validation
token-oracle://heuristics — Task-type token heuristics and keyword classifier patterns (auditable)
token-oracle://pricing/changelog — Append-only log of pricing changes; use to detect pricing updates over time

MCP Prompt exposed:

cost_analysis_workflow — Guided three-step prompt template: estimate_cost → compare_models → budget_check. Arguments: task_description, monthly_budget_usd (optional), quality_threshold (optional).

Supported providers: Anthropic, OpenAI, Google, Groq, Together AI, Mistral, DeepSeek, Cohere (100+ models).

Canonical agent workflow example: Goal: Run 500 product description generation tasks. Budget $50/mo, current spend $43.

estimate_cost_batch({ tasks: [{ task_type: "generate", token_count: { input: 200, output: 800 }, quantity: 500 }] }) → total_cost_usd: $0.60
compare_models({ token_count: { input: 200, output: 800 }, task_type: "generate", min_quality: "med", max_cost_usd: 0.002 }) → deepseek-v3 at $0.00035/task ($0.175 total) — 71% cheaper, same quality tier
budget_check({ monthly_budget_usd: 50, current_spend_usd: 43, token_count: { input: 200, output: 800 }, model: "deepseek-v3" }) → can_proceed: true, remaining: $6.825, budget_consumed_pct: 2.4% Decision: Use deepseek-v3. Save $0.425 vs gpt-4o-mini.

Pricing:

Free: 1000 API calls/day, all hosted tools via the remote endpoint, no credit card
Pro ($29/mo): Unlimited calls, track_spend tool (persisted cost ledger per API key), priority throughput, spend attribution per agent/task/session

Contact: [email protected]

Hosted endpoint

Canonical remote MCP URL: https://mcp.guffeyholdings.com/TokenOracle
Canonical MCP name: com.guffeyholdings/token-oracle

Direct remote configuration:

{
  "mcpServers": {
    "token-oracle": {
      "type": "streamable-http",
      "url": "https://mcp.guffeyholdings.com/TokenOracle",
      "headers": {
        "X-API-Key": "${TOKEN_ORACLE_API_KEY}"
      }
    }
  }
}

npm bridge package

For local clients that still expect an npm-installed stdio server, use token-oracle-mcp.

Zero-input trial flow:

Start the bridge with no API key and, when the hosted service has trial auth enabled, it will automatically fetch and store a metered trial credential on first launch.

{
  "mcpServers": {
    "token-oracle": {
      "command": "npx",
      "args": ["-y", "token-oracle-mcp"]
    }
  }
}

One-time explicit login flow:

npx -y token-oracle-mcp login

With --api-key, that validates and stores a paid hosted API key. Without --api-key, it requests and stores a hosted trial credential instead. After either flow, the MCP config does not need to inject TOKEN_ORACLE_API_KEY.

{
  "mcpServers": {
    "token-oracle": {
      "command": "npx",
      "args": ["-y", "token-oracle-mcp"]
    }
  }
}

If you prefer stateless setup, keep passing TOKEN_ORACLE_API_KEY as an environment variable instead.

Hosted trial behavior:

Trial credentials are metered and capped server-side
Once the hosted trial request limit is reached, the service returns an upgrade-required response
The hosted service reuses the same still-valid trial credential for the same claimant instead of minting a fresh token each time
Trial issuance is separately throttled and can be blocked by server-side abuse risk scoring
Later, a hosted upgrade flow can replace the stored trial credential with a paid credential without changing MCP config

Optional bridge environment variables:

TOKEN_ORACLE_API_KEY: optional hosted API key; overrides any stored credential
TOKEN_ORACLE_BASE_URL: override for the remote endpoint; defaults to https://mcp.guffeyholdings.com/TokenOracle
TOKEN_ORACLE_SUBJECT: optional end-user subject forwarded as X-Token-Oracle-Subject

Additional bridge commands:

npx -y token-oracle-mcp login: accept --api-key for paid auth, or fetch a hosted trial credential when no key is supplied
npx -y token-oracle-mcp logout: remove locally stored credentials

Capabilities

Tools:

estimate_cost
estimate_cost_batch
compare_models
budget_check
find_cheapest_for_budget
get_budget_status
list_request_activity
get_usage_summary
get_usage_leaderboard

Resources:

token-oracle://meta
token-oracle://models
token-oracle://heuristics
token-oracle://pricing/changelog

Prompts:

cost_analysis_workflow

Versioning

Hosted service version: 1.0.6
Bridge package version: 1.0.6

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install TokenOracle?

Does TokenOracle need an API key?

What transport does TokenOracle use?

When was TokenOracle last checked?

Documentation

TokenOracle MCP

Hosted endpoint

npm bridge package

Capabilities

Versioning