# CraftStory

> CraftStory is a paid MCP server for design and media. Make talking-avatar videos, short clips, images and music from an AI assistant. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** Web, CLI, API
- **Website:** https://craftstory.com/mcp/
- **Repository:** https://github.com/itseez3d/craftstory-mcp
- **MCP Registry name:** io.github.itseez3d/craftstory-mcp
- **Categories:** design and media
- **Listing updated:** 2026-11-15

## About

CraftStory's server wraps each documented endpoint of the CraftStory API as a tool, plus a talking_video_from_photo prompt that walks the assistant through the full flow. A user can ask for a portrait video of a person reading a script, and the assistant chooses a voice, synthesizes the speech, starts the render and returns a link.

Two in-house models are named in the README. CraftStory 2.0 turns one photo plus audio into a talking video of any length, taking 8 to 15 minutes. MiniMax H3 makes clips of up to 15 seconds, either description-driven with generated sound or audio-driven with lip-sync. The site also mentions other clip models such as Seedance 2.5, and image generation, music and ambient sound tools. Cost can be previewed before a render, generations are billed in credits like the app, and failed jobs are refunded.

The hosted connector for claude.ai uses OAuth 2.1 and needs a plan with API access; local clients run the npm package with an API key. The hosted version cannot read local file paths, so photos go in as public URLs or through a one-time upload link valid for 15 minutes.

## Features

- **Photo to talking video:** One photo and a script or recording become a lip-synced video with gestures.
- **Short clips with sound:** MiniMax H3 produces clips up to 15 seconds from a description or from audio.
- **Cost preview:** preview_cost gives a credit estimate before a CraftStory 2.0 video starts.
- **Voices and avatars:** Library voices, cloned voices and custom avatars can be listed and used.
- **Upload links:** request_file_upload gives a one-time page for photos, audio or video, with 20 MB and 100 MB limits.
- **Hosted or local:** Use the OAuth connector on claude.ai or run the npm package with an API key.

## Good for

- Turn a product announcement script into a presenter video
- Generate a 10-second clip from a product photo
- Produce one video per row of leads or scripts in a workflow
- Create background music and ambience tracks

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http craftstory-mcp https://mcp.craftstory.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.craftstory.com/mcp
```

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

```json
{
  "mcpServers": {
    "craftstory-mcp": {
      "url": "https://mcp.craftstory.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "craftstory-mcp": {
      "type": "http",
      "url": "https://mcp.craftstory.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "craftstory-mcp": {
      "serverUrl": "https://mcp.craftstory.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "craftstory-mcp": {
      "type": "http",
      "url": "https://mcp.craftstory.com/mcp"
    }
  }
}
```

## Tools

- `list_models`: Lists video models with status, limits and credit prices.
- `list_voices`: Lists library voices and optionally cloned voices.
- `list_avatars`: Lists custom avatars and their scenes.
- `create_audio_clip`: Creates speech from text and a voice, or uploads a recording.
- `preview_cost`: Estimates credits for a CraftStory 2.0 video.
- `create_craftstory2_video`: Starts a CraftStory 2.0 talking video.
- `create_minimax_h3_video`: Starts a MiniMax H3 clip.
- `create_cloud_video`: Creates a clip from a photo as first frame.
- `request_file_upload`: Returns a one-time upload page for an image, audio or video file.
- `wait_for_upload`: Waits for an upload to arrive.
- `get_upload`: Fetches an uploaded file's details.
- `create_image`: Generates an image.

## FAQ

### What do I need to use it?

A CraftStory plan with API access (Producer) and either an API key for the npm package or a CraftStory sign-in for the hosted connector.

### How long does a video take?

The README gives 8 to 15 minutes for CraftStory 2.0 and 1 to 3 minutes for MiniMax H3.

### Are failed jobs charged?

No. Generations are billed in credits and failed jobs are refunded.

### Can I attach a photo in chat?

Chat attachments do not reach the hosted connector; pass a public URL or use the one-time upload link.

### Which Node version is needed locally?

Node.js 20 or newer.

### Is CraftStory free?

No. CraftStory is a paid product.

### How do I add CraftStory to Claude Code?

Run this command in your terminal: claude mcp add --transport http craftstory-mcp https://mcp.craftstory.com/mcp

### What are the best alternatives to CraftStory?

The closest alternatives to CraftStory are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium 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.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

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