{"serverId":"mcp-registry/io.github.skakumanu/llm-pricing-mcp-server","tools":[{"name":"analyze_session_usage","fixed":{"name":"analyze_session_usage","description":"Analyze one specific session's actual recorded LLM usage (tagged via record_usage's session_id) on demand: total input/output tokens, total actual cost, and a per-model breakdown if more than one model was used. Also runs the session's own observed token pattern through the same routing engine behind recommend_model / POST /router/recommend to produce a grounded recommendation — or confirm the current choice is already optimal — with the estimated dollar savings or increase versus this session's","inputSchema":{"type":"object","required":["session_id"],"properties":{"org_id":{"type":"string","description":"Optional organisation ID filter — scopes the lookup to usage events recorded under that org_id. Defaults to, and must match, the org of the service key on the MCP connection"},"session_id":{"type":"string","description":"The session_id previously used when calling record_usage"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":262,"tokensAfter":262},{"name":"check_price_drift","fixed":{"name":"check_price_drift","description":"Audit this server's own pricing data against an external reference registry. Prices here are hand-maintained and go stale silently; a price that disagrees with the registry by more than the threshold is automatically withheld from serving the moment it's detected, not just when this tool runs. This reports what's currently withheld and why. The price value itself is never overwritten by the registry. Use when the user asks whether the pricing data is accurate or up to date, or wants to audit a s","inputSchema":{"type":"object","required":[],"properties":{"limit":{"type":"integer","default":50,"maximum":200,"minimum":1,"description":"Maximum findings to return (default: 50, max: 200)"},"provider":{"type":"string","description":"Limit the audit to one provider (partial, case-insensitive)"},"threshold_pct":{"type":"number","default":5,"minimum":0,"description":"Minimum % difference to report (default: 5)"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":268,"tokensAfter":268},{"name":"compare_costs","fixed":{"name":"compare_costs","description":"Compare costs for multiple LLM models. Every named model is priced; pass client (e.g. 'claude_code') to also flag each model runnable_in_client (it never filters here). Recognised clients: claude_code, claude_desktop, cursor, github_copilot, windsurf, cline, continue, zed, jetbrains_ai, gemini_cli, codex_cli, aider, amazon_q, chatgpt_desktop.","inputSchema":{"type":"object","required":["model_names","input_tokens","output_tokens"],"properties":{"client":{"type":"string","description":"Your MCP client / coding tool, so only models it can run are considered. Recognised: claude_code, claude_desktop, cursor, github_copilot, windsurf, cline, continue, zed, jetbrains_ai, gemini_cli, codex_cli, aider, amazon_q, chatgpt_desktop. Case- and separator-insensitive ('Claude Code' = claude_code). Order: explicit client > legacy ide_context > client inferred from the MCP handshake (hosted server, best effort) > none. Unknown names return an unfiltered result plus a note."},"country":{"type":"string","maxLength":2,"minLength":2,"description":"Optional ISO-3166 alpha-2 country whose currency to use (e.g. DE -> EUR, IN -> INR). A country whose currency is unsupported yields USD with fallback_to_usd=true."},"currency":{"enum":["USD","EUR","GBP","INR","JPY","CAD","AUD","BRL","CNY","SGD","CHF","KRW","MXN"],"type":"string","description":"Optional ISO-4217 code to convert prices into, alongside the canonical USD figures. Beats country. Unsupported codes return success=false listing the supported set."},"model_names":{"type":"array","items":{"type":"string"},"maxItems":50,"description":"List of model names to compare (at most 50)"},"input_tokens":{"type":"integer","minimum":0,"description":"Number of input tokens"},"output_tokens":{"type":"integer","minimum":0,"description":"Number of output tokens"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":514,"tokensAfter":514},{"name":"delete_budget_alert","fixed":{"name":"delete_budget_alert","description":"Delete one of your org's registered budget-spend alerts by its ID. Requires your service API key on the MCP connection (x-api-key or Authorization: Bearer); another org's alert ID reads as not found.","inputSchema":{"type":"object","required":["alert_id"],"properties":{"alert_id":{"type":"integer","description":"The ID of the alert to delete (from list_budget_alerts or register_budget_alert)"}}},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":124,"tokensAfter":124},{"name":"delete_conversation","fixed":{"name":"delete_conversation","description":"Delete a specific chat conversation by its ID. Use when the user asks to delete, clear, or remove a past conversation. Use list_conversations first to find the conversation ID. Operator only: needs the server operator's key (MCP_API_KEY) on the MCP connection (x-api-key or Authorization: Bearer); any other caller, including the chat agent and the local STDIO server, gets error_code operator_key_required.","inputSchema":{"type":"object","required":["conversation_id"],"properties":{"conversation_id":{"type":"string","description":"The ID of the conversation to delete"}}},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":173,"tokensAfter":173},{"name":"delete_price_alert","fixed":{"name":"delete_price_alert","description":"Delete a registered price-change alert by its ID. Operator only: needs the server operator's key (MCP_API_KEY) on the MCP connection (x-api-key or Authorization: Bearer); any other caller, including the chat agent and the local STDIO server, gets error_code operator_key_required. To view or delete an alert you registered yourself, use manage_price_alert with the alert_token from registration.","inputSchema":{"type":"object","required":["alert_id"],"properties":{"alert_id":{"type":"integer","description":"The ID of the alert to delete (from list_price_alerts or register_price_alert)"}}},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: true, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":177,"tokensAfter":177},{"name":"estimate_cost","fixed":{"name":"estimate_cost","description":"Estimate the cost of using a specific LLM model","inputSchema":{"type":"object","required":["model_name","input_tokens","output_tokens"],"properties":{"country":{"type":"string","maxLength":2,"minLength":2,"description":"Optional ISO-3166 alpha-2 country whose currency to use (e.g. DE -> EUR, IN -> INR). A country whose currency is unsupported yields USD with fallback_to_usd=true."},"currency":{"enum":["USD","EUR","GBP","INR","JPY","CAD","AUD","BRL","CNY","SGD","CHF","KRW","MXN"],"type":"string","description":"Optional ISO-4217 code to convert prices into, alongside the canonical USD figures. Beats country. Unsupported codes return success=false listing the supported set."},"model_name":{"type":"string","description":"Name of the LLM model (e.g., 'gpt-4', 'claude-3-opus')"},"input_tokens":{"type":"integer","minimum":0,"description":"Number of input tokens"},"output_tokens":{"type":"integer","minimum":0,"description":"Number of output tokens"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":278,"tokensAfter":278},{"name":"get_all_pricing","fixed":{"name":"get_all_pricing","description":"Get current pricing for all LLM models from all providers","inputSchema":{"type":"object","required":[],"properties":{"country":{"type":"string","maxLength":2,"minLength":2,"description":"Optional ISO-3166 alpha-2 country whose currency to use (e.g. DE -> EUR, IN -> INR). A country whose currency is unsupported yields USD with fallback_to_usd=true."},"currency":{"enum":["USD","EUR","GBP","INR","JPY","CAD","AUD","BRL","CNY","SGD","CHF","KRW","MXN"],"type":"string","description":"Optional ISO-4217 code to convert prices into, alongside the canonical USD figures. Beats country. Unsupported codes return success=false listing the supported set."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":193,"tokensAfter":193},{"name":"get_cache_stats","fixed":{"name":"get_cache_stats","description":"Report process-lifetime hit/miss counts, total lookups, and hit rate for the ~5-minute recommendation cache, separately for the recommend_model tool and POST /router/recommend (never combined). Server-operations introspection for confirming the cache is reducing recomputation in production, not a pricing question. Counts reset on process restart; reading them never changes them.","inputSchema":{"type":"object","required":[],"properties":{}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":135,"tokensAfter":135},{"name":"get_data_quality","fixed":{"name":"get_data_quality","description":"Report an aggregate accuracy summary for the pricing catalogue: what percentage of models have a confirmed, fresh price, how many are currently withheld due to price drift, how many are newly discovered and not yet priced, and how many confirmed prices are over 90 days old. A single trust signal, distinct from check_price_drift which lists individual disputes. Use when the user asks how accurate or trustworthy the pricing data is, overall.","inputSchema":{"type":"object","required":[],"properties":{}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":153,"tokensAfter":153},{"name":"get_ide_pricing","fixed":{"name":"get_ide_pricing","description":"Get subscription pricing for AI coding IDE tools: GitHub Copilot, Cursor, Windsurf, Claude.ai, JetBrains AI, Amazon Q Developer, and Tabnine. Returns monthly subscription cost, inline completion support, context window, and per-tool strengths. Use this when the user asks to compare IDE AI tools, subscription-based coding assistants, or wants to know which IDE AI fits their budget.","inputSchema":{"type":"object","required":[],"properties":{"provider":{"type":"string","description":"Filter by provider name (partial match, case-insensitive). Examples: 'GitHub Copilot', 'Cursor', 'Windsurf', 'JetBrains', 'Amazon Q', 'Tabnine'"},"inline_only":{"type":"boolean","default":false,"description":"If true, only return tools that support real-time inline code completion"},"max_monthly":{"type":"number","minimum":0,"description":"Only return plans at or below this monthly USD price (e.g. 20 for $20/mo)"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":264,"tokensAfter":264},{"name":"get_performance_metrics","fixed":{"name":"get_performance_metrics","description":"Get performance metrics (throughput, latency, context window) for models","inputSchema":{"type":"object","required":[],"properties":{"provider":{"type":"string","description":"Optional provider filter (e.g., 'openai', 'anthropic')"},"include_cost":{"type":"boolean","default":true,"description":"Include cost metrics in response (default: true)"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":111,"tokensAfter":111},{"name":"get_pricing_export_url","fixed":{"name":"get_pricing_export_url","description":"Generate a download URL for the pricing history export. Returns a URL the user can open in their browser to download snapshot history as CSV (for spreadsheets) or JSON (for code). Use this when the user asks to export, download, or save pricing data.","inputSchema":{"type":"object","required":[],"properties":{"days":{"type":"integer","default":30,"maximum":365,"minimum":1,"description":"Look-back window in days (default: 30, max: 365)"},"limit":{"type":"integer","default":10000,"maximum":100000,"minimum":1,"description":"Max rows to export (default: 10000, max: 100000)"},"format":{"enum":["csv","json"],"type":"string","default":"csv","description":"Output format: 'csv' (default) or 'json'"},"provider":{"type":"string","description":"Filter by provider (optional)"},"model_name":{"type":"string","description":"Filter by model name (optional)"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":252,"tokensAfter":252},{"name":"get_pricing_history","fixed":{"name":"get_pricing_history","description":"Query historical pricing snapshots recorded over time. Use this to look up past prices for a model or provider, or to see how prices have changed over a given number of days.","inputSchema":{"type":"object","required":[],"properties":{"days":{"type":"integer","default":30,"maximum":365,"minimum":1,"description":"Look-back window in days (default: 30, max: 365)"},"limit":{"type":"integer","default":50,"maximum":500,"minimum":1,"description":"Maximum number of snapshot rows to return (default: 50, max: 500)"},"provider":{"type":"string","description":"Filter by provider (e.g. 'openai'). Omit for all providers."},"model_name":{"type":"string","description":"Filter by model name (e.g. 'gpt-4o'). Omit for all models."}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":215,"tokensAfter":215},{"name":"get_pricing_trends","fixed":{"name":"get_pricing_trends","description":"Find models whose prices changed the most over a given period. Returns models sorted by absolute percentage price change with a direction label ('increased', 'decreased', or 'unchanged'). Use this to answer questions like 'which models got cheaper this month?' or 'which providers raised prices recently?'","inputSchema":{"type":"object","required":[],"properties":{"days":{"type":"integer","default":30,"maximum":365,"minimum":1,"description":"Look-back window in days (default: 30, max: 365)"},"limit":{"type":"integer","default":20,"maximum":100,"minimum":1,"description":"Maximum models to return (default: 20, max: 100)"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":187,"tokensAfter":187},{"name":"get_telemetry","fixed":{"name":"get_telemetry","description":"Get MCP server telemetry and usage statistics including tool usage, response times, and error rates","inputSchema":{"type":"object","required":[],"properties":{"limit":{"type":"integer","default":10,"maximum":50,"minimum":1,"description":"Maximum items per category (default: 10, max: 50)"},"include_details":{"type":"boolean","default":true,"description":"Include detailed statistics (default: true)"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":124,"tokensAfter":124},{"name":"get_usage_summary","fixed":{"name":"get_usage_summary","description":"Get a summary of actual recorded LLM spend: total cost, request count, and breakdowns by model and provider, from usage events previously logged via record_usage. Use when the user asks what they've actually spent, as opposed to a hypothetical cost estimate. Requires your service API key on the MCP connection (x-api-key or Authorization: Bearer); org_id defaults to, and must match, that key's org.","inputSchema":{"type":"object","required":[],"properties":{"days":{"type":"integer","default":30,"maximum":365,"minimum":1,"description":"Look-back window in days (default: 30, max: 365)"},"org_id":{"type":"string","description":"Optional organisation ID filter. Defaults to, and must match, the org of the service key on the MCP connection"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":220,"tokensAfter":220},{"name":"get_use_cases","fixed":{"name":"get_use_cases","description":"Get recommended use cases and strengths for LLM models","inputSchema":{"type":"object","required":[],"properties":{"country":{"type":"string","maxLength":2,"minLength":2,"description":"Optional ISO-3166 alpha-2 country whose currency to use (e.g. DE -> EUR, IN -> INR). A country whose currency is unsupported yields USD with fallback_to_usd=true."},"currency":{"enum":["USD","EUR","GBP","INR","JPY","CAD","AUD","BRL","CNY","SGD","CHF","KRW","MXN"],"type":"string","description":"Optional ISO-4217 code to convert prices into, alongside the canonical USD figures. Beats country. Unsupported codes return success=false listing the supported set."},"provider":{"type":"string","description":"Optional provider filter"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":211,"tokensAfter":211},{"name":"import_session_usage","fixed":{"name":"import_session_usage","description":"Bulk-import a completed session's usage in a single call — the retroactive counterpart to record_usage, for when a session wasn't instrumented live. Use when a calling agent (e.g. VS Code Copilot Chat) already has a session's turn-by-turn history in its own local store and wants this server to report on it exactly as if it had been tracked live. Accepts a list of entries under one shared session_id; each entry resolves its input and output tokens independently, either from exact counts when know","inputSchema":{"type":"object","required":["session_id","entries"],"properties":{"org_id":{"type":"string","description":"Optional organisation ID to attribute this usage to. Defaults to, and must match, the org of the service key on the MCP connection"},"entries":{"type":"array","items":{"type":"object","required":["model_name"],"properties":{"input_text":{"type":"string","description":"Raw input/prompt text — used to estimate input_tokens via this server's token counter when input_tokens isn't known"},"model_name":{"type":"string","description":"Name of the LLM model used for this entry"},"request_id":{"type":"string","description":"Optional idempotency key. When omitted, a deterministic one is derived from session_id/model_name/occurred_at/token-or-text source so resubmitting the same entry is safely a no-op"},"occurred_at":{"type":"number","description":"Unix timestamp when this call happened (default: now)"},"output_text":{"type":"string","description":"Raw output/response text — used to estimate output_tokens via this server's token counter when output_tokens isn't known"},"input_tokens":{"type":"integer","minimum":0,"description":"Exact input token count, if known"},"output_tokens":{"type":"integer","minimum":0,"description":"Exact output token count, if known"}}},"maxItems":500,"minItems":1,"description":"Usage entries to import, one per turn/call in the session"},"session_id":{"type":"string","description":"Shared session ID to tag every entry in this batch with"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: false (inferred from the name).","verify":true}],"tokensBefore":569,"tokensAfter":569},{"name":"list_budget_alerts","fixed":{"name":"list_budget_alerts","description":"List your org's registered budget-spend webhook alerts with their IDs and settings. Requires your service API key on the MCP connection (x-api-key or Authorization: Bearer); only alerts for that key's org are returned.","inputSchema":{"type":"object","required":[],"properties":{}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":91,"tokensAfter":91},{"name":"list_conversations","fixed":{"name":"list_conversations","description":"List stored chat conversation sessions with their IDs, last-updated timestamp, turn count, and a preview of the most recent user message. Use this when the user asks to see their past conversations or chat history. Operator only: needs the server operator's key (MCP_API_KEY) on the MCP connection (x-api-key or Authorization: Bearer); any other caller, including the chat agent and the local STDIO server, gets error_code operator_key_required.","inputSchema":{"type":"object","required":[],"properties":{"limit":{"type":"integer","default":20,"maximum":100,"minimum":1,"description":"Maximum number of conversations to return (default: 20, max: 100)"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":195,"tokensAfter":195},{"name":"list_price_alerts","fixed":{"name":"list_price_alerts","description":"List all registered price-change webhook alerts with their IDs and settings. Operator only: needs the server operator's key (MCP_API_KEY) on the MCP connection (x-api-key or Authorization: Bearer); any other caller, including the chat agent and the local STDIO server, gets error_code operator_key_required.","inputSchema":{"type":"object","required":[],"properties":{}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":115,"tokensAfter":115}],"toolsChanged":22,"tokensSaved":0,"todo":[],"note":"Deterministic fixes. Changes marked verify need a human look before shipping (renames, inferred annotations, inferred types, removed text). Parameter descriptions in `todo` need to be written by someone who knows the API."}