The CodeRouter MCP Server
Your coding agent hits an LLM API error, pastes it into this MCP server, and gets back the verified cause, whether retrying helps, and the fix — without you opening a browser. Backed by the same curated database as the LLM API Error Reference: every entry is a real, verified error string. Free, no API key, stateless.
Install
Claude Code (one command):
claude mcp add --transport http coderouter https://www.coderouter.io/api/mcpAny MCP client with JSON config (Cursor, Windsurf, custom agents):
{
"mcpServers": {
"coderouter": {
"type": "http",
"url": "https://www.coderouter.io/api/mcp"
}
}
}Transport: MCP Streamable HTTP (JSON-RPC over POST). Endpoint: https://www.coderouter.io/api/mcp
Tools
lookup_llm_errorPass an error message (exact string preferred — that is how the database is indexed), a status code, or a symptom description. Returns the best matches with meaning, retryability, fix, and a deep-dive link.
list_llm_errorsLists the full database, optionally filtered by provider (openai, anthropic, deepseek, gemini, cursor…).
What's in the database
16 verified entries as of 2026-09, covering OpenAI (quota vs rate limits, context overflow), Anthropic (billing 400s, 529 Overloaded), the DeepSeek reasoning_content 400 family, Gemini / AI Studio endpoint and quota errors, and Cursor / Claude Code / proxy-layer configuration failures. The bar for inclusion: the exact error string, the provider/tool combination, and a reproducible cause — no invented errors.
- [DeepSeek 400] The reasoning_content in the thinking mode must be passed back to the api
- [cc-switch + DeepSeek 400] cc switch local proxy failed while handling codex endpoint /responses ... upstream_status:…
- [DeepSeek] deepseek returned tool calls without replayable thinking content; continuing with degraded…
- [LangChain + DeepSeek 400] LangChain agent loop fails with reasoning_content 400 on the second tool step
- [Claude Code 401] HTTP 401 immediately after setting a custom base URL in Claude Code
- [Anthropic 400] Your credit balance is too low to access the Anthropic API. Please go to Plans & Billing t…
- [Anthropic 529] {"type":"overloaded_error","message":"Overloaded"}
- [OpenAI 429] You exceeded your current quota, please check your plan and billing details.
- …and more — see the full reference.
Why an MCP server for this
Most LLM API failures are translation-layer problems — proxies and history stores dropping fields the provider contract requires — and the fastest diagnosis is matching the exact string. Putting the reference behind MCP means the agent that hit the error can diagnose it in the same loop. If the error is not in the database, the server says so honestly instead of guessing. Found one we're missing? The reference page explains the contribution bar.