{"protocolVersion":"2024-11-05","serverInfo":{"name":"magicscreenshots","version":"1.3.0"},"capabilities":{"tools":{"listChanged":false},"prompts":{"listChanged":false},"resources":{"subscribe":false,"listChanged":false}},"instructions":"MagicScreenshots is the library of real App Store screenshots, app preview posters, and in-app event photos: the top free and top-grossing apps in every Apple category, refreshed daily, with listing history. Use it as design inspiration, then generate the user's own screenshots in that style. A short search is free: 3 apps and 3 screenshots from the US listing. The rest of the library, other countries, similar apps, videos and history are Library Pro at $19 a month. Send Authorization: Bearer with a claimed key or a signed-in session that has Library Pro for the full search. Start with list_directory_apps (filter by category, look, chart or has_video), list_directory_categories or list_directory_tags, then get_directory_app / get_directory_screens. To generate your own screenshots: call create_api_key, look up the user's app with get_screenshots and live=true, then create_restyle. Copying a library app with inspiration_slug also needs Library Pro. Poll get_job_group until overview_url exists, ask the human to approve, then approve_restyle. Restyle and localize need the human to open claim_url, sign in, and pay. Generation is separate from the library plan. Directory screens are listing shots (1290×2796). Do not treat this catalog as in-app UI like Mobbin.","tools":[{"name":"create_api_key","title":"Create API key","description":"Create an agent API key without an account. A short library search is free. The rest of the library needs Library Pro, $19 a month, on a claimed key. Live App Store lookup of the user's own app works with the key. Restyle and localize require the human to open claim_url, sign in, and pay.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"inputSchema":{"type":"object","properties":{"name":{"type":"string","description":"Optional label for the key, such as the agent or chat name."}},"additionalProperties":false}},{"name":"list_directory_categories","title":"List directory categories","description":"List App Store screenshot directory categories (Finance, Food & Drink, Productivity, …) with app counts. Use this first when an agent wants inspiration by genre. A short search is free. The rest of the library is Library Pro, $19 a month.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","properties":{},"additionalProperties":false}},{"name":"list_directory_tags","title":"List directory tags","description":"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. A short search is free. The rest of the library is Library Pro, $19 a month.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","properties":{},"additionalProperties":false}},{"name":"list_directory_apps","title":"Search the screenshot library","description":"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. Without Library Pro this returns 3 apps. The rest is $19 a month.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"App name, developer, slug or Apple ID. Example: \"duolingo\"."},"category":{"type":"string","description":"Genre slug from list_directory_categories, such as finance or food-drink."},"tag":{"type":"string","description":"Listing-look slug from list_directory_tags, such as headline, device-frame or dark."},"chart":{"type":"string","enum":["free","grossing"],"description":"With category: order by today's top free or top grossing chart for that category."},"has_video":{"type":"boolean","description":"Only apps whose listing has an App Store preview video."},"platform":{"type":"string","enum":["ios","android"],"description":"ios (App Store) or android (Google Play). Default: both."},"limit":{"type":"integer","minimum":1,"maximum":100,"default":20},"offset":{"type":"integer","minimum":0,"default":0,"description":"For paging; count in the response is the total match count."}},"additionalProperties":false}},{"name":"get_directory_app","title":"Get directory app","description":"Get one directory app: metadata, ordered listing screenshots, app preview posters, and in-app event photos (as markdown images), related apps in the same genre, and the create_restyle arguments to copy that style. Without Library Pro this returns 3 screenshots. The rest, similar apps, and other countries are $19 a month.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","properties":{"slug":{"type":"string","description":"Directory slug such as duolingo, monzo, or doordash."},"app_id":{"type":"string","description":"Apple numeric app ID."},"query":{"type":"string","description":"App name if you do not have a slug."}},"additionalProperties":false}},{"name":"get_directory_screens","title":"Get directory screens","description":"Get the ordered App Store listing screenshots for a library app, including markdown images a vision model can inspect. Pass country (jp, de, ...) for that storefront's screenshots and in-app events. Index is 1-based and matches /apps/:slug/screens/:index. Without Library Pro this returns the first 3 US screenshots. Other countries and the rest are $19 a month.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","properties":{"slug":{"type":"string","description":"Directory slug such as duolingo."},"index":{"type":"integer","minimum":1,"description":"Optional 1-based screenshot index."},"country":{"type":"string","minLength":2,"maxLength":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."}},"required":["slug"],"additionalProperties":false}},{"name":"get_app_videos","title":"Get App Store preview videos","description":"App Store preview videos for a library app, including 1-hour download links to the mp4 files. Needs Library Pro, $19 a month. Pass slug from list_directory_apps.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","properties":{"slug":{"type":"string","description":"Library slug such as instagram."}},"required":["slug"],"additionalProperties":false}},{"name":"get_app_history","title":"Get listing history","description":"Every version of an app's App Store listing we have captured (screenshots and preview videos per date), newest first. Needs Library Pro, $19 a month.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","properties":{"slug":{"type":"string","description":"Library slug such as instagram."},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10}},"required":["slug"],"additionalProperties":false}},{"name":"get_magicscreenshots_site_summary","title":"Get site summary","description":"Return a concise summary of MagicScreenshots, the screenshot directory, public routes, MCP tools, and auth requirements.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","properties":{},"additionalProperties":false}},{"name":"get_magicscreenshots_markdown","title":"Get page markdown","description":"Fetch a markdown representation of a known MagicScreenshots public page.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"inputSchema":{"type":"object","required":["route"],"properties":{"route":{"type":"string","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"]}},"additionalProperties":false}},{"name":"get_magicscreenshots_discovery_document","title":"Get discovery document","description":"Fetch a known agent discovery document such as API catalog, Agent Skills, MCP, OAuth metadata, OpenAPI, or llms.txt.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"inputSchema":{"type":"object","required":["endpoint"],"properties":{"endpoint":{"type":"string","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"]}},"additionalProperties":false}},{"name":"list_magicscreenshots_languages","title":"List languages","description":"Return supported screenshot localization languages and public guide routes.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":50,"default":50}},"additionalProperties":false}},{"name":"list_magicscreenshots_markets","title":"List markets","description":"Return supported App Store market guides and public market routes.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","properties":{"region":{"type":"string","enum":["asia-pacific","europe","americas","middle-east"]},"limit":{"type":"integer","minimum":1,"maximum":100,"default":100}},"additionalProperties":false}},{"name":"get_screenshots","title":"Get screenshots","description":"Fetch high-resolution App Store screenshots. Directory shots return 3 screenshots without Library Pro. The rest of the listing is $19 a month. Pass live=true to look up the current App Store listing of the user's own app (API key required). Use get_directory_app when you already have a catalog slug.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"inputSchema":{"type":"object","properties":{"slug":{"type":"string","description":"Directory slug. Returns catalog screens without a live App Store lookup."},"app_url":{"type":"string","description":"Apple App Store URL."},"app_id":{"type":"string","description":"Apple numeric app ID."},"query":{"type":"string","description":"App name to search in the directory, then the App Store."},"country":{"type":"string","minLength":2,"maxLength":2,"default":"us"},"live":{"type":"boolean","default":false,"description":"Skip the directory and fetch the current App Store listing."}},"additionalProperties":false}},{"name":"create_restyle","title":"Create restyle","description":"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.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"inputSchema":{"type":"object","properties":{"source_app":{"type":"object","description":"The user's app. Use query, app_url, or app_id from get_screenshots.","properties":{"app_url":{"type":"string"},"app_id":{"type":"string"},"query":{"type":"string"},"country":{"type":"string"},"name":{"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."},"inspiration_app":{"type":"object","properties":{"slug":{"type":"string"},"app_url":{"type":"string"},"app_id":{"type":"string"},"query":{"type":"string"},"country":{"type":"string"},"name":{"type":"string"}},"additionalProperties":true},"source_screenshot_urls":{"type":"array","items":{"type":"string"}},"inspiration_screenshot_urls":{"type":"array","items":{"type":"string"}},"limit":{"type":"integer","minimum":1,"maximum":10,"default":5}},"required":["source_app"],"additionalProperties":false}},{"name":"create_localize","title":"Create localize","description":"Create MagicScreenshots localization jobs for source App Store screenshots across one or more target locales.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"inputSchema":{"type":"object","properties":{"source_app":{"type":"object","properties":{"app_url":{"type":"string"},"app_id":{"type":"string"},"query":{"type":"string"},"country":{"type":"string"},"name":{"type":"string"}},"additionalProperties":true},"source_screenshot_urls":{"type":"array","items":{"type":"string"}},"target_locales":{"type":"array","description":"Locale IDs such as JPN, DEU, FRA, BRA, or objects with language/country.","items":{"anyOf":[{"type":"string"},{"type":"object","properties":{"id":{"type":"string"},"language":{"type":"string"},"country":{"type":"string"}},"required":["language"],"additionalProperties":true}]}},"limit":{"type":"integer","minimum":1,"maximum":10,"default":5}},"required":["source_app","target_locales"],"additionalProperties":false}},{"name":"approve_restyle","title":"Approve restyle","description":"Approve a generated restyle overview and start final screenshot extraction.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"inputSchema":{"type":"object","required":["group_id"],"properties":{"group_id":{"type":"string"},"overview_url":{"type":"string"}},"additionalProperties":false}},{"name":"get_job_group","title":"Get job group","description":"Check restyle job group status, overview URL, errors, and final output URLs.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"inputSchema":{"type":"object","required":["group_id"],"properties":{"group_id":{"type":"string"}},"additionalProperties":false}},{"name":"list_results","title":"List results","description":"List recent MagicScreenshots restyle job groups and outputs for the authenticated account.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"inputSchema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":50,"default":20}},"additionalProperties":false}}],"prompts":[{"name":"find_inspiration","description":"Browse the MagicScreenshots directory for App Store listing styles in a category or by app name.","arguments":[{"name":"category","description":"Optional genre slug such as finance or food-drink.","required":false},{"name":"tag","description":"Optional listing-treatment slug such as headline or device-frame.","required":false},{"name":"query","description":"Optional app name to search for.","required":false}]},{"name":"restyle_like_app","description":"Restyle the user's screenshots to match a directory inspiration app, then poll until outputs are ready.","arguments":[{"name":"inspiration_slug","description":"Directory slug such as duolingo or monzo.","required":true},{"name":"source_app","description":"The user's app name or App Store URL.","required":true}]}],"resources":[],"resourceTemplates":[{"uriTemplate":"magicscreenshots://directory/apps/{slug}","name":"Directory app screenshot set","description":"One catalog app: listing screenshots, app preview posters, and in-app event photos.","mimeType":"application/json"},{"uriTemplate":"magicscreenshots://directory/apps/{slug}/screens/{index}","name":"Directory listing screenshot","description":"One 1-based listing screenshot from a catalog app.","mimeType":"application/json"},{"uriTemplate":"magicscreenshots://directory/tags/{slug}","name":"Directory listing-tag apps","description":"Catalog apps that use a listing treatment such as headline or device-frame.","mimeType":"application/json"}]}