omni-mcp
Connect to the NextRoute MCP server (37 tools, 3 transports: SSE/stdio/HTTP). Covers routing, cache, compression, memory, skills, providers, and audit tools across 16 permission scopes.
SKILL.mdskills/omni-mcp/SKILL.md
GitHub<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->
Overview
Connect to the NextRoute 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/reference/openapi.yaml for detailed request/response schemas.
NextRoute — MCP Server
Requires NEXTROUTE_URL and NEXTROUTE_KEY. See entry-point SKILL for setup.
Transports
- stdio — local IPC, for Claude Desktop / VS Code extensions
- SSE —
GET $NEXTROUTE_URL/api/mcp/sse - Streamable HTTP —
POST $NEXTROUTE_URL/api/mcp/stream
Claude Desktop config
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"nextroute": {
"command": "npx",
"args": ["-y", "nextroute", "--mcp"],
"env": { "NEXTROUTE_KEY": "sk-..." }
}
}
}
Cursor / VS Code config
{
"mcp": {
"servers": {
"nextroute": {
"url": "http://localhost:20128/api/mcp/sse",
"headers": { "Authorization": "Bearer sk-..." }
}
}
}
}
Available tools (37 total)
| Scope | Tools |
|---|---|
| health | nextroute_get_health |
| combos | nextroute_list_combos, nextroute_get_combo_metrics, nextroute_switch_combo |
| routing | nextroute_simulate_route, nextroute_best_combo_for_task, nextroute_explain_route |
| providers | nextroute_get_provider_metrics, nextroute_check_quota, nextroute_route_request |
| budget | nextroute_set_budget_guard, nextroute_set_routing_strategy, nextroute_set_resilience_profile |
| testing | nextroute_test_combo |
| memory | memory_add, memory_search, memory_delete |
| skills | skill_invoke, skill_list, skill_describe, skill_register |
| cache | nextroute_cache_stats, nextroute_cache_flush |
| admin | nextroute_db_health_check, nextroute_sync_pricing, nextroute_get_session_snapshot |
Full list: GET $NEXTROUTE_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-Nextroute-Scope header.
Reference
Full docs: https://github.com/diegosouzapw/NextRoute/blob/main/docs/frameworks/MCP-SERVER.md
<!-- skill:custom-end -->