crazyrouter-mcp
According to the README, this MCP server lets you chat with models, discover available models, and generate images; the schema also lists a generate_video tool, but the README states that implementation was removed.
Chat: Send text messages to supported models via
POST /v1/chat/completions.List models: Discover live models available to your API key with an optional category filter.
Generate images: Create one synchronous image via
POST /v1/images/generations.Not supported by this MCP: Video, music, transcription, TTS, and Midjourney tasks; the old
generate_videotool was removed and these require their own APIs.
Enables AI-driven video generation capabilities through ByteDance's Seedance 1.5 Pro model.
Provides access to Google's AI suite, including Gemini models for text and chat, Imagen for image generation, and Veo for video synthesis.
Allows for cinematic video generation using Kuaishou's Kling V2 model.
Enables the use of Meta's Llama series models for chat and text-based AI interactions.
Provides comprehensive access to OpenAI's ecosystem, including GPT models for chat, DALL-E for image generation, Sora for video, and Whisper for speech-to-text processing.
Enables high-quality AI music composition and generation through Suno's music models.
Crazyrouter MCP: chat, image generation and model discovery
Practical guides / 实操入口
Updated 2026-10-12. This MCP server connects supported clients to Crazyrouter using your API key. The repository implements three tools; the gateway's complete catalogue is broader than these tools.
Related MCP server: OpenRouter MCP Server
Tools
Tool | API | Scope |
|
| Text messages for models listed for Chat Completions; default |
|
| Live models available to your key; optional category filter |
|
| One synchronous image; default |
Model discovery does not imply that this MCP implements each model's protocol. Video, music, transcription, TTS and Midjourney tasks require their own APIs. The old generate_video implementation sent video models to a chat endpoint and has been removed. Use the API documentation for those task APIs.
The server no longer silently replaces failed discovery with a hardcoded model list. Authentication and discovery errors are returned to the client. Categories use public endpoint metadata and name-based audio detection; unknown types appear under other.
Install from npm
Requires Node.js 22 or later.
Configure your MCP client with npx -y crazyrouter-mcp@1.0.1 and set CRAZYROUTER_API_KEY as shown below. The client starts the server automatically.
To build from source instead:
git clone https://github.com/xujfcn/crazyrouter-mcp.git
cd crazyrouter-mcp
npm ci
npm run buildClaude Desktop or Cursor
Create a key in the Crazyrouter console. Add the following to the client's MCP configuration, replacing the key locally:
{
"mcpServers": {
"crazyrouter": {
"command": "npx",
"args": ["-y", "crazyrouter-mcp@1.0.1"],
"env": { "CRAZYROUTER_API_KEY": "YOUR_CRAZYROUTER_API_KEY" }
}
}
}Claude Desktop uses its claude_desktop_config.json; Cursor supports .cursor/mcp.json. Restart the client after editing. Do not commit a configuration containing a real key.
VS Code
Use .vscode/mcp.json and the VS Code MCP schema:
{
"servers": {
"crazyrouter": {
"type": "stdio",
"command": "npx",
"args": ["-y", "crazyrouter-mcp@1.0.1"],
"env": { "CRAZYROUTER_API_KEY": "${input:crazyrouter-api-key}" }
}
},
"inputs": [
{ "type": "promptString", "id": "crazyrouter-api-key", "description": "Crazyrouter API key", "password": true }
]
}Example tool arguments
{"model":"gpt-4o-mini","messages":[{"role":"user","content":"Reply OK"}],"max_tokens":16}Use only one of max_tokens and max_completion_tokens, according to the model's documented schema. Do not send optional temperature values to models that do not support them.
{"category":"image"}{"model":"gpt-image-2","prompt":"A simple blue circle on a white background","n":1}Image output may be a URL or base64 image. The tool returns both formats through MCP and does not report success for an empty result. Size constraints vary by model. Image requests incur the model's normal charges.
Prices and troubleshooting
Current models and prices are the source of truth; there is no fixed model count or universal discount.
HTTP 400: inspect the exact model ID, endpoint, size and other fields. Start with the minimal example.
HTTP 401/403: check your key and permissions. HTTP 429: inspect quota and rate limits.
Models requiring a native task API are rejected by the chat/image tools before inference.
The fixed API base is
https://crazyrouter.com/v1; marketing parameters are never added to API requests.
Development
npm ci
npm run build
npm testTests use mocked HTTP responses through an MCP client/server connection. On 2026-10-12, live checks through the updated MCP passed for model discovery, a minimal gpt-4o-mini chat request and one gpt-image-2 image request. This does not establish that every model or media operation has been tested. Maintainers can run node tests/live-smoke.mjs; add --image to include one billable image request.
中文说明
本仓库支持文本聊天、同步图片生成、实时模型发现三个工具。模型目录会返回视频、音乐等类别,但不代表这些能力已在 MCP 中实现。旧版视频工具错误地调用聊天接口,已移除;请按 API 文档使用原生任务接口。
使用 Node.js 22+,按上面的配置通过 npx -y crazyrouter-mcp@1.0.1 启动。也可以克隆仓库后运行 npm ci 和 npm run build,再将本地 dist/index.js 配置到 MCP 客户端。密钥通过 CRAZYROUTER_API_KEY 传入。不要将模型目录中的显示名称当作精确 API ID,也不要将推广参数添加到接口地址。
License
Available Tools
4 toolschatC
Send a message to any AI model via Crazyrouter. Supports 627+ models including GPT-5, Claude Opus 4.6, Gemini 3, DeepSeek R1, Llama 4, Qwen3, Grok 4, and more.
Inputs: messages (required), model, temperature, max_tokens.
generate_imageC
Generate images using AI models via Crazyrouter. Supports DALL-E 3, Midjourney, Flux, Stable Diffusion, and more.
Inputs: prompt (required), model, size, n.
generate_videoC
Generate videos using AI models via Crazyrouter. Supports Sora 2, Kling V2, Veo 3, Seedance, Pika, and more.
Inputs: prompt (required), model.
list_modelsB
List available AI models on Crazyrouter. Filter by category: chat, image, video, audio, or music.
Inputs: category.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: chat handles text generation, generate_image handles image creation, generate_video handles video generation, and list_models handles model discovery. There is no overlap in functionality, making it easy for an agent to select the correct tool for each task.
All tool names follow a consistent verb_noun pattern: chat, generate_image, generate_video, and list_models. The naming is straightforward and predictable, with no deviations in style or convention across the set.
With 4 tools, this server is well-scoped for its purpose of accessing AI models via Crazyrouter. Each tool earns its place by covering key functionalities: text, image, video generation, and model listing, without being overly sparse or bloated.
The tool set covers the core AI generation domains (text, image, video) and model discovery, but there are minor gaps such as missing audio or music generation tools mentioned in the list_models description. However, agents can work around this by using chat or other tools for those purposes.
Maintenance
Related MCP Connectors
Generate images and videos with 200+ AI models (GPT-Image-2, Seedance, Veo, Kling) via one API.
Best Image and video generation: 20+ models (Kling, Seedance, Veo, NB, FLUX.2), OAuth, pay-per-use.
One API for 100+ AI video, image, music and speech models.
GPT, Claude, Gemini, DeepSeek, Grok, Qwen and GLM through one API key. Pay per token.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAll AI Models in One API 500+ AI Models: https://www.cometapi.com/-
- AlicenseNot gradedqualityDmaintenanceProvides seamless access to 200+ AI models through OpenRouter's unified API, featuring multi-model collaboration, vision support, intelligent benchmarking, and collective intelligence capabilities for enhanced decision-making.10MIT

Adorbis AI MCP Serverofficial
AlicenseNot gradedqualityDmaintenanceEnables AI assistants to access 40+ models via one API key with automatic routing for chat, code, reasoning, and writing tasks.51 npm1MIT
Createya MCP & APIofficial
AlicenseNot gradedqualityDmaintenanceEnables AI agents and developers to generate images, videos, audio, and text using 100+ models via MCP or REST with a single API key.4MIT