Routara MCP Server
Routara MCP Server lets MCP clients use Routara's OpenAI-compatible model catalog, chat, image, and video tools.
List, search, and paginate available Routara models.
Run single-turn or multi-turn chat completions, including system/developer/user/assistant/tool messages, multimodal content, and tool calls.
Return complete OpenAI-compatible chat responses with usage, reasoning content, and tool calls when provided.
Generate or edit images using prompt, size, quality, aspect ratio, reference image URL, negative prompt, seed, style, and response format.
Submit asynchronous text-to-video or image-to-video jobs with model, prompt, fps, duration, resolution, aspect ratio, and negative prompt.
Poll video-generation jobs by task ID, optionally passing a model for provider-specific status routing.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Routara MCP Server list available models"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Practical walkthroughs: Python SDK · Node.js SDK · Cursor MCP · Claude Desktop MCP
Install
npx -y routara-mcpOr install the one-click routara-mcp.mcpb bundle from the latest GitHub release.
Related MCP server: genpark-multi-model-cost-latency-router-skill
Tools
Tool | Description |
| Search and paginate the live model catalog |
| Single-turn or multi-turn chat, including tool calls |
| Text-to-image and reference-image generation |
| Text-to-video and image-to-video submission |
| 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 |
| Yes for tool calls | None |
| No |
|
| No |
|
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:mcpbFor a live API smoke test:
ROUTARA_API_KEY=sk-or-v1-... npm run test:liveDirectory 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
Available Tools
5 toolsroutara_chatA
Create an OpenAI-compatible chat completion through Routara.
Use message for a simple single-turn request, or messages for system prompts, multi-turn chat, multimodal content, and tool-call continuations. The complete upstream response is returned, including usage, reasoning_content, and tool_calls when supplied by the model.
Inputs: model (required), stop, tools, top_p, +5 more.
routara_generate_imageB
Generate or edit an image through Routara.
Model support varies. Besides prompt and size, the tool can pass quality, aspect ratio, reference image URL, negative prompt, seed, style, and response format to compatible models.
Inputs: model (required), prompt (required), n, seed, +7 more.
routara_generate_videoA
Submit an asynchronous video-generation job through Routara.
Supports text-to-video and image-to-video. Save the returned id or task_id and poll it with routara_get_video_status until completed or failed.
Inputs: model (required), prompt (required), fps, duration, +4 more.
routara_get_video_statusB
Poll a Routara video-generation job.
Pass the model when the upstream provider requires model-specific status routing.
Inputs: task_id (required), model.
routara_list_modelsA
List models available through Routara.
Use this before another tool when a model was not specified. Supports pagination and text filtering. The count field is always the total number of matches before pagination; returned is the number included in this response.
Inputs: limit, query, offset.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct operation (listing models, chat, image generation, video submission, status polling) with no overlapping functionality. An agent can clearly distinguish between them.
All tools are prefixed with 'routara_' and follow a verb_noun pattern (list_models, chat, generate_image, generate_video, get_video_status). The only minor inconsistency is 'chat' not using an underscore, but it remains clear.
5 tools is an appropriate size for a server offering AI model interaction services. It is neither sparse nor overwhelming, covering the essential operations.
The set covers main workflows: listing models, chat completions, image generation, video submission, and status polling. A potential gap is lack of a cancel operation for video jobs, but core functionality is present.
Maintenance
Related MCP Connectors
Talk to your public-facing AI from any MCP client — Claude, ChatGPT, Cursor, Cline, Windsurf.
Chat, image, video, and audio models from many vendors behind one remote MCP server and one key.
Connect MCP clients to 2,000+ AI models without managing provider API keys.
Generate images from Claude, ChatGPT, Cursor and Codex with 12 top AI image models. Up to 4 images per call, SVG vectorization, background removal, upscaling and image-to-video. Remote MCP with OAuth, no API keys.
Related MCP Servers
- AlicenseAqualityCmaintenanceConnects Claude Desktop, Cursor, or any MCP-compatible client to 36+ frontier LLMs with automatic per-token payments in USDC on Solana.517 npmMIT
- FlicenseNot gradedqualityBmaintenanceEnables AI agents and MCP clients to dispatch queries to the most suitable model among 70+ LLMs by scoring intent, budget, cost, and latency, returning structured routing decisions with execution telemetry. It runs as a zero-dependency Python MCP server that plugs into Claude Desktop, Cursor, and other MCP-compatible clients.8-
- FlicenseNot gradedqualityNot gradedmaintenanceEnables dynamic, intent- and budget-aware routing of queries across 70+ LLMs by balancing cost and latency through Pareto-optimal model selection. Integrates with MCP clients like Claude Desktop and Cursor for automated multi-model execution.-

zerouter-mcpofficial
AlicenseAqualityBmaintenanceConnects MCP clients such as Claude Desktop, Cursor and Claude Code to an OpenAI- and Anthropic-compatible AI gateway, enabling chat with Claude, GPT, Gemini, Grok and Kimi models, listing available models, and looking up per-million-token pricing. It also sends one prompt to several models in parallel and returns each answer with token usage, latency and estimated cost.4MIT