DemoStudio

@demostudio/mcp-server

MCP server for DemoStudio — lets any MCP-compatible AI assistant (Claude Code, Cursor, Windsurf, etc.) generate short-form video ads directly from a conversation.

What it does

• `generate_video` — Turn a text brief into a rendered Instagram Reel / TikTok / YouTube Short
• `get_video_status` — Check build progress and get the exported video URL
• `list_capabilities` — Show all 5 scene types and 17 Remotion templates
• `create_schedule` — Set up the Agent to auto-generate videos on a recurring schedule

Requirements

• Node.js 18+
• A DemoStudio API key — get one at demostudio.xyz/settings

Installation

Claude Code

claude mcp add --transport stdio \

--env DEMOSTUDIO_API_KEY=your_api_key_here \ demostudio \ -- npx -y @demostudio/mcp-server

Cursor / Windsurf

Add to your MCP config file (~/.cursor/mcp.json or ~/.codeium/windsurf/mcp_config.json):

{

"mcpServers": { "demostudio": { "command": "npx", "args": ["-y", "@demostudio/mcp-server"], "env": { "DEMOSTUDIO_API_KEY": "your_api_key_here" } } } }

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{

"mcpServers": { "demostudio": { "command": "npx", "args": ["-y", "@demostudio/mcp-server"], "env": { "DEMOSTUDIO_API_KEY": "your_api_key_here" } } } }

Usage examples

Once installed, just talk to your AI assistant naturally:

Generate a 30-second Instagram Reel for my SaaS product.

It's an AI inbox tool called Clearbox. Target: busy founders. Tone: confident, direct. End with "Try it free at getclearbox.com". Music: uplifting. Add subtitles.

What Remotion templates does DemoStudio support?

Check the status of project abc-123.

Set up a weekly automated video for my brand. Product: Kova — project management for remote teams. URL: https://getkova.com. Calm music. Run every Monday.

Tools reference

generate_video

Returns a project URL to preview and export the video.

get_video_status

list_capabilities

No parameters. Returns all 17 Remotion templates with descriptions.

create_schedule

Pricing

DemoStudio is credit-based. New accounts get 500 free credits (enough for ~1 full video). Active accounts receive up to 500 bonus credits every month.

• Scene generation: 10 credits
• Video export: 400 credits
• Automated run: ~700 credits

View pricing →

License

MIT

---

Maintainer guide — publishing updates

1. Make code changes in src/index.ts

2. Bump the version

npm version patch   # 0.1.2 → 0.1.3  (bug fix / small change)

npm version minor # 0.1.2 → 0.2.0 (new tool or renamed tool) npm version major # 0.1.2 → 1.0.0 (breaking change)

3. Publish to npm

npm publish --access public

The prepublishOnly script runs tsc automatically before publishing.

4. Update server.json — bump both version fields

{

"version": "0.1.3", ← top-level version "packages": [{ "version": "0.1.3" ← must match npm version }] }

5. Re-authenticate and publish to MCP registry

The registry JWT expires after ~1 hour. Always re-login before publishing.

# Download the publisher binary (if not already on PATH)

curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher

Login via GitHub device flow

./mcp-publisher login github

→ go to https://github.com/login/device and enter the printed code

Publish

./mcp-publisher publish server.json

6. Push to GitHub

git add -A

git commit -m "chore: bump to vX.Y.Z — " git push origin main

Notes

• server.json $schema URL is versioned — only update it if the registry publishes a new schema version (check https://github.com/modelcontextprotocol/registry/blob/main/docs/reference/server-json/CHANGELOG.md)
• .mcpregistry_* files are gitignored — they contain auth tokens and must never be committed
• The npm token is stored in ~/.npmrc — re-run npm set //registry.npmjs.org/:_authToken if it expires