Skip to main content
Glama
StoreShots

StoreShots

StoreShots MCP

npm MCP Registry License: MIT

Install in Cursor

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.

Related MCP server: appstore-mockup-mcp

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)

STORESHOTS_TIMEOUT_MS

no

300000

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

Available Tools

6 tools
buy_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 balanceA
Read-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 sizesA
Read-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 stylesA
Read-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

    A4.2/5.0

    Scored across 6 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    All tool names follow a consistent snake_case verb_noun pattern (list_*, generate_*, get_*, buy_*). No deviations or mixed conventions.

    Tool Count5/5

    Six tools cover the full workflow without redundancy: two lookups, one core action, one retrieval, and two billing helpers. Well-scoped for the service.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      An 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.
      6
      164 npm
      27
      MIT