@runmux/mcp

RunMux MCP server — generate video and manage face assets from any MCP client (Claude Desktop, Claude Code, Cursor, …). Wraps the official @runmux/sdk, so tools handle submit→wait and the face-enroll flow for you.

Tools

• generate_video — submit + wait, returns the video URL(s). Supports image_url/reference_images, resolution, duration, number_results, and auto_enroll_faces (pass a raw face image and it is enrolled automatically).
• enroll_face — register an ordinary (non-celebrity) face and return its asset:// reference.
• create_asset — register an asset (returns immediately as processing).
• get_video — check a job's status / URL.
• list_models — models available to your key.

Option A — local (stdio)

Run it locally; your key stays on your machine. Example MCP client config:

{
  "mcpServers": {
    "runmux": {
      "command": "npx",
      "args": ["-y", "@runmux/mcp"],
      "env": { "RUNMUX_API_KEY": "sk-..." }
    }
  }
}

Then ask your assistant: "Use RunMux to make a 5-second video of a diamond ring rotating on black velvet."

Option B — hosted (HTTP)

Connect your MCP client to the hosted endpoint and pass your RunMux key as a Bearer token. The server uses your key only for that request and never stores it.

POST https://<your-runmux-mcp-host>/mcp
Authorization: Bearer sk-...

Run the HTTP server yourself

RUNMUX_API_KEY-less; per-request Bearer is used.
PORT=8790 npm run start:http

GET /healthz returns { "ok": true }.

Config

• RUNMUX_API_KEY — key for the stdio server (Option A).
• RUNMUX_BASE_URL — override the API base (default https://api.runmux.com).
• PORT / MCP_PATH — HTTP server port / path (Option B; default 8790 / /mcp).