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 suggestions derived from the app's own colors, with a custom-color override

• Warns if a source image is already a mockup (prevents phone-in-phone)

Related MCP server: MCP Icon Generator

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.

suggest_themes

Takes a list of screenshot paths and returns theme suggestions derived from the app's own colors (JSON list of {name, bg_color, text_color, frame, why}).

Dynamic themes

Themes are derived from the app's own colors instead of fixed presets. The suggest_themes tool analyzes the screenshots' dominant background and accent colors and proposes:

Text color and frame are picked automatically for contrast. Claude presents the suggestions and always offers a custom option — supply your own bg_color (single hex or #hex1,#hex2 gradient), text_color, and frame if you don't like any of them.

License

MIT