Generate talking-avatar videos from Claude, Cursor, Claude Code or any other MCP client, using the CraftStory API:
CraftStory is an MCP project maintained in the itseez3d/craftstory-mcp repository. The maintainer describes its purpose as “Generate talking-avatar videos from Claude, Cursor, Claude Code or any other MCP client, using the CraftStory API”. Read the project documentation for the complete scope.
The documented npm package is @craftstory/mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.
The example declares CRAFTSTORY_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| list_models | Models, status (a paused model answers 503), limits and prices |
| list_voices | Library voices; include_cloned adds your cloned voices |
| list_avatars | Your custom avatars, or the scenes of one avatar |
| create_audio_clip | Speech from text + voice, or upload a local recording |
| preview_cost | Credit estimate for a CraftStory 2.0 video |
| create_craftstory2_video | Start a CraftStory 2.0 job (photo or avatar scene + audio clips) |
| get_job_status | Status, percentage, failure reason, refund flag |
| get_job_result | Full record with the signed video URL (valid 7 days) |
| wait_for_job | Bounded polling (default 45 s, max 55 s); call again while state is running |
| upscale_video | New job with the upscaled result (CraftStory 2.0 720p -> 1080p, H3 2x) |
{
"mcpServers": {
"craftstory": {
"command": "npx",
"args": [
"-y",
"@craftstory/mcp"
],
"env": {
"CRAFTSTORY_API_KEY": "YOUR_CRAFTSTORY_API_KEY"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| CRAFTSTORY_API_KEY | Declared in the maintainer’s client configuration. | Yes |
Independent-index web search for assistants — fresh results without the Google API maze.
Manipulates video files using FFmpeg to resize videos and extract audio in various formats.
Analyzes YouTube videos by extracting transcripts, summarizing content, and answering questions using AI.
Retrieves YouTube video URLs from a specified Watch Later playlist within a given timeframe.
Extracts subtitles from YouTube videos using a provided link.
Enables AI assistants to interact with the YouTube API through the Model Context Protocol (MCP).