MCP Server
MagicScreenshots
io.github.Humanleap/magicscreenshots-mcp
What this MCP does
Searches App Store screenshot references and preview videos, and supports screenshot restyling and localization jobs.
Capabilities
Tools
19
tools
approve_restyle
Approve restyle
Approve a generated restyle overview and start final screenshot extraction.
Open world
Input schema
{'type': 'object', 'required': ['group_id'], 'properties': {'group_id': {'type': 'string'}, 'overview_url': {'type': 'string'}}, 'additionalProperties': False}
create_api_key
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.
Open world
Input schema
{'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Optional label for the key, such as the agent or chat name.'}}, 'additionalProperties': False}
create_localize
Create localize
Create MagicScreenshots localization jobs for source App Store screenshots across one or more target locales.
Open world
Input schema
{'type': 'object', 'required': ['source_app', 'target_locales'], 'properties': {'limit': {'type': 'integer', 'default': 5, 'maximum': 10, 'minimum': 1}, 'source_app': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'query': {'type': 'string'}, 'app_id': {'type': 'string'}, 'app_url': {'type': 'string'}, 'country': {'type': 'string'}}, 'additionalProperties': True}, 'target_locales': {'type': 'array', 'items': {'anyOf': [{'type': 'string'}, {'type': 'object', 'required': ['language'], 'properties': {'id': {'type': 'string'}, 'country': {'type': 'string'}, 'language': {'type': 'string'}}, 'additionalProperties': True}]}, 'description': 'Locale IDs such as JPN, DEU, FRA, BRA, or objects with language/country.'}, 'source_screenshot_urls': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}
create_restyle
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.
Open world
Input schema
{'type': 'object', 'required': ['source_app'], 'properties': {'limit': {'type': 'integer', 'default': 5, 'maximum': 10, 'minimum': 1}, 'source_app': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'query': {'type': 'string'}, 'app_id': {'type': 'string'}, 'app_url': {'type': 'string'}, 'country': {'type': 'string'}}, 'description': "The user's app. Use query, app_url, or app_id from get_screenshots.", 'additionalProperties': True}, 'inspiration_app': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'query': {'type': 'string'}, 'app_id': {'type': 'string'}, 'app_url': {'type': 'string'}, 'country': {'type': 'string'}}, 'additionalProperties': True}, 'inspiration_slug': {'type': 'string', 'description': 'Directory slug from list_directory_apps / get_directory_app. Preferred over a free-text inspiration query.'}, 'source_screenshot_urls': {'type': 'array', 'items': {'type': 'string'}}, 'inspiration_screenshot_urls': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}
get_app_history
Get 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.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Library slug such as instagram.'}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1}}, 'additionalProperties': False}
get_app_videos
Get 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).
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Library slug such as instagram.'}}, 'additionalProperties': False}
get_directory_app
Get 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.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'slug': {'type': 'string', 'description': 'Directory slug such as duolingo, monzo, or doordash.'}, 'query': {'type': 'string', 'description': 'App name if you do not have a slug.'}, 'app_id': {'type': 'string', 'description': 'Apple numeric app ID.'}}, 'additionalProperties': False}
get_directory_screens
Get 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.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Directory slug such as duolingo.'}, 'index': {'type': 'integer', 'minimum': 1, 'description': 'Optional 1-based screenshot index.'}, 'country': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': '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.'}}, 'additionalProperties': False}
get_job_group
Get job group
Check restyle job group status, overview URL, errors, and final output URLs.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'required': ['group_id'], 'properties': {'group_id': {'type': 'string'}}, 'additionalProperties': False}
get_magicscreenshots_discovery_document
Get discovery document
Fetch a known agent discovery document such as API catalog, Agent Skills, MCP, OAuth metadata, OpenAPI, or llms.txt.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'required': ['endpoint'], 'properties': {'endpoint': {'enum': ['/.well-known/api-catalog', '/.well-known/agent-skills/index.json', '/.well-known/mcp/server-card.json', '/.well-known/oauth-protected-resource', '/.well-known/openid-configuration', '/.well-known/oauth-authorization-server', '/openapi.json', '/llms.txt'], 'type': 'string'}}, 'additionalProperties': False}
get_magicscreenshots_markdown
Get page markdown
Fetch a markdown representation of a known MagicScreenshots public page.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'required': ['route'], 'properties': {'route': {'enum': ['/', '/apps', '/studio', '/localize-app-store-screenshots', '/restyle-app-store-screenshots', '/ai-app-store-screenshot-generator', '/best-app-store-screenshot-localization-tools', '/how-to-translate-app-store-screenshots', '/languages', '/markets', '/categories', '/top', '/pricing', '/agents', '/tags', '/mcp', '/mcp/docs', '/faq', '/legal'], 'type': 'string'}}, 'additionalProperties': False}
get_magicscreenshots_site_summary
Get site summary
Return a concise summary of MagicScreenshots, the screenshot directory, public routes, MCP tools, and auth requirements.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
get_screenshots
Get 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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'properties': {'live': {'type': 'boolean', 'default': False, 'description': 'Skip the directory and fetch the current App Store listing.'}, 'slug': {'type': 'string', 'description': 'Directory slug. Returns catalog screens without a live App Store lookup.'}, 'query': {'type': 'string', 'description': 'App name to search in the directory, then the App Store.'}, 'app_id': {'type': 'string', 'description': 'Apple numeric app ID.'}, 'app_url': {'type': 'string', 'description': 'Apple App Store URL.'}, 'country': {'type': 'string', 'default': 'us', 'maxLength': 2, 'minLength': 2}}, 'additionalProperties': False}
list_directory_apps
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.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'tag': {'type': 'string', 'description': 'Listing-look slug from list_directory_tags, such as headline, device-frame or dark.'}, 'chart': {'enum': ['free', 'grossing'], 'type': 'string', 'description': "With category: order by today's top free or top grossing chart for that category."}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1}, 'query': {'type': 'string', 'description': 'App name, developer, slug or Apple ID. Example: "duolingo".'}, 'offset': {'type': 'integer', 'default': 0, 'minimum': 0, 'description': 'For paging; count in the response is the total match count.'}, 'category': {'type': 'string', 'description': 'Genre slug from list_directory_categories, such as finance or food-drink.'}, 'platform': {'enum': ['ios', 'android'], 'type': 'string', 'description': 'ios (App Store) or android (Google Play). Default: both.'}, 'has_video': {'type': 'boolean', 'description': 'Only apps whose listing has an App Store preview video.'}}, 'additionalProperties': False}
list_directory_categories
List 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.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
list_directory_tags
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.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
list_magicscreenshots_languages
List languages
Return supported screenshot localization languages and public guide routes.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 50, 'maximum': 50, 'minimum': 1}}, 'additionalProperties': False}
list_magicscreenshots_markets
List markets
Return supported App Store market guides and public market routes.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 100, 'maximum': 100, 'minimum': 1}, 'region': {'enum': ['asia-pacific', 'europe', 'americas', 'middle-east'], 'type': 'string'}}, 'additionalProperties': False}
list_results
List results
List recent MagicScreenshots restyle job groups and outputs for the authenticated account.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1}}, 'additionalProperties': False}
History
Recent tool changes
Added
list_results
Sept. 28, 2026, 2:40 a.m.
Added
get_job_group
Sept. 28, 2026, 2:40 a.m.
Added
approve_restyle
Sept. 28, 2026, 2:40 a.m.
Added
create_localize
Sept. 28, 2026, 2:40 a.m.
Added
create_restyle
Sept. 28, 2026, 2:40 a.m.
Added
get_screenshots
Sept. 28, 2026, 2:40 a.m.
Added
list_magicscreenshots_markets
Sept. 28, 2026, 2:40 a.m.
Added
list_magicscreenshots_languages
Sept. 28, 2026, 2:40 a.m.
Added
get_magicscreenshots_discovery_document
Sept. 28, 2026, 2:40 a.m.
Added
get_magicscreenshots_markdown
Sept. 28, 2026, 2:40 a.m.
Added
get_magicscreenshots_site_summary
Sept. 28, 2026, 2:40 a.m.
Added
get_app_history
Sept. 28, 2026, 2:40 a.m.
Added
get_app_videos
Sept. 28, 2026, 2:40 a.m.
Added
get_directory_screens
Sept. 28, 2026, 2:40 a.m.
Added
get_directory_app
Sept. 28, 2026, 2:40 a.m.
Added
list_directory_apps
Sept. 28, 2026, 2:40 a.m.
Added
list_directory_tags
Sept. 28, 2026, 2:40 a.m.
Added
list_directory_categories
Sept. 28, 2026, 2:40 a.m.
Added
create_api_key
Sept. 28, 2026, 2:40 a.m.
Discover
Similar MCP servers
ai-content-drop
com.aicontentdrop/ai-content-drop
Generates AI images, videos, UGC clips, avatars, and finished ads, while organizing creative assets and campaign boards.
Siren
ai.mysiren/siren
Plans, renders, and posts on-brand visual marketing campaigns.
Picorn
io.github.cueqzapper/picorn
Creates and edits layered social images, videos, slideshows, vector assets, and marketing projects with persistent editable canva…
Create Web Page
com.create-web-page/create-web-page
Creates, edits, previews, publishes, and manages hosted link-in-bio and landing pages with configurable content blocks, themes, m…
Postclick by PPC.io: Landing Page CRO
io.ppc/postclick-landing-page-cro
Audits landing pages, analyzes buyers and objections, generates copy and design concepts, builds HTML pages, and exports or share…
WebZum - The Hosting Layer for AI-Generated Web Content
io.github.suprraz/webzum
Creates, edits, clones, and hosts live HTML/CSS/JS websites, including SEO-focused business and lead-generation pages.
Dali by Lulu
io.github.Lulu-The-Narwhal/dali
Scores and improves creative prompts and advertising images using generation-target analysis, community patterns, performance ben…
uxgen
ai.uxgen/ecommerce-conversion
Audits and assembles ecommerce pages, generates product imagery and packshots, supports Shopify sections, and provides SEO and co…