# OmniRoute MCP Server

Connects to the OmniRoute MCP server and its 110 tools across routing, cache and audit.

- Repository: https://github.com/cheaper-inference/OmniRoute (83611 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add cheaper-inference/OmniRoute --skill omni-mcp -g -a claude-code -y`
Codex: `npx skills add cheaper-inference/OmniRoute --skill omni-mcp -g -a codex -y`
Cursor: `npx skills add cheaper-inference/OmniRoute --skill omni-mcp -g -a cursor -y`
Gemini CLI: `npx skills add cheaper-inference/OmniRoute --skill omni-mcp -g -a gemini-cli -y`

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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

<!-- 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 http://localhost:20128/api/mcp/audit \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
```

### GET /api/mcp/audit/stats

GET mcp › audit › stats

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

### GET /api/mcp/sse

GET mcp › sse

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

### POST /api/mcp/sse

POST mcp › sse

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

```bash
curl http://localhost:20128/api/mcp/status \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
```

### GET /api/mcp/stream

GET mcp › stream

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

### POST /api/mcp/stream

POST mcp › stream

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

```bash
curl -X DELETE http://localhost:20128/api/mcp/stream \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
```

### GET /api/mcp/tools

GET mcp › tools

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

## Payloads

The rest: https://github.com/cheaper-inference/OmniRoute/blob/HEAD/skills/omni-mcp/SKILL.md