Humanleap MagicScreenshots MCP Server

This MCP server provides capabilities to search real App Store screenshots and preview videos. It also supports generating and localizing screenshots for your own content, based on the server’s described functionality.

🛠️ Key Features

Search real App Store screenshots
Search App Store preview videos
Generate your own screenshots
Localize generated screenshots

🚀 Use Cases

Find authentic App Store visual examples via search
Review preview video assets associated with App Store listings
Create custom screenshots for your application
Produce localized versions of generated screenshots

⚡ Developer Benefits

Combines discovery (search) with production (generate and localize) for App Store creatives
Helps developers work with screenshots and preview video assets in the same workflow

⚠️ Limitations

Functionality is limited to searching App Store screenshots/preview videos and generating/localizing screenshots, per the provided description.

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):

code

/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:

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:

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

json

{
  "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.

query	string	optional	App name, developer, slug or Apple ID. Example: "duolingo".
category	string	optional	Genre slug from list_directory_categories, such as finance or food-drink.
tag	string	optional	Listing-look slug from list_directory_tags, such as headline, device-frame or dark.
chart	string	optional	With category: order by today's top free or top grossing chart for that category.
has_video	boolean	optional	Only apps whose listing has an App Store preview video.
platform	string	optional	ios (App Store) or android (Google Play). Default: both.
limit	integer	optional
offset	integer	optional	For paging; count in the response is the total match count.

slug	string	optional	Directory slug such as duolingo, monzo, or doordash.
app_id	string	optional	Apple numeric app ID.
query	string	optional	App name if you do not have a slug.

slug	string	required	Directory slug such as duolingo.
index	integer	optional	Optional 1-based screenshot index.
country	string	optional	App Store country for the localized listing, e.g. jp, de, fr, kr, cn, br, es, it, sa. Default us. get_directory_app lists which storefronts exist.

slug	string	required	Library slug such as instagram.
limit	integer	optional

region	string	optional
limit	integer	optional

source_app	object	required	The user's app. Use query, app_url, or app_id from get_screenshots.
inspiration_slug	string	optional	Directory slug from list_directory_apps / get_directory_app. Preferred over a free-text inspiration query.
inspiration_app	object	optional
source_screenshot_urls	array	optional
inspiration_screenshot_urls	array	optional
limit	integer	optional

Humanleap MagicScreenshots MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

create_api_key

list_directory_categories

list_directory_tags

list_directory_apps

get_directory_app

get_directory_screens

get_app_videos

get_app_history

get_magicscreenshots_site_summary

get_magicscreenshots_markdown

get_magicscreenshots_discovery_document

list_magicscreenshots_languages

list_magicscreenshots_markets

get_screenshots

create_restyle

create_localize

approve_restyle

get_job_group

list_results

MagicScreenshots for agents

Install

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

Claude Code

Cursor

Codex

Gemini CLI

Any other MCP client

Command line

Tools

Pricing

Legal

Maintaining

License

Install

Remote endpoint

Related servers