reelify-mcp

MCP server for Reelify: list auth sessions, plan demos, generate videos, poll run status, download MP4s.

Install: npx -y reelify-mcp (no clone required).

A future scoped @reelify/mcp release requires creating the npm org reelify — see PUBLISHING.md.

Prerequisites

1. A Reelify account and API key (reelify_sk_…) from Account → Security on your deployment.
2. Node.js 18+.

Cursor / Claude / VS Code

Add to your MCP config (mcpServers):

{
  "reelify": {
    "command": "npx",
    "args": ["-y", "reelify-mcp"],
    "env": {
      "REELIFY_API_KEY": "reelify_sk_YOUR_SECRET",
      "REELIFY_BASE_URL": "https://reelify.studio"
    }
  }
}

Local dev against npm run dev:

"REELIFY_BASE_URL": "http://localhost:3000"

Restart the host app after saving.

CLI

export REELIFY_API_KEY=reelify_sk_...
export REELIFY_BASE_URL=https://reelify.studio
npx -y reelify-mcp

Or install globally:

npm install -g reelify-mcp
reelify-mcp

Tools

| Tool | Description | |------|-------------| | reelify_list_auth_sessions | Saved sign-in sessions | | reelify_plan_demo | Start planning → runId | | reelify_generate_demo | Start capture after plan | | reelify_get_run | Poll status / video URL (+ absoluteVideoUrl when done) | | reelify_download_demo | Save final MP4 to a local path | | reelify_create_demo | Full pipeline |

Environment

| Variable | Required | Default | |----------|----------|---------| | REELIFY_API_KEY | yes | — | | REELIFY_BASE_URL | no | http://localhost:3000 |

Docs

Full guide: reelify repo docs/mcp.md