Routara LLM Gateway

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

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"

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