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.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.

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

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