Modelflare MCP
OfficialUse a Modelflare Smart API Key to discover, generate, and retrieve image/video outputs through an MCP client.
List image, video, or text models available to your key, including docs links for exact request fields.
Generate images, or edit images when supported, and save results to the output directory.
Start asynchronous video generation tasks and receive a task ID.
Check video task status and progress.
Download completed videos, optionally waiting up to 300 seconds for completion.
Results are saved promptly because generated media URLs expire; usage is billed to your Modelflare balance.
Modelflare MCP Server
Image and video generation for any MCP client — Claude Desktop, Cursor, Gemini CLI and more — with one Modelflare Smart API Key for every image and video model available to your account.
用一个 Modelflare Smart API Key,在任意 MCP 客户端里调用你账号可用的全部图像和视频模型。
mcp-name: io.github.castaly-ai/mcp-server
Get a Smart API Key / 获取 Smart API Key
Sign up / 注册: https://modelflare.dev/sign-up?utm_source=mcp-registry&utm_medium=plugin&utm_campaign=integrations
Console → API Keys → Create Smart API Key, and pick a routing strategy (Balanced / Stability first / Low price first).
控制台 API Keys →「Create Smart API Key」,选择路由策略(均衡 / 稳定优先 / 低价优先)。
Related MCP server: multimodal-mcp
Configure / 配置
Add the server to your MCP client:
{
"mcpServers": {
"modelflare": {
"command": "npx",
"args": ["-y", "@modelflare/mcp-server"],
"env": {
"MODELFLARE_API_KEY": "<your Smart API Key>"
}
}
}
}Variable | Value |
| your Smart API Key (required) |
|
|
| where images and videos are saved (default |
|
|
Claude Desktop: download modelflare-mcp-<version>.mcpb from Releases and open it; Claude Desktop asks for the API key, base URL and output folder. modelflare-mcp-<version>-smithery.mcpb is the same bundle with each tool's inputSchema in the manifest, as Smithery requires. node build-mcpb.mjs rebuilds both.
Tools / 工具
Tool | What it does |
| Image and video models your key can call, each with the docs page holding its exact request fields. |
| Generates an image, or edits one with |
| Starts an asynchronous video task and returns its task ID. |
| Status and progress of a video task. |
| Saves a finished video; can wait up to 300 seconds first. |
Model-specific fields go in parameters (images) or request (videos) and are sent unchanged. The model list comes from your key, so new models appear without editing the key. Generated results are saved right away because result URLs expire.
Calls are billed to your Modelflare balance by actual usage; see https://modelflare.dev/usage-logs.
Troubleshooting / 常见问题
401: the key is missing or invalid. Create a Smart API Key at https://modelflare.dev/keys.
model_not_found: a regular key only calls the models of its own group. A Smart API Key calls every model available to your account. If you already use a Smart API Key, that model is not available to your account right now.403
insufficient_user_quota: top up at https://modelflare.dev/billing.
Links
Docs: https://docs.modelflare.dev/ · Pricing: https://modelflare.dev/pricing
Listed on the M8ven MCP Trust Index.
License
MIT © Havenbyte LLC
Available Tools
5 toolscreate_videoCreate a video taskA
Starts an asynchronous Modelflare video task and returns its task ID. Poll with get_video_status and save with download_video. Billed to the Modelflare balance by actual usage.
Inputs: model (required), request (required).
download_videoDownload a finished videoA
Saves a completed Modelflare video to the output directory. Optionally waits for the task first. Result URLs expire, so download soon after completion.
Inputs: task_id (required), wait_seconds.
generate_imageGenerate or edit an imageA
Generates an image, or edits one with edit=true, using a Modelflare image model, and saves the result to the output directory. Billed to the Modelflare balance by actual usage.
Inputs: model (required), prompt (required), edit, parameters.
get_video_statusGet video task statusCRead-only
Returns the status and progress of a Modelflare video task.
Inputs: task_id (required).
list_modelsList Modelflare modelsARead-only
Lists the models this Modelflare API key can call, with the docs page that holds each media model's exact request contract. Defaults to image and video models.
Inputs: kind.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool covers a distinct step: create_video (start task), get_video_status (poll), download_video (save), generate_image (image gen/edit), list_models (discovery). The only mild overlap is download_video optionally waiting for a task, which partially duplicates get_video_status, but descriptions clearly delineate roles.
All five tools follow a clean verb_noun snake_case pattern (create_video, download_video, generate_image, get_video_status, list_models). The convention is applied uniformly with no deviations.
Five tools is well-scoped for a media generation API, covering video task lifecycle, image generation, and model discovery. Each tool earns its place with no redundancy.
Core lifecycle is covered: create/status/download for video and generate/edit for image, plus model listing. Minor gaps exist (no cancel_task, no list_tasks, and no image status polling), but primary workflows are fully supported.
Maintenance
Related MCP Connectors
Generate images and videos with Seedance, Veo, Wan, Grok, GPT-Image and Nano Banana via one MCP.
Generate images with any major model — one API key, one prepaid balance, one MCP.
Create images & video from any MCP agent — 17 models, spend limits, one URL.
Generate AI images and videos from any compatible MCP client.
Related MCP Servers
- AlicenseAqualityFmaintenanceProduction-grade MCP server for image and video understanding and generation across Gemini, OpenAI, and Grok.587 PyPI4Apache 2.0
- AlicenseAqualityDmaintenanceMulti-provider media generation MCP server that generates images, videos, audio, and transcriptions from text prompts using OpenAI, xAI, Gemini, ElevenLabs, and BFL through a single unified interface.6169 npm2MIT
- AlicenseAqualityAmaintenanceStateless MCP server that wraps OpenAI's Sora, Whisper, GPT-4o Audio, and TTS APIs for generating videos, images, and processing audio.933 PyPI6MIT
- AlicenseNot gradedqualityCmaintenanceGenerate AI images and videos from Claude, Cursor or any MCP client: 48+ models on one account (Flux 2, Nano Banana 2, Seedream 5, Kling V3, Seedance 2.5, Veo 3.1), with the exact cost in credits returned on every call.1MIT