# OpenRouter MCP server

Remote MCP server: https://mcp.openrouter.ai/mcp (Streamable HTTP, OAuth or an OpenRouter API key as a Bearer token).

Once connected you can list models, prices and endpoints, check credits, read rankings and docs, send test messages, generate images, speech and video, transcribe audio, and call the Decisions API, all from your agent. Inference tools are billed to the connected OpenRouter account.

## Connect

Claude Code:

```
claude mcp add --transport http openrouter https://mcp.openrouter.ai/mcp
claude mcp login openrouter
```

Codex CLI:

```
codex mcp add openrouter --url https://mcp.openrouter.ai/mcp
codex mcp login openrouter
```

OpenCode (~/.config/opencode/opencode.json):

```json
{ "mcp": { "openrouter": { "type": "remote", "url": "https://mcp.openrouter.ai/mcp", "enabled": true } } }
```

Cursor (~/.cursor/mcp.json):

```json
{ "mcpServers": { "openrouter": { "url": "https://mcp.openrouter.ai/mcp" } } }
```

Any other MCP client: add a remote server at https://mcp.openrouter.ai/mcp. If the client has no OAuth flow, send `Authorization: Bearer <OPENROUTER_API_KEY>`.

## Use it

Call `list-models` (20 results by default, paginate with `limit` and `offset`) before choosing a model. `generate-video` returns a `job_id` when the job is still running; poll it with `get-video`. Video results are links, not inline bytes.

Full tool reference: https://openrouter.ai/docs/guides/overview/mcp-server