TokenOracle MCP Server

Hosted MCP server for LLM cost estimation, model comparison, and budget-aware routing.

Remote serverstreamable-http

What is the TokenOracle MCP Server?

Hosted MCP server for LLM cost estimation, model comparison, and budget-aware routing.

What the server does

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.

  • estimate_cost
  • estimate_cost_batch
  • compare_models
  • find_cheapest_for_budget
  • get_budget_status
  • list_request_activity

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
estimate_costEstimates 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_updat
estimate_cost_batchPrices 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_modelsRanks 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_co
budget_checkChecks 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_us
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.
token-oracle//meta — Machine-readable server capability document (version, model_count, pricing metadata)
cost_analysis_workflowGuided three-step prompt template: estimate_cost → compare_models → budget_check. Arguments: task_description, monthly_budget_usd (optional), quality_threshold (optional).
list_request_activityget_usage_summary

How to install the TokenOracle MCP Server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
TOKEN_ORACLE_API_KEYCredential the server authenticates with.Yes
TOKEN_ORACLE_BASE_URLCredential the server authenticates with.Yes

Example prompts to try

  • “Use TokenOracle to estimate cost.”
  • “Use TokenOracle to estimate cost batch.”
  • “Use TokenOracle to compare models.”

Frequently asked questions

Hosted MCP server for LLM cost estimation, model comparison, and budget-aware routing. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.