StoreShots
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 coloursDevice frames:
iphone,iphone-duo,android,ipadEvery 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.
{
"mcpServers": {
"storeshots": {
"command": "npx",
"args": ["-y", "storeshots-api-mcp"],
"env": { "STORESHOTS_API_KEY": "ss_your_key_here" }
}
}
}Claude Desktop: open Settings → Developer → Edit Config, then add the same block to claude_desktop_config.json:
{
"mcpServers": {
"storeshots": {
"command": "npx",
"args": ["-y", "storeshots-api-mcp"],
"env": { "STORESHOTS_API_KEY": "ss_your_key_here" }
}
}
}Claude Code:
claude mcp add storeshots --env STORESHOTS_API_KEY=ss_your_key_here -- npx -y storeshots-api-mcpVS 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.
Related MCP server: appstore-mockup-mcp
Tools
Tool | What it does |
| Lists the available styles with their colours and layouts |
| Lists the device frames and store output sizes |
| Renders one set from |
| Downloads a job's ZIP and/or PNGs to |
| Shows your paid credits, the free sets left this month, and the available credit packs |
| Returns a Stripe Payment Link for a pack, which you open in the browser. The tool itself never charges you |
Configuration
Variable | Required | Default |
| yes | none. Get a free key at account.html |
| no |
|
| no |
|
| no |
|
Pricing
Free: 3 sets per month, with a small "Made with StoreShots" watermark
Starter: 10 sets for $3, no watermark
Pro: 20 sets for $5, no watermark
Each set is one generate_screenshots call and includes every size you ask for. You can buy them with buy_credits or on storeshots.qaimos.co.uk.
Privacy
Screenshots are uploaded over HTTPS to the StoreShots API, rendered there, and deleted after 24 hours. Your API key is sent as an X-API-Key header.
Development
npm install
npm run inspect # opens the MCP Inspector against src/index.jsnpm test runs an end-to-end test against a local copy of the StoreShots PHP API, which isn't part of this repo.
Links
Website: https://storeshots.qaimos.co.uk/
MCP Registry:
uk.co.qaimos.storeshots/storeshots
License
MIT
Available Tools
6 toolsbuy_creditsGet a payment link for creditsA
Return the Stripe Payment Link for a credit pack, personalised for this API key (client_reference_id + prefilled email). Nothing is charged by this tool — give the link to the user to pay in their browser; credits are added automatically after payment.
Inputs: pack (required).
generate_screenshotsGenerate store screenshotsA
Turn 1–5 raw app screenshots (local file paths or http(s) URLs) into framed App Store / Google Play marketing screenshots with headlines. One call = one set (all requested sizes) = 1 credit; free keys get 3 watermarked sets per month. Returns a jobId; set download_to (or call get_output) to save the PNGs/ZIP locally.
Inputs: screenshots (required), style, theme, device, +6 more.
get_balanceCredits and free-tier balanceARead-only
Show remaining paid credits, free generations left this month, and available credit packs.
Inputs: no named parameters.
get_outputDownload generated screenshotsA
Download a job's ZIP and/or individual PNGs to a local directory (default ~/StoreShots/). Jobs expire after 24h.
Inputs: job_id (required), format, output_dir.
list_devicesList devices and output sizesARead-only
List device frames (iphone, iphone-duo, android, ipad) and store output targets (ios-6.9 1320x2868, ios-6.5 1242x2688, android-phone, ipad-13).
Inputs: no named parameters.
list_stylesList StoreShots stylesARead-only
List the curated screenshot styles (ids for generate_screenshots.style) with colours and layouts.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: two reference listers (styles vs devices), one generation action, one output retrieval, and two billing operations. No overlapping functionality; an agent can easily select the right tool.
All tool names follow a consistent snake_case verb_noun pattern (list_*, generate_*, get_*, buy_*). No deviations or mixed conventions.
Six tools cover the full workflow without redundancy: two lookups, one core action, one retrieval, and two billing helpers. Well-scoped for the service.
The surface covers style/device discovery, generation, output download, and credit management. Minor gap: no explicit job status or history tool, though get_output implies retrieval; agents can work around this.
Maintenance
Related MCP Connectors
Create 3D device mockups, App Store screenshot sets and launch videos from your AI. Showoff.dev puts your screenshots on real iPhones, Pixels, iPads and MacBooks, sets camera and background, and exports App Store and Google Play sizes. Works with Claude, ChatGPT, Cursor, Codex and any MCP client.
Create 3D device mockups, App Store screenshot sets and launch videos from your AI. Showoff.dev puts your screenshots on real iPhones, Pixels, iPads and MacBooks, sets camera and background, and exports App Store and Google Play sizes. Works with Claude, ChatGPT, Cursor, Codex and any MCP client.
Design and export App Store / Play Store screenshots, localized across all 48 App Store locales.
AI-designed App Store screenshot sets from your app's screens, uploaded to App Store Connect.
Related MCP Servers
- FlicenseAqualityCmaintenanceGenerates beautiful App Store and Play Store screenshots by inserting app images into iPhone/iPad mockup frames with customizable text overlays and gradient backgrounds. Supports multiple device types and batch generation with both free and pro subscription tiers.8-
- AlicenseAqualityDmaintenanceWraps app screenshots in an iPhone 16 Pro frame with marketing text to produce App Store-ready preview images.311MIT
- AlicenseAqualityDmaintenanceMCP server that turns raw in-app screenshots into beautiful, store-ready marketing images for the iOS App Store and Google Play.5MIT
- AlicenseAqualityBmaintenanceAn MCP server that turns raw app screenshots into polished, pixel-perfect store listing visuals with device frames, benefit-driven headlines, brand colors, and exact store dimensions for iOS and Android.6164 npm27MIT