diegosouzapw/omniroute

omni-mcp

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.

Trending #4705 First seen Jun 10, 2026

Installation

$ npx skills add diegosouzapw/omniroute --skill omni-mcp

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from diegosouzapw/omniroute · top by installs.

npx skills add diegosouzapw/omniroute

Browse all from diegosouzapw/omniroute

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 63.0K
License LICENSE
Default branch release/v3.8.51
Open issues 279
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,789 B
  • docs SUMMARY.md 3,206 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 451 installs

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
  • SSEGET $OMNIROUTE_URL/api/mcp/sse
  • Streamable HTTPPOST $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 -->