# Modelflare

> Modelflare is an MCP server for design and media. Generate and edit images and videos from any MCP client with one API key. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, API
- **Website:** https://modelflare.dev/sign-up
- **Repository:** https://github.com/castaly-ai/modelflare-mcp
- **MCP Registry name:** io.github.castaly-ai/mcp-server
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server --env MODELFLARE_API_KEY='<MODELFLARE_API_KEY>' -- npx -y @modelflare/mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@modelflare/mcp-server"
      ],
      "env": {
        "MODELFLARE_API_KEY": "<MODELFLARE_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@modelflare/mcp-server"
      ],
      "env": {
        "MODELFLARE_API_KEY": "<MODELFLARE_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelflare/mcp-server"
      ],
      "env": {
        "MODELFLARE_API_KEY": "<MODELFLARE_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@modelflare/mcp-server"
      ],
      "env": {
        "MODELFLARE_API_KEY": "<MODELFLARE_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@modelflare/mcp-server"
      ],
      "env": {
        "MODELFLARE_API_KEY": "<MODELFLARE_API_KEY>"
      }
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [cursor-talk-to-figma-mcp](https://ai-powered.com/mcp/cursor-talk-to-figma-mcp): cursor-talk-to-figma-mcp is an open-source MCP server for design and media.
- [Design Feeds](https://ai-powered.com/mcp/design-feeds): Design Feeds is a freemium MCP server for design and media.
- [Meigen AI MCP](https://ai-powered.com/mcp/meigen-ai-mcp): Meigen AI MCP is an open-source MCP server for design and media.
- [Z-Image MCP](https://ai-powered.com/mcp/z-image-mcp): Z-Image MCP is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/modelflare
