
MCP server for Modelflare: list your models, generate images and videos.
MCP server for Modelflare: list your models, generate images and videos.
·
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
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」,选择路由策略(均衡 / 稳定优先 / 低价优先)。
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 |
|---|---|
MODELFLARE_API_KEY | your Smart API Key (required) |
MODELFLARE_BASE_URL | global → https://modelflare.dev/v1 (default) · china → https://origin.modelflare.dev/v1 · or a custom URL |
MODELFLARE_OUTPUT_DIR | where images and videos are saved (default ./modelflare-output) |
MODELFLARE_LOCALE | en (default) or zh for error messages |
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.
| Tool | What it does |
|---|---|
list_models | Image and video models your key can call, each with the docs page holding its exact request fields. kind: "text" lists text models. |
generate_image | Generates an image, or edits one with edit: true, and saves it. Gemini image models use generateContent; the others use the Images API. |
create_video | Starts an asynchronous video task and returns its task ID. |
get_video_status | Status and progress of a video task. |
download_video | 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.
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.insufficient_user_quota: top up at https://modelflare.dev/billing.Docs: https://docs.modelflare.dev/ · Pricing: https://modelflare.dev/pricing
Listed on the M8ven MCP Trust Index.
MIT © Havenbyte LLC
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add modelflare -- npx -y @modelflare/mcp-server{
"mcpServers": {
"modelflare": {
"env": {
"MODELFLARE_API_KEY": ""
},
"args": [
"-y",
"@modelflare/mcp-server"
],
"command": "npx"
}
}
}code --add-mcp '{"name":"modelflare","env":{"MODELFLARE_API_KEY":""},"args":["-y","@modelflare/mcp-server"],"command":"npx"}'[mcp_servers.modelflare]
command = "npx"
args = ["-y", "@modelflare/mcp-server"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/modelflare-mcp-server to learn what the "Modelflare MCP Server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
| Name | What it does |
|---|---|
list_models | 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. |
generate_image | 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. |
create_video | 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. |
get_video_status | Returns the status and progress of a Modelflare video task. |
download_video | Saves a completed Modelflare video to the output directory. Optionally waits for the task first. Result URLs expire, so download soon after completion. |
Read live from the server on October 17, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/modelflare-mcp-server)Nothing comparable is listed yet.
v0.1.2Modelflare MCP 0.1.2Release notesv0.1.1Modelflare MCP server 0.1.1Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "modelflare-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.