DramaCanvas

DramaCanvas: AI Filmmaking MCP Server for Short Drama, Storyboard and AI Video Generation in Claude, Codex and Cursor

An AI film maker you can drive from your coding agent. Connect Claude, Codex or Cursor to the DramaCanvas MCP server and turn a script into episodes, storyboards, character looks and generated video on one infinite canvas.

DramaCanvas accounts and API keys are created at dramacanva.com. Free to start; generation uses credits. View pricing at https://dramacanva.com/pricing.

*Pick a style. Write one line. The canvas lays out the rest.*

What you can do

• Turn scripts into episodes, units, and linked storyboard layouts on an infinite canvas.
• Build character looks with consistent identity across scenes and shots (expert profile).
• Batch generate first frames for storyboard shots using configured models.
• Read, preview, update, and manage connected canvas nodes and layouts.
• Delegate short video production tasks to the hosted Agent using the expert profile.

Quick start

1. Create account and API key

1. Sign up for a free account at https://dramacanva.com.
2. Create an API key at https://dramacanva.com/access-keys.
3. Keep the key secret. Keys and OAuth connections support an optional spend limit (default unlimited).

2. Connect your client

Claude.ai and Claude Desktop

In Claude.ai or Claude Desktop, add a custom connector with the URL https://dramacanva.com/api/mcp and sign in. No API key needed.

Claude Code

Run the command from configs/claude-code.sh:

#!/usr/bin/env sh

Claude Code: connect DramaCanvas over streamable HTTP with your API key.

Create the key at https://dramacanva.com/access-keys and export it first:

export DRAMACANVA_API_KEY="your-key"

claude mcp add --transport http dramacanva https://dramacanva.com/api/mcp --header "Authorization: Bearer $DRAMACANVA_API_KEY"

OpenAI Codex

Run the command from configs/codex.sh:

#!/usr/bin/env sh

OpenAI Codex CLI: the key is read from the DRAMACANVA_API_KEY environment variable.

Create the key at https://dramacanva.com/access-keys

codex mcp add dramacanva --url https://dramacanva.com/api/mcp --bearer-token-env-var DRAMACANVA_API_KEY

Cursor

For the default profile, add the configuration from configs/cursor.mcp.json:

{

"mcpServers": { "dramacanva": { "url": "https://dramacanva.com/api/mcp", "headers": { "Authorization": "Bearer ${env:DRAMACANVA_API_KEY}" } } } }

For the expert profile, add the configuration from configs/cursor-expert.mcp.json:

{

"mcpServers": { "dramacanva-expert": { "url": "https://dramacanva.com/api/mcp?profile=expert", "headers": { "Authorization": "Bearer ${env:DRAMACANVA_API_KEY}" } } } }

3. First prompt to try

Paste this prompt into your connected client:

Use the script_to_storyboard prompt with this brief: "Two detectives inspect a locked vault under the city library and find a humming brass cylinder."

Screenshots

DramaCanvas home page with the "Let an AI Agent do it · MCP / API" box (tabs: Claude Code, Codex, Cursor, Other).

One production canvas with 126 connected nodes (character references, scene images, shot rows).

The 3D Director Console starter canvas: scene blocking -> 15-second camera rehearsal (grey-box mannequin) -> final "Spring Record" film, with the written brief beside it.

The 3D Director Console editor: camera path, performer mannequin, keyframe timeline, shot sequence.

Tools

The default profile provides 22 tools over streamable HTTP at https://dramacanva.com/api/mcp (protocol version 2025-11-25, server name dramacanvas).

Account and models

Projects and script

Canvas

Generation

Expert profile

Connect to https://dramacanva.com/api/mcp?profile=expert to enable the expert profile. This profile adds character versions, revising existing shots, assets, the hosted Agent (agent_start, agent_get_run), and timeline rendering. The profile does not grant extra permissions. What a client can call is the profile intersected with the key scopes. Always read tools/list and only call tools that are listed. OAuth scopes include account:read, models:read, projects:read, projects:write, canvas:read, canvas:write, tasks:read, tasks:write, assets:read, assets:write, agent:run, and offline_access.

Built-in prompts

Read prompts via prompts/list. Each prompt takes a required brief (script or creative brief) and optional canvasId and projectId. character_lookbook and one_click_short_video are listed only in the expert profile.

Short-drama skills

DramaCanvas ships ready-made skills for short-drama and storyboard work. Open any of them on the site, or let an agent use them through the expert profile (list_skills, search_skills, get_skill, add_skill, as used by the one_click_short_video prompt). Browse all skills at https://dramacanva.com/skills.

Recipes

• recipes/01-script-to-storyboard.md: Turn a script into episodes and linked storyboards.
• recipes/02-character-lookbook.md: Build character looks with consistent identity.
• recipes/03-batch-first-frames.md: Generate consistent first frames for storyboard shots.
• recipes/04-one-click-short-video.md: Delegate short video production to the hosted Agent (expert profile).

Costs and safety

• Credits: generate_media submits and charges credits immediately, without a confirmation step. The key holder is responsible for costs.
• Spend limits: Keys and OAuth connections support an optional spend limit. The default is unlimited. Set spend limits when creating keys at https://dramacanva.com/access-keys.
• Idempotency: Every write tool needs an idempotencyKey of 8–128 characters. Retries reuse the same key and identical arguments.
• Canvas edits: Read canvas_list_node_types and canvas_get_state before editing. Pass the latest snapshotHash. On a snapshot conflict, re-read, revise, and use a new key.
• Polling: `wait_generatio