# MagicScreenshots

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

- name: io.github.Humanleap/magicscreenshots-mcp
- version: 1.3.0
- connection class: R0 (autonomous)
- trust: 97/100
- quality: 91/100 (strong)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.Humanleap%2Fmagicscreenshots-mcp
- tools: https://api.protogrid.dev/v1/servers/io.github.Humanleap%2Fmagicscreenshots-mcp/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "magicscreenshots-mcp": {
      "type": "http",
      "url": "https://www.magicscreenshots.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${MAGICSCREENSHOTS_MCP_TOKEN}"
      }
    }
  }
}
```

Placeholders to fill: `${MAGICSCREENSHOTS_MCP_TOKEN}`.

## Trust

- hygiene: 100
- liveness: 100
- freshness: 100
- provenance: 90
- drivers: +repository +namespace-matches-repo +website +reachable +uptime-100% +updated-23d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 91/100 (strong)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2024-11-05; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 19 of 19 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 2,939 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 19, about 2,939 tokens to load them all
- tool set hash: 5f3317116eb19c2dc53b56478b4a3b83
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.Humanleap/magicscreenshots-mcp.svg)](https://protogrid.dev/servers/io.github.Humanleap/magicscreenshots-mcp)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://www.magicscreenshots.com/api/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (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_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_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_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_job_group`: Check restyle job group status, overview URL, errors, and final output URLs.
- `get_magicscreenshots_discovery_document`: Fetch a known agent discovery document such as API catalog, Agent Skills, MCP, OAuth metadata, OpenAPI, or llms.txt.
- `get_magicscreenshots_markdown`: Fetch a markdown representation of a known MagicScreenshots public page.
- `get_magicscreenshots_site_summary`: Return a concise summary of MagicScreenshots, the screenshot directory, public routes, MCP tools, and auth requirements.
- `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.
- `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.
- `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_magicscreenshots_languages`: Return supported screenshot localization languages and public guide routes.
- `list_magicscreenshots_markets`: Return supported App Store market guides and public market routes.
- `list_results`: List recent MagicScreenshots restyle job groups and outputs for the authenticated account.