mcp.film

mcp.film / Avatars & Performance / CraftStory MCP

CraftStory MCP

OfficialRemoteby CraftStory (itseez3d)creditsverified Oct 20, 2026

Official CraftStory server: talking-avatar video from a photo and audio, plus short MiniMax H3 clips with sound.

What it does

CraftStory's own MIT-licensed server drives its API from any MCP client: long-form talking-avatar videos built from a single photo and a voice track (CraftStory 2.0), short MiniMax H3 clips in basic, reference and avatar modes, TTS from a voice library, upscaling, images, music and sound effects. A preview_cost tool quotes credits before anything renders. For a filmmaker-agent it is a presenter and talking-head pipeline that can also produce its own dialogue, cutaways and bed music under one account.

Connect

Remote endpoint (Streamable HTTP)
https://mcp.craftstory.com/mcp
Claude Code
claude mcp add --scope user craftstory -e CRAFTSTORY_API_KEY=sk-cs-... -- npx -y @craftstory/mcp
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "craftstory": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.craftstory.com/mcp"
      ]
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "craftstory": {
      "url": "https://mcp.craftstory.com/mcp"
    }
  }
}
Auth: api_key · env CRAFTSTORY_API_KEY — In the CraftStory app under Account -> API Access (needs a plan with API access); the hosted remote uses OAuth sign-in instead

Sample tools

list_modelslist_voiceslist_avatarscreate_audio_clippreview_costcreate_craftstory2_videocreate_minimax_h3_videocreate_minimax_h3_avatar_videowait_for_jobget_job_resultupscale_videocreate_imagecreate_musiccreate_sound_effectrequest_file_upload

Field notes

Verified 20 Oct 2026 against CraftStory's MCP page, the repo README and npm; no tools were run. The npm package @craftstory/mcp is at 0.6.0 (published 2026-10-14, Node 20+) and maintained from a craftstory.com account; the repo lives in the itseez3d org, is MIT, created 2026-09-12 and pushed 2026-10-14 — new and active, but zero stars, so it has no track record yet. The hosted remote's protected-resource metadata points at an Auth0 tenant, and the README has you paste a fixed public OAuth Client ID (hAlwpyaDeO0CmuEKMibZxiXxtTT09NXL, no secret) into the connector's advanced settings rather than relying on dynamic registration — so in Claude Code the stdio command above is the documented route. The hosted remote cannot read local paths or chat attachments; use public URLs or the request_file_upload one-time page. Locally, any file path you pass is uploaded to CraftStory, so keep tool approvals on. API access needs a paid plan (the README names Producer); generations spend app credits and failed jobs are refunded. Long renders are async and wait_for_job returns after at most 55 s, so expect the agent to poll several times. Signed result URLs expire after 7 days — download masters promptly. For dubbing and translation, heygen reaches further.

Also in Avatars & Performance

Pairs well with