Skip to main content
Glama
Free Image to Video MCP Server

Free Image to Video MCP Server

README.md
# Free Image to Video MCP server

Free image to video AI with no daily cap: start with no sign-up, keep going on a free account. Every video comes with sound and no watermark. This is the official MCP server for [Free Image to Video](https://freeimagetovideo.ai/?utm_source=npm&utm_medium=package): Claude, Cursor, Cline, Windsurf or any MCP client can turn a prompt or a photo into a video clip on your own account and hand back the file URL.

- Pass a prompt for [free text to video AI](https://freeimagetovideo.ai/video/free-text-to-video-ai), or a public photo URL as `image_url` to [animate a photo](https://freeimagetovideo.ai/video/animate-photo-ai) with it as the first frame.
- Every clip is [image to video AI with sound](https://freeimagetovideo.ai/video/image-to-video-ai-with-sound): the soundtrack is made in the same pass, on MiniMax H3.

## Tools

| Tool | What it does |
|---|---|
| `generate_video` | Text to video, or photo to video with `image_url`. Returns a run id |
| `check_status` | Status of a run, and the video URL when it is ready |
| `credits` | Credits left on your account (free to call) |

`generate_video` takes `prompt` (required), `image_url`, `duration` (4, 5, 6, 8, 10 or 15 seconds), `resolution` (`480p` default, `768p`), `aspect_ratio` (`16:9` default, `9:16`, `1:1`) and `model` (`minimax-h3`, the only one).

## API key and plan

Create a key at [freeimagetovideo.ai/settings/apikeys](https://freeimagetovideo.ai/settings/apikeys) and set it as `FREEIMAGETOVIDEO_API_KEY`. API runs need a paid plan: each run draws on the plan's daily full-speed allowance, then waits in the relaxed queue ([pricing](https://freeimagetovideo.ai/pricing)). To make clips without a key, use the generator on the website.

## Install (local, stdio)

```bash
npx -y freeimagetovideo-mcp
```

### Claude Desktop / Cursor / Cline / Windsurf

```json
{
  "mcpServers": {
    "freeimagetovideo": {
      "command": "npx",
      "args": ["-y", "freeimagetovideo-mcp"],
      "env": { "FREEIMAGETOVIDEO_API_KEY": "sk-..." }
    }
  }
}
```

Claude Code in one line:

```bash
claude mcp add freeimagetovideo -e FREEIMAGETOVIDEO_API_KEY=sk-... -- npx -y freeimagetovideo-mcp
```

## Remote (Streamable HTTP, no install)

```
https://freeimagetovideo.ai/api/mcp
```

Hosted on freeimagetovideo.ai itself, with the same three tools. Send your key with each request as `Authorization: Bearer sk-...`; listing the tools needs no key.

```bash
claude mcp add --transport http freeimagetovideo https://freeimagetovideo.ai/api/mcp --header "Authorization: Bearer sk-..."
```

```json
{
  "mcpServers": {
    "freeimagetovideo": {
      "url": "https://freeimagetovideo.ai/api/mcp",
      "headers": { "Authorization": "Bearer sk-..." }
    }
  }
}
```

Server Card: `https://freeimagetovideo.ai/.well-known/mcp/server-card.json`

### Gemini CLI

```bash
gemini extensions install https://github.com/hanshs474/fitv-mcp
```

## Notes

- Video takes minutes. `generate_video` returns a run id; poll it with `check_status`.
- Refusals say what to do next: a bad key, a plan that does not include API runs, too many runs at once, or a prompt the content filter refused.
- No dependencies: plain `fetch` and JSON-RPC over stdio, Node 18 or newer.
- `FREEIMAGETOVIDEO_BASE_URL` overrides the endpoint; only useful for testing.

MIT licensed. Made by [Free Image to Video](https://freeimagetovideo.ai/?utm_source=github&utm_medium=package).