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

npx -y routara-mcp

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

Tools

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"

Environment

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