routara-mcp

Routara MCP Server

Official Model Context Protocol server for Routara — call 787+ LLMs, image, and video models through api.routara.ai from Cursor, Claude Desktop, Windsurf, VS Code, and other MCP clients.

• Website: https://routara.ai
• API: https://api.routara.ai/v1
• Get API key: https://routara.ai/#auth ($1 promo credit on signup)

Install

npx -y routara-mcp

Or add globally: npm install -g routara-mcp

Tools

Tool	Description
routara_list_models	List models in the Routara catalog
routara_chat	Chat completion (OpenAI-compatible)
routara_generate_image	Image generation (cash wallet balance required)
routara_generate_video	Submit async video job (cash balance required)
routara_get_video_status	Poll video task status

Quick start

• Create an API key at routara.ai → Auth (sk-or-v1-...).
• Add to your MCP client:

Cursor

Settings → MCP → Add server, or edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "routara": {
      "command": "npx",
      "args": ["-y", "routara-mcp"],
      "env": {
        "ROUTARA_API_KEY": "sk-or-v1-YOUR_KEY_HERE"
      }
    }
  }
}

Claude Desktop

%APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "routara": {
      "command": "npx",
      "args": ["-y", "routara-mcp"],
      "env": {
        "ROUTARA_API_KEY": "sk-or-v1-YOUR_KEY_HERE"
      }
    }
  }
}

Environment

Variable	Required	Default
ROUTARA_API_KEY	Yes	—
ROUTARA_API_BASE	No	https://api.routara.ai/v1

Listed on

• npm · routara-mcp@1.0.2
• Official MCP Registry · io.github.36412749-collab/routara-mcp
• Glama · claimed listing
• mcp.so
• Smithery
• PulseMCP

Health check (Glama / CI)

The server starts without ROUTARA_API_KEY so registries can run MCP handshake (initialize + tools/list). API key is required only when invoking tools.

npm ci && npm run build && npm test
# Optional live probe (needs real key):
ROUTARA_API_KEY=sk-or-v1-... npm run test:live

After pushing to GitHub, re-run Claim ownership on Glama once to refresh the listing index.

Troubleshooting

Symptom	Fix
ROUTARA_API_KEY is required on tool call	Set env in MCP client config; get key at routara.ai/#auth
401 invalid_api_key	Regenerate key in dashboard; ensure sk-or-v1- prefix
402 / insufficient balance	Top up cash wallet at routara.ai
Image/video fails, chat works	Media requires cash balance; promo credits are chat-only on economy models
Server won't start in inspector	Use npx -y routara-mcp with Node ≥18; run npm run build if developing from source

Development

npm install
npm run build
ROUTARA_API_KEY=sk-or-v1-... npm run test:live
npm test

Billing notes

• One API key works for text, image, and video — switch model and tool, not the key.
• Image/video require cash wallet balance (promo credits cannot be used for media).
• Chat uses standard per-token billing with Smart Route™ failover across upstream pools.

Related

• JSON Translate GitHub Action: https://github.com/36412749-collab/json-translate-action
• Docs: https://routara.ai/docs

License

MIT © Routara