appstore-mockup-mcp

An MCP server that wraps app screenshots in an iPhone 16 Pro frame with marketing text above, producing App Store-ready preview images (1284×2778, accepted for the 6.5" slot in App Store Connect).

Features

• Wraps any screenshot in a realistic iPhone 16 Pro frame (dark or silver)
• Adds bold headline + optional subtitle above the phone
• Vertical gradient or solid background
• Batch mode — process all screenshots in one call
• Theme picker built into the Claude conversation flow
• Warns if a source image is already a mockup (prevents phone-in-phone)

Installation

uvx appstore-mockup-mcp

Usage with Claude Code

Add to your .mcp.json:

{
  "mcpServers": {
    "appstore-mockup": {
      "command": "uvx",
      "args": ["appstore-mockup-mcp"]
    }
  }
}

Then in Claude Code, just share your screenshots and ask:

"Create App Store mockups for these screenshots"

Claude will ask you to pick a theme, propose captions, get your approval, then render everything.

Tools

create_iphone_mockup

Single screenshot → mockup.

create_iphone_mockups_batch

Same params, plus jobs list and output_dir. Each job can override any batch-level default.

CLI usage

python -m appstore_mockup_mcp.core screenshot.png \
  --title "Find any car in seconds" \
  --subtitle "Search 10,000+ vehicles" \
  --out preview.png \
  --frame dark \
  --bg-top "#f97316" --bg-bottom "#1a0a00" \
  --text-color "#ffffff"

Built-in themes

License

MIT