OmniRoute Setup

OmniRoute, connected to your tools

One key and one endpoint for OpenCode, VS Code, Crush and the MCP server. Start with the quick start, then pick your tool.

TL;DR

Set OMNIROUTE_API_KEY, copy the config for your tool, and run its check. 19 models answered on 2 and 3 Nov 2026.

  1. Quick startThree steps that every tool shares.
  2. Pick your pathOne page per tool, plus models, the API and troubleshooting.
OpenAI-compatible base URL
https://routes.e-gob.de/v1
MCP endpoint (streamable HTTP)
https://routes.e-gob.de/api/mcp/stream
Environment variable
OMNIROUTE_API_KEY

Quick start link

The same three steps for every tool. The details are on the start page.

  1. Get the config and the key

    The config comes from the repo; the key comes from the owner. Start here for both.

  2. Set the key

    export OMNIROUTE_API_KEY="sk-your-key"
  3. Check the connection

    curl -s -o /dev/null -w "%{http_code}\n" \
      -H "Authorization: Bearer $OMNIROUTE_API_KEY" \
      https://routes.e-gob.de/v1/models

    Expect 200. Then open your tool's page below.

Pick your path link

Each row gives the short version, why it matters, and the page with the steps.

  1. OpenCode A terminal agent with every OmniRoute model in its picker.One config file, and the MCP server is built in. Steps →
  2. VS Code The OpenCode extension, or an MCP server in your project.The key is asked once and never written into the file. Steps →
  3. Crush A terminal agent that reads one crushrc file.No web or desktop UI, just a script you can read. Steps →
  4. MCP server The gateway's 111 tools for your agents.Health, combos, quota and routing, behind one Bearer key. Steps →
  5. Models 19 models answered at the last check.Pick by status, context window and tool support. Table →
  6. API Call the gateway from scripts or any OpenAI or Anthropic client.Three requests you can copy and run. Reference →
  7. When something fails The errors you will see, and what to do about each.Most failures are a key, a model ID or a context window. Fixes →
  8. Why one gateway Switch models without editing each tool's config.One endpoint and one key for many providers. Read →