English Français العربية

Routara LLM Gateway

Official registry Media and design

OpenAI-compatible LLM, image and video APIs via Routara (api.routara.ai).

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package routara-mcp
Claude Code 
claude mcp add routara-llm-gateway -e 'ROUTARA_API_KEY=<your routara_api_key>' -e 'ROUTARA_API_BASE=<ROUTARA_API_BASE>' -- npx -y routara-mcp@1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "routara-llm-gateway": {
            "command": "npx",
            "args": [
                "-y",
                "routara-mcp@1.0.1"
            ],
            "env": {
                "ROUTARA_API_KEY": "<your routara_api_key>",
                "ROUTARA_API_BASE": "<ROUTARA_API_BASE>"
            }
        }
    }
}

Environment variables

  • ROUTARA_API_KEY required secret Routara API key (sk-or-v1-...) from https://routara.ai/#auth
  • ROUTARA_API_BASE Optional API base URL (default https://api.routara.ai/v1)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Routara MCP Server
  2. Install
  3. Tools
  4. MCP client configuration
  5. Environment
  6. Reliability and compatibility
  7. Development
  8. Directory listings
  9. Security
  10. License

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.

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

ToolDescription
routara_list_modelsSearch and paginate the live model catalog
routara_chatSingle-turn or multi-turn chat, including tool calls
routara_generate_imageText-to-image and reference-image generation
routara_generate_videoText-to-video and image-to-video submission
routara_get_video_statusPoll 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

VariableRequiredDefault
ROUTARA_API_KEYYes for tool callsNone
ROUTARA_API_BASENohttps://api.routara.ai/v1
ROUTARA_API_TIMEOUT_MSNo30000

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 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

Frequently asked questions

What is Routara LLM Gateway?

OpenAI-compatible LLM, image and video APIs via Routara (api.routara.ai).

How do I install Routara LLM Gateway?

It runs on your machine. In Claude Code: claude mcp add routara-llm-gateway -e 'ROUTARA_API_KEY=<your routara_api_key>' -e 'ROUTARA_API_BASE=<ROUTARA_API_BASE>' -- npx -y routara-mcp@1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Routara LLM Gateway need an API key?

Yes. It expects ROUTARA_API_KEY, which you set in its configuration.

Is Routara LLM Gateway open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Routara LLM Gateway?

It is published by 36412749-collab. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.