Popcorn Editor
Documentation AI agents (MCP)

AI agents (MCP)

Overview

Last updated Aug 23, 2026

Popcorn Editor ships a built-in MCP server — one URL any MCP-capable AI agent can connect to and design on your behalf. Claude, ChatGPT, Gemini CLI, Cursor, or your own agent connects over streamable HTTP, authenticates as you, and gets a small set of tools for creating, reading, and updating designs in your workspace:

https://popcorneditor.com/mcp/popcorn

Your exact URL is shown in the app under Settings → Your agent access.

Connecting an agent requires a paid Popcorn plan (any member of a paying workspace qualifies). MCP usage consumes no AI credits beyond that — the connected agent brings its own model; Popcorn only validates and compiles documents server-side.

What agents can do

Agents work in the Design Document format (DDS) — never raw editor state. Everything is scoped to your workspace and permission-checked server-side: agents can't read other users' data or touch admin functions.

  • Create designs — validate and compile a Design Document into a new design, returning an editor URL you can open immediately.
  • Read and update existing designs — designs are read back as Design Documents; updates snapshot the previous version first, so every agent edit is restorable from version history.
  • Self-check before writing — a free, side-effect-free validation tool lets agents loop until their document is correct, a layout report catches problems you would normally only catch by eye, and a render tool lets an agent look at its own artboards and fix what is visibly wrong before handing it over.
  • Start from templates — browse the template gallery and spin up a design from any accessible template.
  • Learn the format on the fly — the server publishes the Design Document JSON Schema, an authoring guide, and a guided authoring prompt as MCP resources.

Full details for every tool, resource, and prompt: Tools reference.

Two ways to connect

OAuth sign-in Agent token
Best for App connectors: Claude.ai web, Claude Desktop, ChatGPT CLIs and IDEs: Claude Code, Gemini CLI, Cursor, VS Code
Setup Paste the URL, sign in, click Authorize Mint a token in Settings → Your agent access, send it as an Authorization: Bearer header
Access Read and write Read & write or read only (your choice when minting)
Lifetime 24-hour tokens, refreshed automatically for up to 30 days Optional expiry: 30, 90, or 365 days
Revoke Remove the connector in the AI app Delete the token in Your agent access

For token scopes, expiry, and security details, see Tokens & security.

Pick your client

Not sure which of your apps can do this, or what works on a phone? Start with Where you can connect, then follow the guide for your app:

Wondering what you are handing over? Is it safe to connect an AI agent? answers that in plain terms.

New to the idea? Start with the walkthrough: Let AI agents design for you, or go straight to a real print job with Make print-ready designs by chatting with ChatGPT or Claude.

Limits and admin control

Requests are rate-limited to 60 per minute per user. Documents sent inline are capped at 2 MB, and your workspace's design limit applies to agent-created designs too. Administrators can disable external agent access account-wide, which acts as an organization-wide kill switch.

All results →