MagicScreenshots

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "MagicScreenshots": {
      "url": "https://www.magicscreenshots.com/api/mcp",
      "transport": "streamable-http"
    }
  }
}

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

  Parameters:

  • name — string — Optional label for the key, such as the agent or chat name.

  Hints: read-only no · destructive no · idempotent no · open-world yes

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

  Hints: read-only yes · destructive no · idempotent yes · open-world no

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

  Hints: read-only yes · destructive no · idempotent yes · open-world no

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

  Parameters:

  • tag — string — Listing-look slug from list_directory_tags, such as headline, device-frame or dark.
  • chart — string — With category: order by today's top free or top grossing chart for that category.
  • limit — integer
  • query — string — App name, developer, slug or Apple ID. Example: "duolingo".
  • offset — integer — For paging; count in the response is the total match count.
  • category — string — Genre slug from list_directory_categories, such as finance or food-drink.
  • platform — string — ios (App Store) or android (Google Play). Default: both.
  • has_video — boolean — Only apps whose listing has an App Store preview video.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

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

  Parameters:

  • slug — string — Directory slug such as duolingo, monzo, or doordash.
  • query — string — App name if you do not have a slug.
  • app_id — string — Apple numeric app ID.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

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

  Parameters:

  • slug (required) — string — Directory slug such as duolingo.
  • index — integer — Optional 1-based screenshot index.
  • country — string — 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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_app_videos read-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).

  Parameters:

  • slug (required) — string — Library slug such as instagram.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

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

  Parameters:

  • slug (required) — string — Library slug such as instagram.
  • limit — integer

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_magicscreenshots_site_summary read-only

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

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_magicscreenshots_markdown read-only

  Fetch a markdown representation of a known MagicScreenshots public page.

  Parameters:

  • route (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_magicscreenshots_discovery_document read-only

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

  Parameters:

  • endpoint (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• list_magicscreenshots_languages read-only

  Return supported screenshot localization languages and public guide routes.

  Parameters:

  • limit — integer

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_magicscreenshots_markets read-only

  Return supported App Store market guides and public market routes.

  Parameters:

  • limit — integer
  • region — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

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

  Parameters:

  • live — boolean — Skip the directory and fetch the current App Store listing.
  • slug — string — Directory slug. Returns catalog screens without a live App Store lookup.
  • query — string — App name to search in the directory, then the App Store.
  • app_id — string — Apple numeric app ID.
  • app_url — string — Apple App Store URL.
  • country — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

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

  Parameters:

  • source_app (required) — object — The user's app. Use query, app_url, or app_id from get_screenshots.
  • limit — integer
  • inspiration_app — object
  • inspiration_slug — string — Directory slug from list_directory_apps / get_directory_app. Preferred over a free-text inspiration query.
  • source_screenshot_urls — array
  • inspiration_screenshot_urls — array

  Hints: read-only no · destructive no · idempotent no · open-world yes

• create_localize

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

  Parameters:

  • source_app (required) — object
  • target_locales (required) — array — Locale IDs such as JPN, DEU, FRA, BRA, or objects with language/country.
  • limit — integer
  • source_screenshot_urls — array

  Hints: read-only no · destructive no · idempotent no · open-world yes

• approve_restyle

  Approve a generated restyle overview and start final screenshot extraction.

  Parameters:

  • group_id (required) — string
  • overview_url — string

  Hints: read-only no · destructive no · idempotent no · open-world yes

• get_job_group read-only

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

  Parameters:

  • group_id (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• list_results read-only

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

  Parameters:

  • limit — integer

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.