SKILL.md
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->
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 REQUIREAPIKEY=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.
<!-- skill:custom-start --> <!-- Migrated from skills/omniroute-mcp/SKILL.md (preserved curated content) -->
OmniRoute — MCP Server
Requires OMNIROUTEURL and OMNIROUTEKEY. 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/claudedesktopconfig.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: 107 tools)
The table below shows representative core tools; the server's discovery response is authoritative and includes all 107 tools.
| Scope | Tools |
|---|---|
| health | omniroutegethealth |
| combos | omniroutelistcombos, omniroutegetcombometrics, omnirouteswitch_combo |
| routing | omniroutesimulateroute, omniroutebestcombofortask, omnirouteexplainroute |
| providers | omniroutegetprovidermetrics, omniroutecheckquota, omnirouteroute_request |
| budget | omniroutesetbudgetguard, omniroutesetroutingstrategy, omniroutesetresilience_profile |
| testing | omniroutetestcombo |
| memory | memoryadd, memorysearch, memory_delete |
| skills | skillinvoke, skilllist, skilldescribe, skillregister |
| cache | omniroutecachestats, omniroutecacheflush |
| admin | omniroutedbhealthcheck, omniroutesyncpricing, omniroutegetsessionsnapshot |
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 <!-- skill:custom-end -->