English Français العربية

StoreShots

Official registry Marketing and sales

Turn raw app screenshots into App Store and Google Play marketing screenshots.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package storeshots-api-mcp
Claude Code 
claude mcp add storeshots -e 'STORESHOTS_API_KEY=<your storeshots_api_key>' -e 'STORESHOTS_API_URL=<STORESHOTS_API_URL>' -e 'STORESHOTS_OUTPUT_DIR=<STORESHOTS_OUTPUT_DIR>' -- npx -y storeshots-api-mcp@0.1.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "storeshots": {
            "command": "npx",
            "args": [
                "-y",
                "storeshots-api-mcp@0.1.2"
            ],
            "env": {
                "STORESHOTS_API_KEY": "<your storeshots_api_key>",
                "STORESHOTS_API_URL": "<STORESHOTS_API_URL>",
                "STORESHOTS_OUTPUT_DIR": "<STORESHOTS_OUTPUT_DIR>"
            }
        }
    }
}

Environment variables

  • STORESHOTS_API_KEY required secret Your StoreShots API key (free key at https://storeshots.qaimos.co.uk/account.html)
  • STORESHOTS_API_URL API endpoint (default https://storeshots.qaimos.co.uk/api.php)
  • STORESHOTS_OUTPUT_DIR Default download folder for get_output (default ~/StoreShots)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. StoreShots MCP
  2. Quick start
  3. Tools
  4. Configuration
  5. Pricing
  6. Privacy
  7. Development
  8. Links
  9. License

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.

{
  "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-mcp

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

ToolWhat it does
list_stylesLists the available styles with their colours and layouts
list_devicesLists the device frames and store output sizes
generate_screenshotsRenders 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_outputDownloads a job's ZIP and/or PNGs to output_dir. Outputs are kept for 24h
get_balanceShows your paid credits, the free sets left this month, and the available credit packs
buy_creditsReturns a Stripe Payment Link for a pack, which you open in the browser. The tool itself never charges you

Configuration

VariableRequiredDefault
STORESHOTS_API_KEYyesnone. Get a free key at account.html
STORESHOTS_API_URLnohttps://storeshots.qaimos.co.uk/api.php
STORESHOTS_OUTPUT_DIRno~/StoreShots (the default download folder)
STORESHOTS_TIMEOUT_MSno300000

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.js

npm test runs an end-to-end test against a local copy of the StoreShots PHP API, which isn't part of this repo.

License

MIT

Frequently asked questions

What is StoreShots?

Turn raw app screenshots into App Store and Google Play marketing screenshots.

How do I install StoreShots?

It runs on your machine. In Claude Code: claude mcp add storeshots -e 'STORESHOTS_API_KEY=<your storeshots_api_key>' -e 'STORESHOTS_API_URL=<STORESHOTS_API_URL>' -e 'STORESHOTS_OUTPUT_DIR=<STORESHOTS_OUTPUT_DIR>' -- npx -y storeshots-api-mcp@0.1.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does StoreShots need an API key?

Yes. It expects STORESHOTS_API_KEY, which you set in its configuration.

Is StoreShots open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains StoreShots?

It is published by qaimos. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.