# StoreShots

Renders raw app screenshots into store-ready marketing images for App Store and Google Play. Rendering runs on the service, so nothing is installed locally.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: qaimos
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qaimos/storeshots-mcp
- Updated: 2026-10-01
- HTML: https://affpapa.org/en/nevibecode/mcp/storeshots

## What it does

This is a small stdio server that proxies to the hosted StoreShots API. Your agent gets one to five screenshots, either local files or URLs, plus headlines, and the set comes back as PNGs or a ZIP saved into the project. No Chrome, no Puppeteer, no design app on your machine, because the image is assembled remotely.

Two discovery tools, `list_styles` and `list_devices`, spell out the available looks and device frames so you do not have to guess. The actual render is `generate_screenshots`, which takes style, device, target sizes, captions, app name and colour overrides; it hands back a `jobId`. Then `get_output` pulls the files into `output_dir`. Credits and remaining free sets are visible through `get_balance`, and `buy_credits` returns a Stripe payment link you open in a browser.

You need Node.js 18.17 or newer and a free `ss_...` key, shown only once at signup, so copy it right away. Missing `STORESHOTS_API_KEY` stops the server cold. Uploads travel over HTTPS and are deleted after 24 hours, and so are the outputs; download them before the window closes or `get_output` comes back empty.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `STORESHOTS_API_KEY`, `STORESHOTS_API_URL`, `STORESHOTS_OUTPUT_DIR` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env STORESHOTS_API_KEY=<STORESHOTS_API_KEY> --env STORESHOTS_API_URL=<STORESHOTS_API_URL> --env STORESHOTS_OUTPUT_DIR=<STORESHOTS_OUTPUT_DIR> --transport stdio storeshots -- npx -y storeshots-api-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add storeshots --env STORESHOTS_API_KEY=<STORESHOTS_API_KEY> --env STORESHOTS_API_URL=<STORESHOTS_API_URL> --env STORESHOTS_OUTPUT_DIR=<STORESHOTS_OUTPUT_DIR> -- npx -y storeshots-api-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "storeshots": {
            "command": "npx",
            "args": [
                "-y",
                "storeshots-api-mcp"
            ],
            "env": {
                "STORESHOTS_API_KEY": "<STORESHOTS_API_KEY>",
                "STORESHOTS_API_URL": "<STORESHOTS_API_URL>",
                "STORESHOTS_OUTPUT_DIR": "<STORESHOTS_OUTPUT_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "storeshots": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "storeshots-api-mcp"
            ],
            "env": {
                "STORESHOTS_API_KEY": "<STORESHOTS_API_KEY>",
                "STORESHOTS_API_URL": "<STORESHOTS_API_URL>",
                "STORESHOTS_OUTPUT_DIR": "<STORESHOTS_OUTPUT_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e STORESHOTS_API_KEY=<STORESHOTS_API_KEY> -e STORESHOTS_API_URL=<STORESHOTS_API_URL> -e STORESHOTS_OUTPUT_DIR=<STORESHOTS_OUTPUT_DIR> storeshots npx -y storeshots-api-mcp
```
Replace <…> with your own values

## When to use it
- turn raw app captures into App Store marketing screenshots
- get every required store size from a single call
- try an iPhone, iPad or Android frame on an existing screen
- attach headlines and captions to each slide
- drop a finished ZIP or PNG set into the project folder

## Example prompts
- List the available styles and device frames.
- Generate a set for `ios-6.9` and `android-phone` and download the PNGs to `./store-assets`.

## Similar
- [mobile-mcp](https://affpapa.org/en/nevibecode/mcp/mobile-mcp.md) — MCP server · ★ 10025
- [mobilerun](https://affpapa.org/en/nevibecode/mcp/mobilerun.md) — MCP server · ★ 9833
- [e2e](https://affpapa.org/en/nevibecode/mcp/e2e.md) — MCP server · ★ 11962
- [XcodeBuildMCP](https://affpapa.org/en/nevibecode/mcp/xcodebuildmcp.md) — MCP server · ★ 6511
- [ShipSwift](https://affpapa.org/en/nevibecode/mcp/shipswift.md) — MCP server · ★ 3244
- [agent-device](https://affpapa.org/en/nevibecode/mcp/agent-device.md) — MCP server · ★ 5158

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md