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/mcp

Any 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_error

Pass 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_errors

Lists 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.

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.