{
  "markdown": "# Routara MCP Server\n\n[![npm version](https://img.shields.io/npm/v/routara-mcp.svg)](https://www.npmjs.com/package/routara-mcp)\n[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-listed-blue)](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.36412749-collab%2Froutara-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-emerald.svg)](LICENSE)\n\nOfficial [Model Context Protocol](https://modelcontextprotocol.io) server for [Routara](https://routara.ai). Use Routara chat, image, and video models from Cursor, Claude Desktop, Codex, Windsurf, VS Code, and other MCP clients.\n\n- Website and setup guide: https://routara.ai/mcp\n- OpenAI-compatible API: https://api.routara.ai/v1\n- Create an API key: https://routara.ai/#auth\n\n## Install\n\n```bash\nnpx -y routara-mcp\n```\n\nOr install the one-click `routara-mcp.mcpb` bundle from the latest GitHub release.\n\n## Tools\n\n| Tool | Description |\n|---|---|\n| `routara_list_models` | Search and paginate the live model catalog |\n| `routara_chat` | Single-turn or multi-turn chat, including tool calls |\n| `routara_generate_image` | Text-to-image and reference-image generation |\n| `routara_generate_video` | Text-to-video and image-to-video submission |\n| `routara_get_video_status` | Poll an asynchronous video task |\n\n## MCP client configuration\n\n```json\n{\n  \"mcpServers\": {\n    \"routara\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"routara-mcp\"],\n      \"env\": {\n        \"ROUTARA_API_KEY\": \"sk-or-v1-YOUR_KEY_HERE\"\n      }\n    }\n  }\n}\n```\n\n### OpenAI Codex\n\n```toml\n[mcp_servers.routara]\ncommand = \"npx\"\nargs = [\"-y\", \"routara-mcp\"]\nenabled = true\n\n[mcp_servers.routara.env]\nROUTARA_API_KEY = \"sk-or-v1-YOUR_KEY_HERE\"\n```\n\n## Environment\n\n| Variable | Required | Default |\n|---|---:|---|\n| `ROUTARA_API_KEY` | Yes for tool calls | None |\n| `ROUTARA_API_BASE` | No | `https://api.routara.ai/v1` |\n| `ROUTARA_API_TIMEOUT_MS` | No | `30000` |\n\nThe 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.\n\n## Reliability and compatibility\n\n- Requests time out instead of hanging indefinitely.\n- Transient network errors, HTTP 429, and HTTP 5xx responses are retried with bounded backoff.\n- API errors include the upstream request ID and retry delay when available.\n- `routara_chat` returns the complete OpenAI-compatible response, preserving reasoning content and tool calls.\n- Media parameters are forwarded only when explicitly supplied; model-specific support varies.\n\n## Development\n\n```bash\nnpm ci\nnpm run build\nnpm test\nnpm run validate:registry\nnpm run build:mcpb\n```\n\nFor a live API smoke test:\n\n```bash\nROUTARA_API_KEY=sk-or-v1-... npm run test:live\n```\n\n## Directory listings\n\n- [npm](https://www.npmjs.com/package/routara-mcp)\n- [Official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers/io.github.36412749-collab%2Froutara-mcp/versions)\n- [Glama](https://glama.ai/mcp/servers/36412749-collab/routara-mcp)\n- [mcp.so](https://mcp.so/server/routara-llm-gateway/36412749-collab)\n- [Smithery](https://smithery.ai/servers/nbjack9897/routara-mcp)\n- [PulseMCP](https://www.pulsemcp.com/servers/routara)\n\n## Security\n\nDo 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.\n\n## License\n\nMIT\n",
  "bytes": 3411,
  "sha": "48cdccd0aac89b66835e88a2d9f9072ce93b3707a18ba2176e218e0fc9555709",
  "repo_slug": "36412749-collab/routara-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_36412749_collab_routara_mcp_117c1d20/readme"
}