Routara MCP Server

Official Model Context Protocol server for Routara. Use Routara chat, image, and video models from Cursor, Claude Desktop, Codex, Windsurf, VS Code, and other MCP clients.

Website and setup guide: https://routara.ai/mcp
OpenAI-compatible API: https://api.routara.ai/v1
Create an API key: https://routara.ai/#auth

Install

Terminal

npx -y routara-mcp

Or install the one-click routara-mcp.mcpb bundle from the latest GitHub release.

Tools

Tool	Description
`routara_list_models`	Search and paginate the live model catalog
`routara_chat`	Single-turn or multi-turn chat, including tool calls
`routara_generate_image`	Text-to-image and reference-image generation
`routara_generate_video`	Text-to-video and image-to-video submission
`routara_get_video_status`	Poll an asynchronous video task

MCP client configuration

config.json

{
  "mcpServers": {
    "routara": {
      "command": "npx",
      "args": ["-y", "routara-mcp"],
      "env": {
        "ROUTARA_API_KEY": "sk-or-v1-YOUR_KEY_HERE"
      }
    }
  }
}

OpenAI Codex

toml

[mcp_servers.routara]
command = "npx"
args = ["-y", "routara-mcp"]
enabled = true

[mcp_servers.routara.env]
ROUTARA_API_KEY = "sk-or-v1-YOUR_KEY_HERE"

Environment

Variable	Required	Default
`ROUTARA_API_KEY`	Yes for tool calls	None
`ROUTARA_API_BASE`	No	`https://api.routara.ai/v1`
`ROUTARA_API_TIMEOUT_MS`	No	`30000`

The process can start and complete the MCP handshake without an API key. A key is resolved only when a Routara tool is invoked, which lets directories validate the server safely.

Reliability and compatibility

Requests time out instead of hanging indefinitely.
Transient network errors, HTTP 429, and HTTP 5xx responses are retried with bounded backoff.
API errors include the upstream request ID and retry delay when available.
routara_chat returns the complete OpenAI-compatible response, preserving reasoning content and tool calls.
Media parameters are forwarded only when explicitly supplied; model-specific support varies.

Development

Terminal

npm ci
npm run build
npm test
npm run validate:registry
npm run build:mcpb

For a live API smoke test:

bash

ROUTARA_API_KEY=sk-or-v1-... npm run test:live

Directory listings

Security

Do not commit API keys. If a key is exposed, revoke it in the Routara dashboard immediately. Please report security issues privately to support@routara.ai.

License

MIT