How do I install the Omniroute MCP skill?

Run npx skillmds@latest add tomevault-io/omniroute-mcp-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Omniroute MCP safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Omniroute MCP?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Omniroute MCP free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Omniroute MCP?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Omniroute MCP by tomevault-io — Agent Skill

Name: Omniroute MCP
Author: tomevault-io

Omniroute MCP

OmniRoute exposes a built-in MCP (Model Context Protocol) server with 37 tools (chat, embeddings, memory CRUD, skills, providers, routing, audit) over SSE/stdio/HTTP transports. Use when the user wants to add OmniRoute as an MCP server in Claude Desktop, Cursor, Cline, or any MCP-compatible client. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

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:

{
  "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-..." }
      }
    }
  }
}

Available tools (37 total)

Scope	Tools
health	`omniroute_get_health`
combos	`omniroute_list_combos`, `omniroute_get_combo_metrics`, `omniroute_switch_combo`
routing	`omniroute_simulate_route`, `omniroute_best_combo_for_task`, `omniroute_explain_route`
providers	`omniroute_get_provider_metrics`, `omniroute_check_quota`, `omniroute_route_request`
budget	`omniroute_set_budget_guard`, `omniroute_set_routing_strategy`, `omniroute_set_resilience_profile`
testing	`omniroute_test_combo`
memory	`memory_add`, `memory_search`, `memory_delete`
skills	`skill_invoke`, `skill_list`, `skill_describe`, `skill_register`
cache	`omniroute_cache_stats`, `omniroute_cache_flush`
admin	`omniroute_db_health_check`, `omniroute_sync_pricing`, `omniroute_get_session_snapshot`

Full list: GET $OMNIROUTE_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-Omniroute-Scope header.

Reference

Full docs: https://github.com/diegosouzapw/OmniRoute/blob/main/docs/frameworks/MCP-SERVER.md

Source: diegosouzapw/OmniRoute — distributed by TomeVault.

---name: omniroute-mcp-2description: OmniRoute exposes a built-in MCP (Model Context Protocol) server with 37 tools (chat, embeddings, memory CRUD, skills, providers, routing, audit) over SSE/stdio/HTTP transports. Use when the user wants to add OmniRoute as an MCP server in Claude Desktop, Cursor, Cline, or any MCP-compatible client. Use when this capability is needed.---# OmniRoute — MCP ServerRequires `OMNIROUTE_URL` and `OMNIROUTE_KEY`. See [entry-point SKILL](https://raw.githubusercontent.com/diegosouzapw/OmniRoute/main/skills/omniroute/SKILL.md) 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 configAdd 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-..." } } } }}```## Available tools (37 total)| Scope | Tools || --------- | -------------------------------------------------------------------------------------------------- || health | `omniroute_get_health` || combos | `omniroute_list_combos`, `omniroute_get_combo_metrics`, `omniroute_switch_combo` || routing | `omniroute_simulate_route`, `omniroute_best_combo_for_task`, `omniroute_explain_route` || providers | `omniroute_get_provider_metrics`, `omniroute_check_quota`, `omniroute_route_request` || budget | `omniroute_set_budget_guard`, `omniroute_set_routing_strategy`, `omniroute_set_resilience_profile` || testing | `omniroute_test_combo` || memory | `memory_add`, `memory_search`, `memory_delete` || skills | `skill_invoke`, `skill_list`, `skill_describe`, `skill_register` || cache | `omniroute_cache_stats`, `omniroute_cache_flush` || admin | `omniroute_db_health_check`, `omniroute_sync_pricing`, `omniroute_get_session_snapshot` |Full list: `GET $OMNIROUTE_URL/api/mcp/tools`## ScopesTools are grouped into 13 scopes (chat-only, memory-readonly, full-admin, etc.).Pass scope name as `--scope` arg or via `X-Omniroute-Scope` header.## ReferenceFull docs: https://github.com/diegosouzapw/OmniRoute/blob/main/docs/frameworks/MCP-SERVER.md---> Source: [diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) — distributed by [TomeVault](https://tomevault.io).

Frequently asked questions