Search / io.github.Humanleap/magicscreenshots-mcp
MagicScreenshots
R0· no sign-inSearch real App Store screenshots and preview videos; generate and localize your own.
v1.3.0 · active · repository · website · descriptor JSON · versions
Search / io.github.Humanleap/magicscreenshots-mcp
R0· no sign-inSearch real App Store screenshots and preview videos; generate and localize your own.
v1.3.0 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"magicscreenshots-mcp": {
"type": "http",
"url": "https://www.magicscreenshots.com/api/mcp",
"headers": {
"Authorization": "Bearer ${MAGICSCREENSHOTS_MCP_TOKEN}"
}
}
}
}claude mcp add --transport http magicscreenshots-mcp https://www.magicscreenshots.com/api/mcp --header "Authorization: Bearer ${MAGICSCREENSHOTS_MCP_TOKEN}"[mcp_servers.magicscreenshots-mcp]
url = "https://www.magicscreenshots.com/api/mcp"
bearer_token_env_var = "MAGICSCREENSHOTS_MCP_TOKEN"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"magicscreenshots-mcp": {
"type": "remote",
"url": "https://www.magicscreenshots.com/api/mcp",
"enabled": true,
"headers": {
"Authorization": "Bearer {env:MAGICSCREENSHOTS_MCP_TOKEN}"
}
}
}
}{
"mcpServers": {
"magicscreenshots-mcp": {
"type": "http",
"url": "https://www.magicscreenshots.com/api/mcp",
"headers": {
"Authorization": "Bearer ${MAGICSCREENSHOTS_MCP_TOKEN}"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=magicscreenshots-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vd3d3Lm1hZ2ljc2NyZWVuc2hvdHMuY29tL2FwaS9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgJHtNQUdJQ1NDUkVFTlNIT1RTX01DUF9UT0tFTn0ifX0%3D"
}{
"servers": {
"magicscreenshots-mcp": {
"type": "http",
"url": "https://www.magicscreenshots.com/api/mcp",
"headers": {
"Authorization": "Bearer ${MAGICSCREENSHOTS_MCP_TOKEN}"
}
}
}
}{
"mcpServers": {
"magicscreenshots-mcp": {
"httpUrl": "https://www.magicscreenshots.com/api/mcp",
"headers": {
"Authorization": "Bearer ${MAGICSCREENSHOTS_MCP_TOKEN}"
}
}
}
}extensions:
"magicscreenshots-mcp":
enabled: true
name: "magicscreenshots-mcp"
type: streamable_http
uri: "https://www.magicscreenshots.com/api/mcp"
headers:
"Authorization": "Bearer ${MAGICSCREENSHOTS_MCP_TOKEN}"
timeout: 300
Placeholders to fill from your own secret store: ${MAGICSCREENSHOTS_MCP_TOKEN}. The registry never accepts secret values.
protocol.modernnewest supported version is 2024-11-05; 2026-07-28 not supported, older versions are deprecated until 2027-07-28protocol.statelessonly applies to 2026-07-28 serversprotocol.transportstreamable HTTPprotocol.list_ttlonly applies to 2026-07-28 serversauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_lengthdescriptions are concisetools.schemasevery tool has an object input schematools.annotations19 of 19 tools declare readOnlyHint or destructiveHinttools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHinttools.token_costabout 2,939 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changesno tool changes in 30 daysstability.rug_pullno tool changed its meaning under the same namedeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packageNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +website +reachable +uptime-100% +updated-22d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://www.magicscreenshots.com/api/mcp streamable-http | none | yes | 100% | 1698 ms | 2024-11-05 | 2026-10-19 |
approve_restyle | Approve a generated restyle overview and start final screenshot extraction. |
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. |
create_localize | Create MagicScreenshots localization jobs for source App Store screenshots across one or more target locales. |
create_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. |
get_app_historyread-only | 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. |
get_app_videosread-only | 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). |
get_directory_appread-only | 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. |
get_directory_screensread-only | 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. |
get_job_groupread-only | Check restyle job group status, overview URL, errors, and final output URLs. |
get_magicscreenshots_discovery_documentread-only | Fetch a known agent discovery document such as API catalog, Agent Skills, MCP, OAuth metadata, OpenAPI, or llms.txt. |
get_magicscreenshots_markdownread-only | Fetch a markdown representation of a known MagicScreenshots public page. |
get_magicscreenshots_site_summaryread-only | Return a concise summary of MagicScreenshots, the screenshot directory, public routes, MCP tools, and auth requirements. |
get_screenshotsread-only | 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. |
list_directory_appsread-only | 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. |
list_directory_categoriesread-only | 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. |
list_directory_tagsread-only | 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. |
list_magicscreenshots_languagesread-only | Return supported screenshot localization languages and public guide routes. |
list_magicscreenshots_marketsread-only | Return supported App Store market guides and public market routes. |
list_resultsread-only | List recent MagicScreenshots restyle job groups and outputs for the authenticated account. |
Schemas: list_tools.
{
"name": "io.github.Humanleap/magicscreenshots-mcp",
"icons": [
{
"src": "https://www.magicscreenshots.com/favicon-512x512.png",
"sizes": [
"512x512"
],
"mimeType": "image/png"
}
],
"title": "MagicScreenshots",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://www.magicscreenshots.com/api/mcp",
"type": "streamable-http",
"headers": [
{
"name": "Authorization",
"isSecret": true,
"description": "Bearer ms_live_... API key. Only needed for generation, video downloads and listing history; get one with create_api_key."
}
]
}
],
"version": "1.3.0",
"repository": {
"url": "https://github.com/Humanleap/magicscreenshots-mcp",
"source": "github"
},
"websiteUrl": "https://www.magicscreenshots.com/agents",
"description": "Search real App Store screenshots and preview videos; generate and localize your own."
}