qaimos/storeshots-mcp

Turn raw app screenshots into polished **App Store and Google Play marketing screenshots** from Cursor, Claude, or any other MCP client.
This is a small stdio MCP server that talks to the hosted StoreShots API. Rendering happens on the server, so you don't need Chrome, Puppeteer, or a design tool on your machine. Give your agent a few screenshots and some headlines, and it saves store-ready PNGs (or a ZIP) into your project.
- 1–5 screenshots per set, from local files or URLs
- 5 curated styles: glow, midnight, sunset, mint, trailing, plus custom colours
- Device frames: iphone, iphone-duo, android, ipad
- Every required store size in one call: ios-6.9 (1320×2868), ios-6.5 (1242×2688), android-phone (1080×1920), ipad-13 (2064×2752)
- Headlines and captions for each slide
- Downloads a ZIP and/or PNGs straight into your project
Quick start
1. Get a free API key
Sign up with your email at **https://storeshots.qaimos.co.uk/account.html**. The key (ss_...) is only shown once, so copy it somewhere safe.
2. Add the server to your MCP client
**Cursor**: add this to ~/.cursor/mcp.json (or to .cursor/mcp.json in a project). You can also use the "Install in Cursor" button above.
**Claude Desktop**: open Settings → Developer → Edit Config, then add the same block to claude_desktop_config.json:
**Claude Code**:
**VS Code, Windsurf, and other clients**: run npx -y storeshots-api-mcp over stdio with STORESHOTS_API_KEY set in the environment.
Requires Node.js 18.17 or newer.
3. Ask your agent
> Make App Store screenshots from ./shots/home.png and ./shots/stats.png in the midnight style with the headlines "Build habits that stick" and "See your progress", and save them to ./store-assets.
Tools
| Tool | What it does |
|---|---|
| list_styles | Lists the available styles with their colours and layouts |
| list_devices | Lists the device frames and store output sizes |
| generate_screenshots | Renders one set from screenshots (1–5 paths or URLs). Optional inputs: style, device, targets[], headlines[], captions[], appName, theme (colour overrides), download_to, and download_format (zip \| png \| both). Returns a jobId |
| get_output | Downloads a job's ZIP and/or PNGs to output_dir. Outputs are kept for 24h |
| get_balance | Shows your paid credits, the free sets left this month, and the available credit packs |
| buy_credits | Returns a Stripe Payment Link for a pack, which you open in the browser. The tool itself never charges you |
Configuration
| Variable | Required | Default |
|---|---|---|
| STORESHOTS_API_KEY | yes | none. Get a free key at account.html |
| STORESHOTS_API_URL | no | https://storeshots.qaimos.co.uk/api.php |
| STORESHOTS_OUTPUT_DIR | no | ~/StoreShots (the default download folder) |