# storeshots-mcp

Builds App Store and Google Play screenshots from app screens, copy, and layout settings. Useful when store assets need several sizes or languages.

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

## What it does

storeshots-mcp turns raw app screens into store listing images for App Store and Google Play. It places screens in device frames, adds headlines and branded backgrounds, then renders the required dimensions. A `storeshots.json` file defines languages, presets, screen paths, and copy.

The MCP server can expose the renderer to an agent, while the same package provides a CLI. `storeshots init` creates the config, `storeshots build` renders the set, and `storeshots validate` checks files against store rules. iOS and Android presets, localized headlines, and a preview strip are supported. Rendering is local and deterministic, so a changed file can be redrawn on its own.

Node.js 18 or newer is required. No API keys are needed, but the MCP client must be able to run `npx`.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add storeshots-mcp -- npx -y storeshots-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add storeshots-mcp -- npx -y storeshots-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "storeshots-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "storeshots-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "storeshots-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "storeshots-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add storeshots-mcp npx -y storeshots-mcp
```

## When to use it
- build App Store and Google Play listing images
- place app screens inside device frames
- prepare headlines in several languages
- check output against store requirements
- assemble a preview strip from rendered images

## Example prompts
- Create `storeshots.json` from the files in `screenshots/`, with English and Turkish headlines.
- Render iOS and Android versions from `storeshots.json` using background `#E31837`.
- Validate the files in `output/` against App Store and Google Play rules.

## Similar
- [Next AI Draw.io](https://affpapa.org/en/nevibecode/mcp/next-ai-drawio.md) — MCP server · ★ 36398
- [tldraw](https://affpapa.org/en/nevibecode/mcp/tldraw.md) — MCP server · ★ 51091
- [Figma-Context-MCP](https://affpapa.org/en/nevibecode/mcp/figma-context-mcp.md) — MCP server · ★ 16062
- [Agent-Native Assets](https://affpapa.org/en/nevibecode/mcp/agent-native-assets.md) — MCP server · ★ 7506
- [Remove AI Watermarks](https://affpapa.org/en/nevibecode/mcp/remove-ai-watermarks.md) — MCP server · ★ 6114
- [Dembrandt](https://affpapa.org/en/nevibecode/mcp/dembrandt.md) — MCP server · ★ 3821

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