CtrlK
BlogDocsLog inGet started
Tessl Logo

omni-mcp

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

51

Quality

56%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No known issues

Fix and improve this skill with Tessl

tessl review fix ./skills/omni-mcp/SKILL.md
SKILL.md
Quality
Evals
Security

Overview

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

{
  "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-..." }
      }
    }
  }
}

Available tools (37 total)

ScopeTools
healthomniroute_get_health
combosomniroute_list_combos, omniroute_get_combo_metrics, omniroute_switch_combo
routingomniroute_simulate_route, omniroute_best_combo_for_task, omniroute_explain_route
providersomniroute_get_provider_metrics, omniroute_check_quota, omniroute_route_request
budgetomniroute_set_budget_guard, omniroute_set_routing_strategy, omniroute_set_resilience_profile
testingomniroute_test_combo
memorymemory_add, memory_search, memory_delete
skillsskill_invoke, skill_list, skill_describe, skill_register
cacheomniroute_cache_stats, omniroute_cache_flush
adminomniroute_db_health_check, omniroute_sync_pricing, omniroute_get_session_snapshot

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

Scopes

Tools are grouped into 13 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

Repository
diegosouzapw/OmniRoute
Path

skills/omni-mcp/SKILL.md

Commit

3070925

Last updated
Created

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.

Claim skill