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?utm_source=github&utm_medium=repository&utm_campaign=mcp_quickstart
• OpenAI-compatible API: https://api.routara.ai/v1
• Create an API key: https://routara.ai/auth?mode=register&returnTo=%2Fapp&utm_source=github&utm_medium=repository&utm_campaign=mcp_quickstart
• Run a first OpenAI SDK request: Python and Node.js quickstart
• Try the API in Postman: importable first-request collection

Install

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

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

OpenAI Codex

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

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

After adding the config, restart your MCP client and ask it to list Routara models. Then ask it to use routara_chat with a model available to your account. The MCP connection exposes tools; it does not replace the host application's own model subscription or billing.

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

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

For a live API smoke test:

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

Directory listings

• npm
• Official MCP Registry
• Glama
• mcp.so
• Smithery
• PulseMCP

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