English Français العربية

StoreShots

Registre officiel Marketing et ventes

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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
Configuration JSON (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>"
            }
        }
    }
}

Variables d'environnement

  • STORESHOTS_API_KEY obligatoire 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

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que StoreShots ?

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

Comment installer StoreShots ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour StoreShots ?

Oui. Il attend STORESHOTS_API_KEY, à renseigner dans sa configuration.

StoreShots est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient StoreShots ?

Il est publié par qaimos. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.