Agents · New in 1.8

Your coding agent can make the screenshots.

A local MCP server for App Store screenshots, built into Screenpane 1.8 and later.

Stay in your editor and ask: “Use Screenpane to make the App Store screenshots for this app.” The agent reads your code for what the app does, captures screens from the Simulator, designs the set in Screenpane, checks it, and exports the files. It's in Screenpane 1.8 and later.

An iPhone Duo App Store screenshot: the headline Every day, planned, and the open Duo showing a Lisbon itinerary beside a map of the day's walk.
Designed by Claude through Screenpane's agent tools, from three captures.

Set up the MCP server

One line, once. Screenpane opens itself when an agent needs it.

Claude Code MCP setup

claude mcp add --scope user screenpane -- "/Applications/Screenpane.app/Contents/MacOS/Screenpane" --mcp

Cursor MCP setup

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "screenpane": { "command": "/Applications/Screenpane.app/Contents/MacOS/Screenpane", "args": ["--mcp"] }
  }
}

Codex and other agents

codex mcp add screenpane -- "/Applications/Screenpane.app/Contents/MacOS/Screenpane" --mcp

Any agent that runs a local MCP server works the same way: the command is Screenpane itself with --mcp. The same lines, with a copy button, are in Screenpane → Settings → Agents.

What the agent can do

  • Everything the inspector does: layouts, backgrounds, devices and bezels, captions and highlights, close-ups, badges, shapes and images.
  • Capture the booted Simulator, or replace a screen's capture and keep its design.
  • See its work: render a screen, the whole set, or the first three at App Store search size.
  • Read your app's colours from its icon and captures, and preview layouts on your own screens before choosing.
  • Translate captions and check every language.
  • Review the set: captions colliding or cut off, low contrast, headlines too small to read in search, missing translations, store rules.
  • Try a change without making it, and see the result first.
  • Export every size and language. Uploading to App Store Connect stays with you.

The MCP tools

What the agent sees when it connects: twenty tools, each one a thing you could do in the window yourself.

  • screenpane_statusStart here: the version, whether the licence allows export, the open project, and whether you're busy.
  • screenpane_describeThe open project: languages, pages, screens and their layers.
  • screenpane_user_contextWhat you have selected, so “this screen” means the one you mean.
  • screenpane_navigateShows you something in the window: a screen, a layer, the whole set, a language.
  • screenpane_catalogThe layouts, backgrounds, devices, fonts, shapes and badges it can use, art directions, and a guide to designing well.
  • screenpane_projectOpens a recent project or starts a new one, in the window or in the background.
  • screenpane_pagesThe product page, custom product pages, product page tests and a Google Play page.
  • screenpane_screensImports, duplicates, moves, deletes and replaces screens.
  • screenpane_captureTakes a screenshot of a booted iOS Simulator and adds it to the project.
  • screenpane_assetsImports files so designs can use them.
  • screenpane_layoutApplies a built-in layout, or copies one screen's design onto others.
  • screenpane_layerAdds, changes, removes and reorders layers: everything the inspector sets.
  • screenpane_textCaption words, translations and fitting.
  • screenpane_backgroundSets the background of a screen or the whole set.
  • screenpane_panoramaLinks neighbouring screens so one background runs across them.
  • screenpane_renderRenders up to four screens so the agent can see what it made.
  • screenpane_render_setRenders the set side by side, or the first three at App Store search size.
  • screenpane_reviewChecks every language for collisions, cut-off and low-contrast captions, missing translations and store rules.
  • screenpane_exportWrites the screenshots as files, in every size and language.
  • screenpane_undoUndoes its own latest step, and refuses if the newest step is yours.

You stay in charge

  • It works in the project you have open, live: every edit shows on your canvas as it happens.
  • Each edit is a step in your Edit menu, named after the agent. Undo it like your own.
  • It waits while you're typing or dragging, and never overwrites a change you just made.
  • Pause agents from the Screenpane menu or Settings → Agents: they can still look, but not change anything.
  • It can work on another project in the background while you use the window.
  • Everything runs on your Mac. Nothing is hosted, and your project never leaves it.

Questions

Does it need a licence?

Agents can design and render with Screenpane just as you can. Exporting follows your licence, the same as the Export button.

Which agents are tested?

Claude Code. Cursor and Codex use the same standard MCP setup.

Something not working? Get help.