npm routara-mcpstdioMITupdated 1mo ago
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.
What can you do with 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_chatreturns 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
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
Install
Add Routara LLM Gateway to your client. Pick the one you use.
claude mcp add routara-mcp -- npx -y routara-mcpcodex mcp add routara-mcp -- npx -y routara-mcpamp mcp add routara-mcp -- npx -y routara-mcp{
"mcpServers": {
"routara-mcp": {
"command": "npx",
"args": [
"-y",
"routara-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"routara-mcp": {
"command": "npx",
"args": [
"-y",
"routara-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"routara-mcp","command":"npx","args":["-y","routara-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"routara-mcp": {
"command": "npx",
"args": [
"-y",
"routara-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"routara-mcp": {
"command": "npx",
"args": [
"-y",
"routara-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"routara-mcp": {
"command": "npx",
"args": [
"-y",
"routara-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"routara-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"routara-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"routara-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"routara-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y routara-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
5 tools
Routara LLM Gateway exposes 5 tools to a connected agent.
- 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
Score
69 / 100
Good
- Documentation22/25
- Maintenance16/25
- Trust13/20
- Capability6/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 43 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 5 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 1.0.1Latest | Jun 22, 2026 |