New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

OmniRoute MCP Server

by diegosouzapw in diegosouzapw/OmniRoute

Connects an agent to the OmniRoute MCP server, which exposes 110 tools over three transports and is guarded by 33 permission scopes.

MITAuto-check passedAgent Workflows

Install OmniRoute MCP Server

skills CLI
$ npx skills add diegosouzapw/OmniRoute --skill omni-mcp -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install diegosouzapw/OmniRoute omni-mcp --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/diegosouzapw/OmniRoute.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/omni-mcp .claude/skills/omni-mcp && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
omni-mcp
GitHub stars
74k
Token cost
~1.3k tokens
SKILL.md length
243 words
Files
1
Skills in repo
50
Repo updated
First seen
Licence
MIT

At a glance

Connects an agent to the OmniRoute MCP server, which exposes 110 tools over three transports and is guarded by 33 permission scopes.

  • Connecting Claude Desktop or an editor to OmniRoute over stdio
  • SKILL.md covers Overview, Authentication, Endpoints and Payloads, plus 6 more sections
  • Calls curl; needs OMNIROUTE_TOKEN and OMNIROUTE_KEY
  • Listing the tools the OmniRoute MCP server exposes

What it does

OmniRoute runs its own MCP server, and this skill explains how to reach it. The tools span routing, cache, compression, memory, skills, providers and auditing, 110 in all, and access is governed by 33 permission scopes.

Three transports are supported: stdio for local use such as Claude Desktop or VS Code extensions, SSE at /api/mcp/sse, and streamable HTTP at /api/mcp/stream. Management endpoints return server status, the tool list and the audit log with statistics. Setup needs OMNIROUTE_URL and OMNIROUTE_KEY, and the full text includes a Claude Desktop configuration section.

When your agent uses it

  • Connecting Claude Desktop or an editor to OmniRoute over stdio
  • Listing the tools the OmniRoute MCP server exposes
  • Reviewing the MCP audit log
  • Choosing between SSE and streamable HTTP

Example prompts

  • “Connect to the OmniRoute MCP server over SSE and list its tools.”
  • “Get the MCP audit stats from my OmniRoute instance.”
  • “Set up Claude Desktop to use OmniRoute over stdio.”

Requirements

  • OMNIROUTE_URL and OMNIROUTE_KEY for an OmniRoute instance

What it can do on your machine

Read from SKILL.md and the folder at commit 4ea24a2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use curl, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • OMNIROUTE_TOKEN
    • OMNIROUTE_KEY
    • REQUIRE_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

OmniRoute MCP Server loads about 1.3k tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 243 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~49
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from diegosouzapw/OmniRoute at commit 4ea24a2, republished under its MIT licence (© diegosouzapw). 243 words, ~1,302 tokens.

Download SKILL.mdSave it as .claude/skills/omni-mcp/SKILL.md (or your agent's skills folder).
name
omni-mcp
description
Connect to the OmniRoute MCP server (110 tools, 3 transports: SSE/stdio/HTTP). Covers routing, cache, compression, memory, skills, providers, and audit tools across 33 permission scopes.
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

Overview

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

GET /api/mcp/audit

GET mcp › audit

bash
curl https://localhost:20128/api/mcp/audit \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/mcp/audit/stats

GET mcp › audit › stats

bash
curl https://localhost:20128/api/mcp/audit/stats \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/mcp/sse

GET mcp › sse

bash
curl https://localhost:20128/api/mcp/sse \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/mcp/sse

POST mcp › sse

bash
curl -X POST https://localhost:20128/api/mcp/sse \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
GET /api/mcp/status

GET mcp › status

bash
curl https://localhost:20128/api/mcp/status \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/mcp/stream

GET mcp › stream

bash
curl https://localhost:20128/api/mcp/stream \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/mcp/stream

POST mcp › stream

bash
curl -X POST https://localhost:20128/api/mcp/stream \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
DELETE /api/mcp/stream

DELETE mcp › stream

bash
curl -X DELETE https://localhost:20128/api/mcp/stream \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/mcp/tools

GET mcp › tools

bash
curl https://localhost:20128/api/mcp/tools \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

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

json
{
  "mcpServers": {
    "omniroute": {
      "command": "npx",
      "args": ["-y", "omniroute", "--mcp"],
      "env": { "OMNIROUTE_KEY": "sk-..." }
    }
  }
}

Cursor / VS Code config

json
{
  "mcp": {
    "servers": {
      "omniroute": {
        "url": "http://localhost:20128/api/mcp/sse",
        "headers": { "Authorization": "Bearer sk-..." }
      }
    }
  }
}

Core tool examples (live catalog: 110 tools)

The table below shows representative core tools; the server's discovery response is authoritative and includes all 110 tools.

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

© diegosouzapw, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/omni-mcp of diegosouzapw/OmniRoute.

Open the folder on GitHubat commit 4ea24a2

Compare with similar skills

OmniRoute MCP Server next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

OmniRoute MCP Server compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
OmniRoute MCP Server this skilldiegosouzapw/OmniRoute74k—~1.3kAutomated safety check: PassMIT
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k5 repos~1.2kAutomated safety check: PassMIT
MCP Integration for Pluginsanthropics/claude-plugins-official38k11 repos~3.1kAutomated safety check: PassApache-2.0
MCP Server Builder with mcp-usemcp-use/mcp-use11k—~923Automated safety check: PassApache-2.0
Agents SDKcloudflare/skills3k2 repos~3kAutomated safety check: PassApache-2.0

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed

  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed

  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    38k GitHub starsUsed in 11 repos~3.1k tokens
    Agent WorkflowsAuto-check passed

  • MCP Server Builder with mcp-use

    mcp-use/mcp-use

    Builds, modifies, debugs, migrates and verifies TypeScript MCP servers and MCP Apps with the mcp-use framework, treating the installed package's types as the source of truth.

    11k GitHub stars~923 tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Agents SDK

    cloudflare/skills

    Official

    Build, debug, or review Cloudflare Agents SDK applications using the agents package.

    3k GitHub starsUsed in 2 repos~3k tokens
    Agent WorkflowsAuto-check passed

  • Cao MCP Apps

    awslabs/cli-agent-orchestrator

    Official

    Enable, operate, and extend CAO's MCP Apps surface — the host-rendered fleet dashboard visible inside MCP App hosts (Claude Desktop, ChatGPT, VS Code Copilot, Goose, Postman).

    1.4k GitHub stars~1.9k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from diegosouzapw/OmniRoute

All 50 skills in this repo

  • OmniRoute Backup and Sync CLI

    diegosouzapw/OmniRoute

    Backup and restore OmniRoute data from the CLI. Trigger incremental snapshots, sync to cloud storage, manage backup schedules, and restore from archive files.

    74k GitHub stars~948 tokensUpdated today
    Auto-check passed

  • Quality Scan

    diegosouzapw/OmniRoute

    Runs a scoped, read-only quality scan on a repository candidate and reports exact evidence, failures and frozen debt, without treating a static scan as release acceptance.

    74k GitHub stars~748 tokensUpdated today
    Auto-check passed

  • OmniRoute Provider Management

    diegosouzapw/OmniRoute

    Manages AI provider connections, API keys, OAuth flows and connection tests through OmniRoute's REST API across its 327-provider catalog.

    74k GitHub stars~2.4k tokensUpdated today
    Auto-check passed

  • OmniRoute Settings API

    diegosouzapw/OmniRoute

    Read and update global application settings: system prompts, thinking budget, IP filters, payload rules, combo defaults, and require-login configuration.

    74k GitHub stars~3.6k tokensUpdated today
    Auto-check passed

  • OmniRoute Database Backups

    diegosouzapw/OmniRoute

    Trigger system backups, restore from backup files, and manage the SQLite database lifecycle. Supports export, import, and incremental snapshot strategies.

    74k GitHub stars~395 tokensUpdated today
    Auto-check passed

  • OmniRoute Batch CLI

    diegosouzapw/OmniRoute

    Submit and monitor batch inference jobs from the CLI. Upload and manage files for batch processing, retrieve results, and integrate batch pipelines with CI/CD…

    74k GitHub stars~565 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about OmniRoute MCP Server

What does OmniRoute MCP Server do?

Connects an agent to the OmniRoute MCP server, which exposes 110 tools over three transports and is guarded by 33 permission scopes. OmniRoute runs its own MCP server, and this skill explains how to reach it. The tools span routing, cache, compression, memory, skills, providers and auditing, 110 in all, and access is governed by 33 permission scopes.

When should I use OmniRoute MCP Server?

OmniRoute MCP Server fits situations like: connecting Claude Desktop or an editor to OmniRoute over stdio; listing the tools the OmniRoute MCP server exposes; reviewing the MCP audit log; choosing between SSE and streamable HTTP.

How do I install OmniRoute MCP Server in Claude Code?

Run `npx skills add diegosouzapw/OmniRoute --skill omni-mcp -a claude-code`. Or copy the skill folder (skills/omni-mcp in diegosouzapw/OmniRoute) into .claude/skills/omni-mcp in your project. Claude Code loads it when a task matches its description.

How do I install OmniRoute MCP Server in Codex?

Run `npx skills add diegosouzapw/OmniRoute --skill omni-mcp -a codex`. Or copy the skill folder (skills/omni-mcp in diegosouzapw/OmniRoute) into .agents/skills/omni-mcp in your project. Codex loads it when a task matches its description.

Can I use OmniRoute MCP Server in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add diegosouzapw/OmniRoute --skill omni-mcp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/omni-mcp, .gemini/skills/omni-mcp, .github/skills/omni-mcp and .opencode/skills/omni-mcp in your project.

What does OmniRoute MCP Server need to run?

Going by SKILL.md and its folder, OmniRoute MCP Server needs the command-line tools its instructions call (curl) and credentials named OMNIROUTE_TOKEN, OMNIROUTE_KEY and REQUIRE_API_KEY. Our summary lists: OMNIROUTE_URL and OMNIROUTE_KEY for an OmniRoute instance.

Does OmniRoute MCP Server access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is OmniRoute MCP Server safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does OmniRoute MCP Server use?

OmniRoute MCP Server is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does OmniRoute MCP Server use?

About 1.3k tokens (SKILL.md is roughly 5.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to OmniRoute MCP Server?

Skills that share tags, products or a category with OmniRoute MCP Server: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars) and MCP Server Builder with mcp-use (mcp-use/mcp-use, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains OmniRoute MCP Server?

diegosouzapw (a GitHub user) maintains it in diegosouzapw/OmniRoute, which has 74,424 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on October 8, 2026.

Source: diegosouzapw/OmniRoute on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.