MagicScreenshots for agents

Give your AI agent a library of real App Store screenshots and preview videos from thousands of top apps, updated daily, then let it generate and localize your own App Store screenshots.

• Library: the top 100 free and top-grossing apps in every Apple category, with screenshots, preview videos and listing history.
• Search by category, today's chart, look (dark, headline, device frame, lifestyle, ...) or app name.
• Generate: restyle your screenshots like any app in the library, or translate them into 40+ languages at App Store resolution.

Setup guides for every agent: https://www.magicscreenshots.com/agents

MCP endpoint (Streamable HTTP): https://www.magicscreenshots.com/api/mcp

Install

Searching needs no key. Generation, video downloads and listing history need an API key: ask your agent to call create_api_key, or create one in Settings > API on magicscreenshots.com, then set MAGICSCREENSHOTS_API_KEY.

Any agent with skills (Claude Code, Codex, Cursor, Cline, Windsurf, ...)

npx skills add Humanleap/magicscreenshots-mcp

This installs the skill only. Add the MCP server too (below) so the agent can call the tools.

Claude Code

Plugin (skill + MCP server):

/plugin marketplace add Humanleap/magicscreenshots-mcp
/plugin install magicscreenshots@magicscreenshots

Or just the MCP server:

claude mcp add --transport http magicscreenshots https://www.magicscreenshots.com/api/mcp \
  --header "Authorization: Bearer $MAGICSCREENSHOTS_API_KEY"

The plugin sends Authorization: Bearer ${MAGICSCREENSHOTS_API_KEY}. Set the variable before starting Claude Code. With no key set, search still works, but get_app_videos, get_app_history and generation return an auth error. For fully keyless use, delete the headers block from the plugin's .mcp.json.

Cursor

Install the plugin from the Cursor Marketplace, or add this to .cursor/mcp.json (project) or ~/.cursor/mcp.json:

{
  "mcpServers": {
    "magicscreenshots": {
      "url": "https://www.magicscreenshots.com/api/mcp",
      "headers": { "Authorization": "Bearer ${env:MAGICSCREENSHOTS_API_KEY}" }
    }
  }
}

Without MAGICSCREENSHOTS_API_KEY set, leave out headers (same reason as Claude Code above).

Codex

codex mcp add magicscreenshots --url https://www.magicscreenshots.com/api/mcp

For generation, set the key in config.toml:

[mcp_servers.magicscreenshots]
url = "https://www.magicscreenshots.com/api/mcp"
bearer_token_env_var = "MAGICSCREENSHOTS_API_KEY"

Gemini CLI

Extension (skill + MCP server, search tools):

gemini extensions install https://github.com/Humanleap/magicscreenshots-mcp

With a key:

gemini mcp add --transport http --header "Authorization: Bearer $MAGICSCREENSHOTS_API_KEY" \
  magicscreenshots https://www.magicscreenshots.com/api/mcp

Any other MCP client

{
  "mcpServers": {
    "magicscreenshots": {
      "type": "http",
      "url": "https://www.magicscreenshots.com/api/mcp",
      "headers": { "Authorization": "Bearer ms_live_..." }
    }
  }
}

Some clients call the URL field serverUrl (Windsurf) or httpUrl (Gemini). Leave out headers to use search only.

Command line

npx magic-screenshots search --category finance --chart grossing
npx magic-screenshots app duolingo
npx magic-screenshots screens duolingo --out ./reference
npx magic-screenshots videos instagram

Tools

Tool	Key	What it does
list_directory_apps	no	Search the library by text, category, look, chart, or apps with preview videos
list_directory_categories	no	Apple categories with app counts
list_directory_tags	no	Listing looks (headline, device-frame, dark, ...) with app counts
get_directory_app	no	One app: developer, chart ranks, looks, screenshots, video posters
get_directory_screens	no	Ordered screenshots as images your agent can look at
get_app_videos	Pro for files	Preview video posters; mp4 downloads with Pro
get_app_history	Pro	Past versions of a listing
create_api_key	no	Mint a key; you claim it in the browser
get_screenshots	for live lookup	Your app's current App Store screenshots
create_restyle	yes	Restyle your screenshots like a library app
create_localize	yes	Translate your screenshots into other languages
get_job_group, approve_restyle, list_results	yes	Follow and approve generation jobs

The skill in skills/magicscreenshots/SKILL.md tells the agent how to run an inspiration review, make App Store screenshots, localize, and study preview videos.

Pricing

• Free: search the library and view screenshots.
• Library Pro: $19, adds preview video downloads and listing history.
• Team: $49 per seat.
• Image credits: generation (restyle and localize) is paid per image.

Current prices: https://www.magicscreenshots.com/pricing

Legal

Screenshots and preview videos in the library belong to their developers. MagicScreenshots shows them for reference and research. Don't reuse them as your own App Store assets.

Maintaining

The web copy at public/.well-known/agent-skills/magicscreenshots/SKILL.md in the MagicScreenshots app repo is the source. Copy it here unchanged:

cp public/.well-known/agent-skills/magicscreenshots/SKILL.md kit/skills/magicscreenshots/SKILL.md

The app repo's scripts/agent-cli.test.mjs fails if the two copies differ or if the digest in agent-skills/index.json is stale.

License

MIT © Humanleap. See LICENSE.