Routara LLM Gateway

Routara MCP Server

[npm version] [MCP Registry] [License: MIT]

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

Practical walkthroughs: Python SDK · Node.js SDK · Cursor MCP · Claude Desktop MCP

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"

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

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 cinpm run buildnpm testnpm run validate:registrynpm 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 [email protected].

License

MIT