Routara LLM Gateway

io.github.36412749-collabPublished by GitHub account 36412749-collabv1.0.1Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyMedia & DesignAI & ML

Overview

AI-generated overview

Routara's official MCP server that lets an assistant browse Routara's model catalog and run chat, image and video generation through its OpenAI-compatible API.

What you can do
  • Search and paginate the live Routara model catalog
  • Run single-turn or multi-turn chat, including tool calls, and get the full OpenAI-compatible response
  • Generate images from text or reference images
  • Submit text-to-video and image-to-video jobs and poll their status
When to use it
Useful when you want an MCP client such as Cursor, Claude Desktop, Codex, Windsurf or VS Code to call Routara-hosted chat, image and video models with one API key instead of wiring up the API yourself.
Requirements
Runs locally via npx from the npm package routara-mcp (Node.js). Requires a Routara API key in ROUTARA_API_KEY for tool calls; the handshake works without one. Optional ROUTARA_API_BASE and ROUTARA_API_TIMEOUT_MS. Network access to api.routara.ai.
Before you install
The API key is a billable credential: keep it out of committed config and revoke it in the Routara dashboard if exposed. Tool calls consume your Routara account quota and billing; the server does not replace the host app's own subscription. Video generation is asynchronous and must be polled.

Installation

In SourceWeft

  1. Open Routara LLM Gateway in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Routara MCP Server

[npm version] [MCP Registry] [License: MIT]

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

bash
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

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

OpenAI Codex

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

bash
npm cinpm run buildnpm testnpm run validate:registrynpm run build:mcpb

For a live API smoke test:

bash
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 [email protected].

License

MIT

Source: README.md at commit 9cf6b13

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts