# CraftStory MCP

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

- **Category:** Avatars & Performance
- **Vendor:** CraftStory (itseez3d) (official)
- **Pricing:** credits
- **Verified:** 2026-10-20

## 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: `https://mcp.craftstory.com/mcp`
- Claude Code: `claude mcp add --scope user craftstory -e CRAFTSTORY_API_KEY=sk-cs-... -- npx -y @craftstory/mcp`
- Local: `npx -y @craftstory/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

## Capabilities

[avatar-video](https://mcp.film/capabilities/avatar-video.md) · [talking-head](https://mcp.film/capabilities/talking-head.md) · [image-to-video](https://mcp.film/capabilities/image-to-video.md) · [tts](https://mcp.film/capabilities/tts.md) · [upscaling](https://mcp.film/capabilities/upscaling.md) · [text-to-image](https://mcp.film/capabilities/text-to-image.md) · [music-generation](https://mcp.film/capabilities/music-generation.md) · [sound-effects](https://mcp.film/capabilities/sound-effects.md) · `cost-preview` · [async-jobs](https://mcp.film/capabilities/async-jobs.md)

## Sample tools

`list_models` · `list_voices` · `list_avatars` · `create_audio_clip` · `preview_cost` · `create_craftstory2_video` · `create_minimax_h3_video` · `create_minimax_h3_avatar_video` · `wait_for_job` · `get_job_result` · `upscale_video` · `create_image` · `create_music` · `create_sound_effect` · `request_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.

## Alternatives

- [AKOOL MCP](https://mcp.film/mcps/akool.md) — Hosted MCP for AKOOL face swap, character swap, image-to-video, TTS and avatar lookup.
- [Apatero Studio MCP](https://mcp.film/mcps/apatero.md) — Studio MCP for talking avatars, locked recurring characters, and batched output.
- [Hedra MCP Server](https://mcp.film/mcps/hedra.md) — Character-3 talking-avatar video, TTS, and image generation through Hedra's API.
- [VEED Fabric MCP](https://mcp.film/mcps/veed-fabric.md) — VEED's hosted MCP for talking-head video: pick a character, pick a voice, send a script.
- [Sync MCP Server](https://mcp.film/mcps/sync-labs.md) — Official Sync MCP for lipsync generation, voice cloning, and TTS on existing footage.
- [D-ID MCP Server](https://mcp.film/mcps/d-id.md) — D-ID's hosted MCP connecting agents to the D-ID API and docs for avatar video.

## Verification

- Status: Freshly checked (checked today)
- Added: 2026-10-20
- Last verified: 2026-10-20
- Machine JSON: https://mcp.film/api/mcps/craftstory.json

## Links

- Site: https://craftstory.com/?utm_source=mcp.film&utm_medium=referral&utm_campaign=directory&utm_content=craftstory%3Asite
- Docs: https://craftstory.com/mcp/?utm_source=mcp.film&utm_medium=referral&utm_campaign=directory&utm_content=craftstory%3Adocs
- Repo: https://github.com/itseez3d/craftstory-mcp

---

Structured data: https://mcp.film/api/mcps/craftstory.json · Directory: https://mcp.film
Canonical: https://mcp.film/mcps/craftstory/
Hosted directory MCP: https://mcp.film/mcp