사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/cheaper-inference/omniroute --skill omni-mcp시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
<!-- 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
curl http://localhost:20128/api/mcp/audit \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"GET /api/mcp/audit/stats
GET mcp › audit › stats
curl http://localhost:20128/api/mcp/audit/stats \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"GET /api/mcp/sse
GET mcp › sse
curl http://localhost:20128/api/mcp/sse \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"POST /api/mcp/sse
POST mcp › sse
curl -X POST http://localhost:20128/api/mcp/sse \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'GET /api/mcp/status
GET mcp › status
curl http://localhost:20128/api/mcp/status \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"GET /api/mcp/stream
GET mcp › stream
curl http://localhost:20128/api/mcp/stream \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"POST /api/mcp/stream
POST mcp › stream
curl -X POST http://localhost:20128/api/mcp/stream \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'DELETE /api/mcp/stream
DELETE mcp › stream
curl -X DELETE http://localhost:20128/api/mcp/stream \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"GET /api/mcp/tools
GET mcp › tools
curl http://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:
{
"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: 110 tools)
The table below shows representative core tools; the server's discovery response is authoritative and includes all 110 tools.
| 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 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 -->
