Skip to content
MCP server

CraftStory

Make talking-avatar videos, short clips, images and music from an AI assistant

Install
Pricing
Paid
Platforms
Web, CLI, API
Runs
Locally or Remotely
Version
0.8.0
Listing updated
2 days ago

About CraftStory

CraftStory is a paid MCP server for design and media. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://mcp.craftstory.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "craftstory-mcp": {
      "url": "https://mcp.craftstory.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • CRAFTSTORY_API_KEYCraftStory API key (sk-cs-...), created in the app under Account -> API Access; requires a plan with API accessRequired

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Paid

Credit-based; requires a CraftStory plan with API access. Prices not published here

Prices change. Check craftstory.com before you buy.

CraftStory 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 to CraftStory

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media