@appscreen/mcp

MCP server for AppScreen — generate App Store / Play Store screenshots from any MCP-capable agent (Claude Desktop, Claude Code, Cursor, Continue, etc.).

Install

# Latest, no install — recommended for end users
npx -y @appscreen/mcp

Configure (Claude Desktop)

~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "appscreen": {
      "command": "npx",
      "args": ["-y", "@appscreen/mcp"],
      "env": {
        "APPSCREEN_API_KEY": "mcm_live_…"
      }
    }
  }
}

Omit APPSCREEN_API_KEY for anonymous use (5 lifetime renders, then sign-up required).

Tools

• render_screenshots — Accepts screens (layout JSON) and image files. Returns a jobId (keyed/async) or a download link (anon/inline). Free anon use capped at 5 lifetime.
• get_render_status — Polls a jobId. Returns status + signed download URL when done.

Pass images by path, not base64

The server runs locally, so give it a file path — it reads the bytes off disk. Do not base64-encode real screenshots into the call: an LLM emitting an 18k–90k-char base64 string drops a character partway down and the PNG renders black below it.

"files": [
  { "name": "1.png", "path": "~/app/screenshots/home.png" },   // ✅ preferred
  { "name": "2.png", "path": "/abs/path/settings.png" }
]
// base64 is accepted only for tiny synthetic test images:
// { "name": "x.png", "base64": "iVBORw0KG..." }

Bundle download URLs are signed and expire after ~1h. Re-poll to refresh.

Quota

Every tool response includes _meta.quota = {used, cap, tier, resetAt}. When quota drops below 20% or hits zero, the response also includes _meta.upgradeUrl and a nudge message in the text content.

Environment

| Var | Purpose | |---|---| | APPSCREEN_API_KEY | Optional. MCP key (mcm_live_…) from https://appscreen.co/account/keys. Free tier OK. Not the same as the programmatic ask_live_… API key. | | APPSCREEN_BASE_URL | Override API URL. Defaults to https://api.appscreen.co. | | APPSCREEN_MCP_CLIENT | Override client identifier (auto-detected from MCP initialize). |

License

MIT