The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Appdesigns App Store screenshots listing page.
A free MCP server that lets your coding agent make App Store and Google Play screenshots of your app. Claude Code, Codex, Cursor, VS Code, Gemini CLI or any MCP client with a shell reads your app, proposes the screens, asks you once before adding demo data, captures each screen at store size and opens a framed, captioned set in the appdesigns editor, where you edit it and export store-ready PNGs.
Server: https://appdesigns.click/api/mcp (Streamable HTTP, stateless, no auth)
Setup page: https://appdesigns.click/mcp
Walkthrough: https://appdesigns.click/blog/app-store-screenshots-mcp
| Agent | How |
|---|---|
| Claude Code | claude mcp add --transport http --scope user appdesigns https://appdesigns.click/api/mcp, or this repo as a plugin: /plugin marketplace add haider-nawaz/app-store-screenshots-mcp then /plugin install appdesigns@appdesigns |
| Codex | codex mcp add appdesigns --url https://appdesigns.click/api/mcp |
| Cursor | One-click button on https://appdesigns.click/mcp, or add {"url": "https://appdesigns.click/api/mcp"} under mcpServers in .cursor/mcp.json |
| VS Code (Copilot) | code --add-mcp '{"name":"appdesigns","type":"http","url":"https://appdesigns.click/api/mcp"}' |
| Gemini CLI | gemini mcp add -s user -t http appdesigns https://appdesigns.click/api/mcp |
| Anything else | npx add-mcp https://appdesigns.click/api/mcp |
Then, in your app's folder:
Make App Store screenshots for this app with appdesigns.
In Claude Code, a server added mid-session loads after a restart: quit, run claude --continue
and say "continue".
get_workflow with your platform and store. It returns the capture commands
for your stack and the rules for screens, demo data and captions.create_project, runs the one upload command it returns (each file goes straight to
storage through a signed URL, never through the model), then finish_project.| Tool | What it does |
|---|---|
get_workflow | The full recipe for one platform and store: capture commands, screen, demo data and caption rules |
list_devices | The device frames a set can use |
create_project | Registers the screens (name, headline, file) and returns one upload command |
finish_project | Checks every uploaded file and returns the link to the set |
The server also exposes an app_store_screenshots prompt (in Claude Code:
/mcp__appdesigns__app_store_screenshots).
They are uploaded to a private staging area nobody can browse. Saving the set copies them into your own private project and deletes the staged files; an unsaved set is deleted after 72 hours. Nothing becomes public unless you submit a set to the appdesigns gallery yourself.
.claude-plugin/marketplace.json and plugins/appdesigns/: a Claude Code plugin marketplace
with one plugin that connects the server and adds the app-store-screenshots skill.plugins/appdesigns/skills/app-store-screenshots/SKILL.md: the skill on its own, usable by any
agent that reads Agent Skills (copy it to .claude/skills/, .agents/skills/ or similar).server.json: the entry in the official MCP Registry
as click.appdesigns/screenshots.The server itself is hosted at appdesigns.click; this repository holds the client-side pieces.
MIT