Skip to main content
MCPv0.1.3

MCP Server

Let your AI agent generate App Store screenshots as a native tool. Works with Claude Code, Cursor, Windsurf, and any MCP-compatible client.


What is MCP?

The Model Context Protocol is an open standard that lets AI agents use external tools natively. Instead of the agent reading API docs and making HTTP calls manually, it discovers your tools automatically and calls them like built-in functions.

With the AppScreenshotStudio MCP server installed, you can say “generate App Store screenshots for my app” and your agent handles everything — project creation, design generation, and rendering.


Prerequisites

  • Node.js 18 or later
  • An AppScreenshotStudio account with credits
  • An API key — create one in Settings → API Keys

Installation

Claude Code

Run this in your terminal:

claude mcp add appscreenshotstudio -- npx -y @appscreenshotstudio/mcp

Then set your API key as an environment variable. Add to your shell profile (.bashrc, .zshrc, etc.):

export APPSCREENSHOTSTUDIO_API_KEY="sk_live_your_key_here"

Cursor / Windsurf / Other MCP Clients

Add this to your MCP configuration file (.cursor/mcp.json, settings.json, etc.):

{
  "mcpServers": {
    "appscreenshotstudio": {
      "command": "npx",
      "args": ["-y", "@appscreenshotstudio/mcp"],
      "env": {
        "APPSCREENSHOTSTUDIO_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Tools

The server exposes 6 tools that your agent discovers automatically.

generate-screenshots

1 credit

Create a complete set of App Store screenshots. Combines project creation and design generation in one call. Returns a project URL where you upload device screenshots and export final PNGs.

ParameterTypeDescription
app_name*stringName of the app
app_description*stringWhat the app does (1-3 sentences)
featuresstring[]Key features in order of importance (max 10)
brand_colorsobject{ primary, secondary?, accent? } — hex colors
moodstring"energetic", "calm", "minimal", "bold", "professional", "playful"
device_idstringTarget device (default: iphone-6.9)
countnumberNumber of cards, 3-10 (default: 5)
story_flowstring"auto", "standard", "problem-solution", "benefit-first", "hero-intro", etc.

Example prompt

Generate App Store screenshots for my todo app called TaskFlow. It helps people organize tasks with smart due dates. Brand color is #7C3AED. Make 5 cards.

edit-screenshots

1 credit

Make changes to an existing project using natural language. Use for follow-up refinements. Optionally target specific cards.

ParameterTypeDescription
project_id*stringFrom a previous generate call
message*stringWhat to change
card_indicesnumber[]Target specific cards by index (0-based). If omitted, all cards are editable.

Example prompt

Make the headlines bigger and add a star rating to card 1.

render-screenshots

Free

Export a project to high-resolution PNGs. Returns download URLs for each card. Free — no credit cost.

ParameterTypeDescription
project_id*stringProject to render

Example prompt

Render the TaskFlow screenshots to PNGs.

get-project

Free

Retrieve a project's current state — cards, elements, backgrounds, device mockups, and metadata. Use to inspect what's been generated before making edits.

ParameterTypeDescription
project_id*stringProject ID to retrieve

Example prompt

Show me the current state of the TaskFlow project.

generate-background

1 credit

Generate an AI background for a specific card. Uses project metadata (brand colors, mood, theme) for contextual results. The background is applied directly to the card.

ParameterTypeDescription
project_id*stringProject containing the card
card_index*numberWhich card to apply the background to (0-based)
prompt*stringDescription of the background you want

Example prompt

Generate a dark gradient background with purple accents for card 0.

list-devices

Free

Show all supported device specs. No API call or credits needed.

Example prompt

What devices does AppScreenshotStudio support?


Typical Workflow

1

Generate

Tell your agent about your app. It calls generate-screenshots and creates a full set of screenshot designs with headlines, backgrounds, and device mockups.

2

Iterate

Ask for changes. The agent calls edit-screenshots to refine colors, headlines, layout, or story flow.

3

Upload

Open the project URL in your browser and upload your actual app screenshots into the device mockups.

4

Export

The agent calls render-screenshots to export final PNGs, or click “Download All” in the web app.


Supported Devices

Pass any of these as device_id when generating screenshots.

Device IDNameSizeStore
iphone-6.9iPhone 16 Pro Max1260 × 2736Required
ipad-13iPad Pro 13"2064 × 2752Required
android-phoneAndroid Phone1080 × 2340Required
android-tablet-10Android Tablet 10"2560 × 1600Required

Security

  • API key stays on your machine — passed via environment variable, never sent to the MCP client
  • All API calls use HTTPS
  • stdio transport — the server runs as a local subprocess, no network ports opened
  • Revoke keys anytime in Settings

Resources