io.github.HumanleapPublished by GitHub account Humanleapv1.3.0Updated Oct 24, 2026
Search real App Store screenshots and preview videos; generate and localize your own.
A remote MCP server that lets an assistant search real App Store screenshots and preview videos, then generate and localize the user's own App Store screenshots
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.Humanleap%2Fmagicscreenshots-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"magicscreenshots": {
"type": "http",
"url": "https://www.magicscreenshots.com/api/mcp"
}
}
}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.
Setup guides for every agent: https://www.magicscreenshots.com/agents
MCP endpoint (Streamable HTTP): https://www.magicscreenshots.com/api/mcp
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.
This installs the skill only. Add the MCP server too (below) so the agent can call the tools.
Plugin (skill + MCP server):
Or just the MCP server:
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.
Install the plugin from the Cursor Marketplace, or add this to
.cursor/mcp.json (project) or ~/.cursor/mcp.json:
Without MAGICSCREENSHOTS_API_KEY set, leave out headers (same reason as
Claude Code above).
For generation, set the key in config.toml:
Extension (skill + MCP server, search tools):
With a key:
Some clients call the URL field serverUrl (Windsurf) or httpUrl (Gemini).
Leave out headers to use search only.
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.
Current prices: https://www.magicscreenshots.com/pricing
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.
The web copy at public/.well-known/agent-skills/magicscreenshots/SKILL.md in
the MagicScreenshots app repo is the source. Copy it here unchanged:
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.
MIT © Humanleap. See LICENSE.
Source: README.md at commit 2775a38
Create API key
Create an agent API key without an account. Directory browse works with no key. Screenshot lookup works immediately with the key. Restyle and localize require the human to open claim_url, sign in, and pay.
nameList directory categories
List App Store screenshot directory categories (Finance, Food & Drink, Productivity, …) with app counts. Use this first when an agent wants inspiration by genre. No API key required.
Takes no parameters.
List directory tags
List listing-screenshot treatments (headline, device-frame, lifestyle, dark, character, social-proof, …) with app counts. These are App Store creative tags, not in-app UI patterns. No API key required.
Takes no parameters.
Search the screenshot library
Search thousands of real App Store listings (the top 100 free and top-grossing apps in every Apple category, refreshed daily). Filter by text, Apple genre slug, listing look (tag), today's chart rank, or apps that have preview videos. Returns slugs for get_directory_app, get_app_videos, get_app_history and create_restyle. No API key required.
tagchartlimitqueryoffsetcategoryplatformhas_videoGet directory app
Get one directory app: metadata, ordered listing screenshot URLs (as markdown images), related apps in the same genre, and the create_restyle arguments to copy that style. No API key required.
slugqueryapp_idGet directory screens
Get the ordered App Store listing screenshots for a library app, including markdown images a vision model can inspect. Pass country (jp, de, ...) for the localized listing in that storefront. Index is 1-based and matches /apps/:slug/screens/:index. No API key required.
slugrequiredindexcountryGet App Store preview videos
App Store preview videos for a library app: poster frames for everyone; with a Pro API key, 1-hour download links to the mp4 files (about 30 s each). Use them as reference when making your own app preview video. Pass slug from list_directory_apps (has_video=true finds apps that have them).
slugrequiredGet listing history
Every version of an app's App Store listing we have captured (screenshots and preview videos per date), newest first. Shows how top apps change their creative over time. Needs a Pro API key; without one it returns how many versions exist.
slugrequiredlimitGet site summary
Return a concise summary of MagicScreenshots, the screenshot directory, public routes, MCP tools, and auth requirements.
Takes no parameters.
Get page markdown
Fetch a markdown representation of a known MagicScreenshots public page.
routerequiredGet discovery document
Fetch a known agent discovery document such as API catalog, Agent Skills, MCP, OAuth metadata, OpenAPI, or llms.txt.
endpointrequiredList languages
Return supported screenshot localization languages and public guide routes.
limitList markets
Return supported App Store market guides and public market routes.
limitregionGet screenshots
Fetch high-resolution App Store screenshots. If the app is in the MagicScreenshots directory, returns those curated listing shots (with markdown images) with no API key. Otherwise looks up the live App Store listing (API key required). Pass live=true to skip the directory. Use this for the user's own app; use get_directory_app when you already have a catalog slug.
liveslugqueryapp_idapp_urlcountryCreate restyle
Restyle the user's App Store screenshots to match a directory inspiration set. Prefer inspiration_slug from list_directory_apps (duolingo, monzo, doordash, …). Requires an API key; the human must claim the key and pay before generation runs.
limitsource_apprequiredinspiration_appinspiration_slugsource_screenshot_urlsinspiration_screenshot_urlsCreate localize
Create MagicScreenshots localization jobs for source App Store screenshots across one or more target locales.
limitsource_apprequiredtarget_localesrequiredsource_screenshot_urlsApprove restyle
Approve a generated restyle overview and start final screenshot extraction.
group_idrequiredoverview_urlGet job group
Check restyle job group status, overview URL, errors, and final output URLs.
group_idrequiredList results
List recent MagicScreenshots restyle job groups and outputs for the authenticated account.
limit100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
npx skills add Humanleap/magicscreenshots-mcp/plugin marketplace add Humanleap/magicscreenshots-mcp/plugin install magicscreenshots@magicscreenshotsclaude mcp add --transport http magicscreenshots https://www.magicscreenshots.com/api/mcp \ --header "Authorization: Bearer $MAGICSCREENSHOTS_API_KEY"{ "mcpServers": { "magicscreenshots": { "url": "https://www.magicscreenshots.com/api/mcp", "headers": { "Authorization": "Bearer ${env:MAGICSCREENSHOTS_API_KEY}" } } }}codex mcp add magicscreenshots --url https://www.magicscreenshots.com/api/mcp[mcp_servers.magicscreenshots]url = "https://www.magicscreenshots.com/api/mcp"bearer_token_env_var = "MAGICSCREENSHOTS_API_KEY"gemini extensions install https://github.com/Humanleap/magicscreenshots-mcpgemini mcp add --transport http --header "Authorization: Bearer $MAGICSCREENSHOTS_API_KEY" \ magicscreenshots https://www.magicscreenshots.com/api/mcp{ "mcpServers": { "magicscreenshots": { "type": "http", "url": "https://www.magicscreenshots.com/api/mcp", "headers": { "Authorization": "Bearer ms_live_..." } } }}npx magic-screenshots search --category finance --chart grossingnpx magic-screenshots app duolingonpx magic-screenshots screens duolingo --out ./referencenpx magic-screenshots videos instagramcp public/.well-known/agent-skills/magicscreenshots/SKILL.md kit/skills/magicscreenshots/SKILL.md