/omni-mcp

name: omni-mcp
description: "Connect to the OmniRoute MCP server (110 tools, 3 transports: SSE/stdio/HTTP). Covers routing, cache, compression, memory, skills, providers, and audit tools across 33 permission scopes."

<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

Overview

Connect to the OmniRoute MCP server (110 tools, 3 transports: SSE/stdio/HTTP). Covers routing, cache, compression, memory, skills, providers, and audit tools across 33 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

GET /api/mcp/audit

GET mcp › audit

curl http://localhost:20128/api/mcp/audit \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/mcp/audit/stats

GET mcp › audit › stats

curl http://localhost:20128/api/mcp/audit/stats \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/mcp/sse

GET mcp › sse

curl http://localhost:20128/api/mcp/sse \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/mcp/sse

POST mcp › sse

curl -X POST http://localhost:20128/api/mcp/sse \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/mcp/status

GET mcp › status

curl http://localhost:20128/api/mcp/status \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/mcp/stream

GET mcp › stream

curl http://localhost:20128/api/mcp/stream \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/mcp/stream

POST mcp › stream

curl -X POST http://localhost:20128/api/mcp/stream \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

DELETE /api/mcp/stream

DELETE mcp › stream

curl -X DELETE http://localhost:20128/api/mcp/stream \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/mcp/tools

GET mcp › tools

curl http://localhost:20128/api/mcp/tools \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

Payloads

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

<!-- skill:custom-start --> <!-- Migrated from skills/omniroute-mcp/SKILL.md (preserved curated content) -->

OmniRoute — MCP Server

Requires `OMNIROUTE_URL` and `OMNIROUTE_KEY`. See [entry-point SKILL](https://raw.githubusercontent.com/diegosouzapw/OmniRoute/main/skills/omni-auth/SKILL.md) 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`:

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

Cursor / VS Code config

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

Core tool examples (live catalog: 110 tools)

The table below shows representative core tools; the server's discovery response is authoritative and includes all 110 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 33 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 <!-- skill:custom-end -->