io.github.Humanleap/magicscreenshots-mcp

MagicScreenshots

Search real App Store screenshots and preview videos; generate and localize your own.

1.3.0
Version
remote
Transport
19
Tools

Security review

Review passed

Reviewed 1d ago.

  • tools: 19 tools scanned
  • metadata: scanned

No findings.

Tools (19)

  • 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.

  • 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.

  • 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.

  • list_directory_apps

    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.

  • 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.

  • 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.

  • get_app_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).

  • get_app_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.

  • get_magicscreenshots_site_summary

    Return a concise summary of MagicScreenshots, the screenshot directory, public routes, MCP tools, and auth requirements.

  • get_magicscreenshots_markdown

    Fetch a markdown representation of a known MagicScreenshots public page.

  • get_magicscreenshots_discovery_document

    Fetch a known agent discovery document such as API catalog, Agent Skills, MCP, OAuth metadata, OpenAPI, or llms.txt.

  • list_magicscreenshots_languages

    Return supported screenshot localization languages and public guide routes.

  • list_magicscreenshots_markets

    Return supported App Store market guides and public market routes.

  • 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.

  • 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.

  • create_localize

    Create MagicScreenshots localization jobs for source App Store screenshots across one or more target locales.

  • approve_restyle

    Approve a generated restyle overview and start final screenshot extraction.

  • get_job_group

    Check restyle job group status, overview URL, errors, and final output URLs.

  • list_results

    List recent MagicScreenshots restyle job groups and outputs for the authenticated account.