CraftStory MCP server

Read from the package source without running it. The installed server may list more.

• create_audio_clipwrite action

  The soundtrack every video model takes as input. Either text (up to 2000 characters) plus exactly one voice (voice_id from list_voices, or voice_user_id for a cloned voice),

• create_craftstory2_videowrite action

  Start a craftstory-2 generation: a photo of a person (image_url or image_path, or a custom avatar scene via scene_id) speaks the given audio clips with lip-sync, gestures and natural motion; any length.

• create_minimax_h3_videowrite action

  Start a minimax-h3 generation from one photo. mode='basic': user_prompt (scene description) + requested_duration_s (5-15); the model animates the photo and generates the soundtrack itself.

• get_job_result

  Full record of a job. For craftstory-2 the video is in `video`, for minimax-h3 in `video_url`, for audio clips in `file`; all are signed URLs valid for 7 days (call again for a fresh link). Also returns the parameters used and the credits charged.

• get_job_status

  Status of a video job or audio clip: status, status_percentage, status_failed, credits_refunded. Terminal states: done; failed*, rejected_* and not_pass_moderation (audio) are failures.

• list_avatars

  Custom avatars trained in the CraftStory app that craftstory-2 can generate with (pass an id as avatar_id).

• list_models

  Catalogue of the video models behind this server with their status, modes, limits and credit prices.

• list_voices

  Library voices (id, name, language, gender) usable as voice_id in create_audio_clip.

• preview_cost

  Credits a craftstory-2 job would cost for the given audio clips and settings, without creating anything.

• upscale_videowrite action

  Creates a NEW job with the upscaled result; the original stays. craftstory-2: only 720p sources, resolution 1080_1920 (from 720_1280) or 1920_1080 (from 1280_720). minimax-h3: always 2x, no resolution needed.

• wait_for_job

  Polls a job's status every few seconds for up to timeout_s (default 45, max 55 - most MCP clients cut a tool call at 60 s) and returns as soon as it is terminal.

• Code scan4 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 7 days ago15/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10

CraftStory: common questions

Is CraftStory MCP server safe?

Yes, by our scan: it is graded A (85/100). Read the CraftStory safety report

How do I install CraftStory?

It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.

Does CraftStory need an API key?

Yes. The registry entry asks for CRAFTSTORY_API_KEY.

Is CraftStory maintained?

The last commit was 8 days ago (2026-09-12). The latest release is v0.1.3.

What can I use instead of CraftStory?

Servers from other publishers that do the same job: Apatero Studio MCP server, Sonilo Music & Sound Effects MCP server and Katto MCP server. Compare all CraftStory alternatives.