Skip to content

omni-mcp

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.

1,099
installs
0 up / 0 down, score 0.00
votes
79,391
repo stars
Updated
less than a month ago
In the catalog since
21 Oct 2026
From
cheaper-inference/omniroute
AI & Agents
Get it through your agent npx skills add cheaper-inference/omniroute@omni-mcp

Skill instructions

Rendered from the published SKILL.md, 174 lines.

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.

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:

{
Show the whole skill (54 more lines)

"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: 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