Getting started with MCP

Plot Party MCP lets an AI agent you already use, such as Claude, ChatGPT, Cursor or Codex, generate images, video and audio with your Plot Party account. You describe the shot in your agent's chat, the agent calls Plot Party's tools, and the results land in your account like anything you make on the site. MCP stands for Model Context Protocol, the open standard these agents use to connect to outside tools.

There is nothing to install on our side. The server is hosted at:

https://plotparty.ai/mcp

It speaks Streamable HTTP and is protected by OAuth, which means you sign in with your normal Plot Party account the first time your agent connects. No API key to copy.

1. Connect your agent

Open plotparty.ai/guide/mcp, pick your client at the top, and follow the three steps. Each client has a Copy button for exactly what it needs. In short:

• Claude: in Claude desktop or claude.ai open Customize, then Connectors, add a custom connector named Plot Party and paste the URL.
• ChatGPT: in the connector settings, add a custom MCP connector named Plot Party with the URL.
• Cherry Studio: in MCP settings, create a streamable HTTP server named Plot Party with the URL.
• Cursor and Codex: add this to your MCP config, then reload the agent:

  {
    "mcpServers": {
      "plotparty": {
        "url": "https://plotparty.ai/mcp"
      }
    }
  }

• OpenClaw: paste the OpenClaw snippet from the guide into mcp.servers, or add the URL with the OpenClaw MCP CLI.
• Hermes: add the YAML snippet to ~/.hermes/config.yaml, or run hermes mcp add plotparty with the URL, then restart Hermes.

Any other client that supports remote MCP servers over Streamable HTTP works the same way: give it the URL.

[Screenshot: The MCP guide page with the client tabs and the three-step connect stepper]

2. Sign in once

The first time the agent reaches Plot Party, your browser opens a Plot Party sign-in page. Sign in with the account whose Plot Points you want to use and the window closes on its own. The agent is now connected; you will not be asked again until the authorization expires or you remove the connector.

Prefer a token? Some clients and scripts cannot do an OAuth sign-in. Open your account menu on plotparty.ai and choose API & MCP Token. Give the token a name, pick how long it lives (7 days to 1 year) and click Generate. Copy it right away: it is shown only while that window is open. Send it as Authorization: Bearer <token>. The same token works for the REST API. A token can spend your Plot Points, so keep it private and revoke it from the same dialog if it leaks.

3. Ask for something

Talk to your agent the way you would brief a collaborator. It will look up the model catalog, pick parameters that the model accepts, and call the right tool. Try:

• "Create a 6-shot 9:16 microdrama opening: rainy street, one mysterious package, cinematic close-ups, then generate the first keyframe."
• "Use this bottle reference to generate a fast 8-second product reveal with handheld energy, crisp lighting, and a final CTA shot."
• "List supported voices, choose a calm documentary voice, and generate a 20-second narration for this explainer scene."

Useful things to know when asking:

• Name a model if you care. Ask the agent to list Plot Party's image or video models first; it reads them from the same catalog the site uses, with each model's options and limits.
• Attach references. Drop an image into the chat, or give a public URL. The agent uploads it to Plot Party and passes it as a reference, first frame or character sheet.
• Generation is asynchronous. Images usually finish inside the same turn. Video takes longer, so the agent shows a card that says it is generating and updates itself when the clip is ready. If your client does not show live cards, ask the agent to check the result by its task id.
• Batches run in parallel. Ask for six frames and a good agent submits all six at once rather than waiting on each.

What the agent can do

Ask for	What happens
Browse models	Lists image, video and audio models with their parameters, so the agent asks for options the model really has.
Images	Text to image, image editing with references, character turnaround sheets, nine-frame storyboard grids and splitting them into single frames, upscaling, re-angling a shot.
Video	Text or image to video, with first and last frames or multiple references depending on the model, and merging clips into one.
Audio	Speech in a chosen voice and language, and background music.
Uploads	Sends a local or pasted image to Plot Party so it can be used as a reference.
Results and history	Fetches a finished task by id, and lists what you have generated before.
Balance	Checks your Plot Points before an expensive run.

The agent can also read model context as MCP resources, for example plotparty://models or plotparty://models/category/video, before it generates.

Where the results go

Everything generated through MCP is saved to your account. On plotparty.ai open Works and pick the MCP tab. Each card shows the prompt, the model, and a status of Generating, Ready or Failed. Click one to preview it full size, copy its prompt or Download it. From there you can bring it into a Canvas, a Story or Studio like any other file.

[Screenshot: The Works page on the MCP tab listing generations made from an AI agent]

Credits

MCP generations spend Plot Points from the same balance as the website, at the same rate per model. If you run out, the agent gets an "Upgrade for more credits" message and nothing is charged; top up or choose a cheaper model and try again. Failed generations are refunded automatically. See what Plot Points are and how they are spent.