Overview

Connect to the OmniRoute MCP server (107 tools, 3 transports: SSE/stdio/HTTP). Covers routing, cache, compression, memory, skills, providers, and audit tools across 32 permission scopes.

Authentication

All requests require a valid Bearer token or session cookie. Obtain a token via POST /api/auth/login or configure REQUIRE_API_KEY=false for local development.

Endpoints

No endpoints mapped for this area yet.

Payloads

See the full OpenAPI specification at GET /api/openapi/spec or docs/openapi.yaml for detailed request/response schemas.

OmniRoute — MCP Server

Requires OMNIROUTE_URL and OMNIROUTE_KEY. See entry-point SKILL for setup.

Transports

stdio — local IPC, for Claude Desktop / VS Code extensions
SSE — GET $OMNIROUTE_URL/api/mcp/sse
Streamable HTTP — POST $OMNIROUTE_URL/api/mcp/stream

Claude Desktop config

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

json

{
  "mcpServers": {
    "omniroute": {
      "command": "npx",
      "args": ["-y", "omniroute", "--mcp"],
      "env": { "OMNIROUTE_KEY": "sk-..." }
    }
  }
}

Cursor / VS Code config

json

{
  "mcp": {
    "servers": {
      "omniroute": {
        "url": "http://localhost:20128/api/mcp/sse",
        "headers": { "Authorization": "Bearer sk-..." }
      }
    }
  }
}

Core tool examples (live catalog: 107 tools)

The table below shows representative core tools; the server's discovery response is authoritative and includes all 107 tools.

Scope	Tools
health	`omniroute_get_health`
combos	`omniroute_list_combos`, `omniroute_get_combo_metrics`, `omniroute_switch_combo`
routing	`omniroute_simulate_route`, `omniroute_best_combo_for_task`, `omniroute_explain_route`
providers	`omniroute_get_provider_metrics`, `omniroute_check_quota`, `omniroute_route_request`
budget	`omniroute_set_budget_guard`, `omniroute_set_routing_strategy`, `omniroute_set_resilience_profile`
testing	`omniroute_test_combo`
memory	`memory_add`, `memory_search`, `memory_delete`
skills	`skill_invoke`, `skill_list`, `skill_describe`, `skill_register`
cache	`omniroute_cache_stats`, `omniroute_cache_flush`
admin	`omniroute_db_health_check`, `omniroute_sync_pricing`, `omniroute_get_session_snapshot`

Full list: GET $OMNIROUTE_URL/api/mcp/tools

Scopes

Tools are grouped into 32 scopes (chat-only, memory-readonly, full-admin, etc.). Pass scope name as --scope arg or via X-Omniroute-Scope header.

Reference

Full docs: https://github.com/diegosouzapw/OmniRoute/blob/main/docs/frameworks/MCP-SERVER.md