
TokenOracle
**Editor's Note: This service has been shut down and the repository archived. The listing remains for historical reference only.** Token Oracle was a hosted MCP server that estimated LLM API costs before execution using a deterministic pricing algorithm across 100+ models from Anthropic, OpenAI, Google, Groq, and others. It exposed tools like estimate_cost, compare_models, and budget_check to help agents route tasks to cheaper models while staying within monthly budgets. The service offered a free tier with 1,000 calls per day and could be accessed via streamable HTTP or through an npm bridge package that proxied stdio clients to the remote endpoint. Designed for agent swarms that needed programmatic cost control without calling an LLM for budget decisions.
- tools
- 9
- auth
- Secret needed
- transport
- STDIO, HTTP
- env vars
- 3
- last updated
- Mar 9, 2026
Tools
9 toolsPublic tool metadata for what this MCP can expose to an agent.
estimate_costEstimates the USD cost of a single LLM API call before execution.
Estimates the USD cost of a single LLM API call before execution.
No parameter schema in public metadata yet.
estimate_cost_batchPrices up to 100 LLM tasks in a single call.
Prices up to 100 LLM tasks in a single call.
No parameter schema in public metadata yet.
compare_modelsRanks LLM pricing across all supported providers for a given task.
Ranks LLM pricing across all supported providers for a given task.
No parameter schema in public metadata yet.
budget_checkChecks whether a planned task fits within a monthly budget.
Checks whether a planned task fits within a monthly budget.
No parameter schema in public metadata yet.
find_cheapest_for_budgetInverse 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.
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.
No parameter schema in public metadata yet.
get_budget_status
No parameter schema in public metadata yet.
list_request_activity
No parameter schema in public metadata yet.
get_usage_summary
No parameter schema in public metadata yet.
get_usage_leaderboard
No parameter schema in public metadata yet.
Sponsors
Configuration
TOKEN_ORACLE_API_KEY*secretHosted API key for TokenOracle
TOKEN_ORACLE_BASE_URLdefault: https://mcp.guffeyholdings.com/TokenOracleOptional override for the hosted TokenOracle MCP endpoint
TOKEN_ORACLE_SUBJECTOptional end-user subject forwarded to the hosted service
Readme
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:
Details
- Repository
- github.com/victoryintech/tokenoracle-mcp
- Category
- AI & LLM Tools
- Package
token-oracle-mcp- Transport
- STDIO, HTTP
- Auth
- Required
- Registry
- MCP registry, active