Popcorn MCP

Connect Popcorn to your AI agent.

Popcorn lets your AI agent create videos for you. Connect it once, then ask Claude, Cursor, Tasklet, or another MCP-compatible agent to make a movie. Popcorn handles the work in the background.

Describe the video

Give your agent a brief, a style, or a tiny spark of an idea.

Let Popcorn work

Your agent starts the movie and checks progress for you.

Get the movie

When it is ready, your agent brings the finished video link back to chat.

Two ways to connect

Start with one-click connect whenever your agent supports it. A security token is the fallback for agents that still need manual setup.

One-click connect

Recommended

Paste the Popcorn URL into your agent and click Connect. Sign in to Popcorn in your browser, click Approve, and you're done. No keys to copy.

Best for: Claude Mac App and any agent that supports remote MCP OAuth.

Security token

Generate a Popcorn API key in your profile and paste it into your agent's config file. Use this only when one-click connect is not available.

Best for: command-line tools, older clients, and manual MCP configurations.

Start here: copy this to your agent

In many agents, this is all you need. Paste it into your chat and let the agent guide the setup. If it can use OAuth, it should choose that first.

text

Please connect to the Popcorn MCP server.

MCP URL:
https://api.popcorn.co/mcp

If you support OAuth, use one-click connect.
If you do not support OAuth, ask me for a Popcorn security token and help me add it safely.

Once connected, tell me what I can do with Popcorn.

Make your agent smarter with the Popcorn skill

Drop this skill into Claude, Tasklet, or any agent that supports external skills. It teaches the agent how to use the Popcorn MCP tools, how to keep polling until your movie is done, and how to hand back both the video URL and a studio link. Paste the prompt below into your agent.

text

Add the skill found at https://popcorn.co/docs/popcorn-skill.md as a new skill.

View skill →

Step 1

Choose your agent

Start with the first card that matches your tool. OAuth appears first when that provider supports it.

Claude Mac App

Both methods supported

Use Claude's connector flow when you can. It is the friendliest Popcorn setup: paste the URL, sign in, approve.

One-click connectRecommended

1Open the Claude Mac App → Settings → Connectors (or Integrations on some versions).
2
Click Add custom connector. Set the name to Popcorn and the URL to:
text
```
https://api.popcorn.co/mcp
```
3Click Connect. A browser tab opens. If you're not signed in to Popcorn yet, do that first. Then click Approve on the consent screen.
4Back in Claude, the Popcorn connector is now active. Start a chat and ask it to make a video.

Don't see Connectors in your settings? Update Claude Desktop to the latest version, or use the fallback below.

Security token fallback

Use this only if your Claude app does not show the connector flow. You'll need Node.js on your machine. On a Mac: brew install node. On Windows: download from nodejs.org.

1In Claude Desktop, choose Settings → Developer → Edit Config. A Finder window opens pointing to claude_desktop_config.json.
2Open the file and add the following block (merge with anything already there):

json

{
  "mcpServers": {
    "Popcorn": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.popcorn.co/mcp",
        "--header",
        "Authorization: Bearer YOUR_POPCORN_API_KEY"
      ],
      "env": { "API_KEY": "YOUR_POPCORN_API_KEY" }
    }
  }
}

Quit Claude Desktop fully and relaunch (close from the menu bar / system tray, not just the window). Open a new chat and look for Popcorn in the tool picker.

Claude Code

Security token

Anthropic's official CLI for Claude. Uses your API key as a bearer header.

Run this in your terminal:

bash

claude mcp add --transport http popcorn https://api.popcorn.co/mcp \
  --header "Authorization: Bearer YOUR_POPCORN_API_KEY"

Want it scoped to one repo? Add --scope project to write the config to .mcp.json in your repo root instead of your home directory.

Tasklet

Ask the agent

Tasklet can handle the setup from a plain-language request.

Ask your Tasklet agent to connect to Popcorn MCP at this URL:

text

https://api.popcorn.co/mcp

Tasklet knows what to do from there. If it asks how to authenticate, choose OAuth or one-click connect.

Cursor

OAuth first

The AI-first code editor. Start by asking Cursor to connect for you, then use config only if it asks.

Ask Cursor to connectRecommended

Paste the prompt near the top of this page into Cursor Chat. If Cursor offers an OAuth browser flow, use that.

json

{
  "mcpServers": {
    "popcorn": {
      "url": "https://api.popcorn.co/mcp"
    }
  }
}

After the MCP server is connected, restart Cursor so the popcorn tools become available.

Security token fallback

Open or create this file:

~/.cursor/mcp.json

Paste this in:

json

{
  "mcpServers": {
    "popcorn": {
      "url": "https://api.popcorn.co/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_POPCORN_API_KEY"
      }
    }
  }
}

Save the file, then restart Cursor. You'll see the popcorn server in Settings → MCP.

Windsurf (Codeium)

OAuth first

Codeium's agentic IDE. Use OAuth when the client offers it; keep tokens as the fallback.

One-click connectRecommended

Open or create this file:

~/.codeium/windsurf/mcp_config.json

Add Popcorn without headers:

json

{
  "mcpServers": {
    "popcorn": {
      "serverUrl": "https://api.popcorn.co/mcp"
    }
  }
}

Save the file. If Windsurf opens a browser sign-in, approve Popcorn there. In Cascade, refresh the tools list.

Security token fallback

json

{
  "mcpServers": {
    "popcorn": {
      "serverUrl": "https://api.popcorn.co/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_POPCORN_API_KEY"
      }
    }
  }
}

VS Code (with GitHub Copilot Chat)

OAuth first

Requires VS Code 1.101+ and Copilot Chat. Start without a token so VS Code can use its auth flow.

Open the Command Palette → MCP: Open User Configuration, or edit:

macOS: ~/Library/Application Support/Code/User/mcp.json

Windows: %APPDATA%\Code\User\mcp.json

Linux: ~/.config/Code/User/mcp.json

One-click connectRecommended

json

{
  "servers": {
    "popcorn": {
      "type": "http",
      "url": "https://api.popcorn.co/mcp"
    }
  }
}

When VS Code asks you to sign in or approve access, choose the browser-based flow.

Security token fallback

json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "popcorn-key",
      "description": "Popcorn API key",
      "password": true
    }
  ],
  "servers": {
    "popcorn": {
      "type": "http",
      "url": "https://api.popcorn.co/mcp",
      "headers": {
        "Authorization": "Bearer ${input:popcorn-key}"
      }
    }
  }
}

VS Code will prompt you for your Popcorn API key on first use and store it securely; no plaintext key in your config file.

Zed

Security token

High-performance multiplayer code editor.

Open or create:

~/.config/zed/settings.json

Add this section (merge it with whatever's already in the file):

json

{
  "context_servers": {
    "popcorn": {
      "url": "https://api.popcorn.co/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_POPCORN_API_KEY"
      }
    }
  }
}

Other MCP clients

Universal setup

If your agent supports remote MCP, it can connect to Popcorn with the same server URL.

Use OAuth when availableRecommended

Add Popcorn as a remote MCP server. If the client asks how to authenticate, choose OAuth or browser sign-in first.

text

https://api.popcorn.co/mcp

Security token fallback

If your client requires a header, generate a Popcorn security token and use it as a bearer token.

json

{
  "mcpServers": {
    "popcorn": {
      "url": "https://api.popcorn.co/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_POPCORN_API_KEY"
      }
    }
  }
}

Step 2

Need a security token?

Skip this if your agent connected with OAuth. Use this only when a provider asks for an API key or bearer token.

1Sign in to Popcorn and click your avatar to open your Profile.
2On the profile page, click the ⋯ (three-dot) button near the top right.
3Choose API Keys from the menu.
4Click Generate key, give it a friendly name (e.g. “My Mac” or “Cursor”), then click Generate key again.
5Copy the key right now and store it somewhere safe (a password manager works great). It starts with pk_live_ and we won't show it again — but you can always revoke and create a new one.

Step 3

Try it

Open a new chat in your agent and try a prompt like this:

Use Popcorn to make me a 10-second cinematic shot of a fox running through a misty forest at sunrise. When it's done, send me the link.

Your agent will start the movie, then poll until it's ready. Movies typically take 2–10 minutes depending on length and complexity.

Step 4

Common questions

Which connection method should I use?

If your agent supports it, the one-click connect method (OAuth) is easier — no key to copy or store, and you can disconnect any agent later from your profile. If your agent doesn't offer a Connect button, browser sign-in, or connector list, use the security token method.

Where do I see and disconnect connected agents?

Profile → ⋯ → API Keys. The same modal lists your active API keys (security tokens) and your Connected agents (one-click-connected apps). You can revoke either independently.

Is my API key safe?

Yes. The key is sent on the network as a request header — your AI agent reads it from your config file but never shows it to the model, so it can't be leaked in chat. Treat it like a password and don't commit it to GitHub.

My agent isn't using Popcorn — what gives?

A few quick checks:

Did you fully quit and reopen the agent app after editing the config? Most agents only re-read MCP config on startup.
Try saying “Use Popcorn to…” explicitly — agents won't always pick the right tool on their own.
Make sure your API key isn't revoked (or your connected agent isn't disconnected). Verify in your profile (avatar → ⋯ → API Keys).

I lost my key. What do I do?

We can't show it to you again — that's by design. Just go to your profile (avatar → ⋯ → API Keys), revoke the missing one, and generate a new key.

Can I share a key with a teammate?

We don't recommend it — every action taken with the key is billed to your account. Generate a separate key per device or per teammate so you can revoke them individually if anything goes wrong.

Does this work with ChatGPT?

Not yet. ChatGPT's MCP connector format isn't fully compatible with our server today. Use Claude (one-click), Claude Code, Tasklet, Cursor, Windsurf, VS Code, or Zed in the meantime.