Modelflare
Generate and edit images and videos from any MCP client with one API key
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 0.1.2
- Listing updated
- today
Similar MCP servers
About Modelflare
Modelflare is an MCP server for design and media. It runs locally on your machine and is started by your AI client.
One Modelflare Smart API Key covers every image and video model enabled on your account. When creating the key you pick a routing strategy: balanced, stability first or low price first. The model list is fetched from the key itself, so newly added models show up without changing anything on your side.
Images are made or edited through a single tool, with model-specific options passed along unchanged. Videos run as asynchronous tasks: you start one, check progress, then download the result, waiting up to 300 seconds if it is still rendering. Everything is saved to a local output folder straight away, because the README notes that result URLs expire.
Usage is billed to your Modelflare balance by actual consumption. A global endpoint is the default, a China endpoint is available, and error messages can be switched between English and Chinese. Claude Desktop users can install a packaged .mcpb bundle that prompts for the key, base URL and output folder.
Install
Run in a terminal
claude mcp add mcp-server --env MODELFLARE_API_KEY='<MODELFLARE_API_KEY>' -- npx -y @modelflare/mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@modelflare/mcp-server"
],
"env": {
"MODELFLARE_API_KEY": "<MODELFLARE_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@modelflare/mcp-server"
],
"env": {
"MODELFLARE_API_KEY": "<MODELFLARE_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelflare/mcp-server"
],
"env": {
"MODELFLARE_API_KEY": "<MODELFLARE_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@modelflare/mcp-server"
],
"env": {
"MODELFLARE_API_KEY": "<MODELFLARE_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@modelflare/mcp-server"
],
"env": {
"MODELFLARE_API_KEY": "<MODELFLARE_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
MODELFLARE_API_KEYModelflare Smart API Key (create one at https://modelflare.dev/keys)RequiredMODELFLARE_BASE_URLglobal (default), china, or a custom base URLMODELFLARE_OUTPUT_DIRDirectory for generated images and videos (default ./modelflare-output)
Tools this server provides (5)
Taken from the project documentation; the running server may differ.
- list_models
- Lists the image and video models the key can call, with the docs page for each; kind text lists text models.
- generate_image
- Generates an image, or edits one with edit true, and saves it.
- create_video
- Starts an asynchronous video task and returns its task ID.
- get_video_status
- Returns the status and progress of a video task.
- download_video
- Saves a finished video, optionally waiting up to 300 seconds.
What it does
- One key, many models
- A Smart API Key can call every image and video model available to the account.
- Routing strategies
- Choose balanced, stability first or low price first when creating the key.
- Image generation and edits
- generate_image creates a new image or edits one when edit is set to true.
- Async video tasks
- create_video starts a task and returns an ID that get_video_status can poll.
- Local saving of results
- Outputs go to a configurable folder, since result URLs expire.
- Claude Desktop bundle
- A downloadable .mcpb file asks for the key, base URL and output folder.
Good for
- Create illustrations from a prompt inside an AI coding client
- Edit an existing image through an assistant
- Render short videos and fetch the finished file
- Compare which models your account can use
- Route generation to the cheapest or most stable model
Pricing
Pricing unknown
Pay by usage from a Modelflare balance; the server itself is MIT licensed
Prices change. Check modelflare.dev before you buy.
Modelflare FAQ
How do I get an API key?
Sign up at modelflare.dev, open API Keys in the console and create a Smart API Key.
How is usage charged?
Calls are billed to your Modelflare balance by actual usage, and the README points to a usage-logs page for details.
Where do generated files end up?
In ./modelflare-output by default, or the folder set in MODELFLARE_OUTPUT_DIR.
What does a 403 insufficient_user_quota error mean?
The README says to top up your balance on the billing page.
Can I use the China endpoint?
Yes. Set MODELFLARE_BASE_URL to china, or to a custom URL.
How do I add Modelflare to Claude Code?
Run this command in your terminal: claude mcp add mcp-server --env MODELFLARE_API_KEY='<MODELFLARE_API_KEY>' -- npx -y @modelflare/mcp-server
What are the best alternatives to Modelflare?
The closest alternatives to Modelflare are HyperFrames by HeyGen, next-ai-draw-io, mcp-for-blender, ffmpeg-skill and cursor-talk-to-figma-mcp.
Where this comes from
- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.



