MagicScreenshots MCP server

online · 100% uptime

by Humanleap·io.github.Humanleap/magicscreenshots-mcp·v1.3.0

No reviews yet

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

A89/100grade A

Write a review Run it

What users say

No reviews yet

Be the first

Safety scan

A89/100

full report

Adoption

Growing

0 stars

Reviews

Write one

Nobody has reviewed MagicScreenshots yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

MagicScreenshots tools (19, 3 write)

write = sends, deletes, buys or posts

approve_restyleFree
Approve a generated restyle overview and start final screenshot extraction.
create_api_keywrite actionFree
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_localizewrite actionFree
Create MagicScreenshots localization jobs for source App Store screenshots across one or more target locales.
create_restylewrite actionFree
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_historyFree
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_videosFree
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_appFree
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_screensFree
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_groupFree
Check restyle job group status, overview URL, errors, and final output URLs.
get_magicscreenshots_discovery_documentFree
Fetch a known agent discovery document such as API catalog, Agent Skills, MCP, OAuth metadata, OpenAPI, or llms.txt.
get_magicscreenshots_markdownFree
Fetch a markdown representation of a known MagicScreenshots public page.
get_magicscreenshots_site_summaryFree
Return a concise summary of MagicScreenshots, the screenshot directory, public routes, MCP tools, and auth requirements.
get_screenshotsFree
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_appsFree
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_categoriesFree
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_tagsFree
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_languagesFree
Return supported screenshot localization languages and public guide routes.
list_magicscreenshots_marketsFree
Return supported App Store market guides and public market routes.
list_resultsFree
List recent MagicScreenshots restyle job groups and outputs for the authenticated account.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings

–Code scanremote-only server, no package to scann/a
Live reliabilityremote reachable in 400ms20/20
Tool poisoning19 tool descriptions checked15/15
Auth qualityAPI key sent as a header8/15
Maintenancelast push 0 days ago15/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10

Overall 89/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How MagicScreenshots compares

Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 89/100; higher than 87% of 2,174 E-commerce servers
Tools: 19; the typical E-commerce server has 6
Tools that change things: 16%; typical: 0%. Fewer write tools means less an agent can break
Uptime: 100%; of our recent checks; the typical remote E-commerce server answers 100%
Response time: 216 ms; faster than 65% of 1,527 E-commerce servers

What its tools let an agent do: 15 read · 3 create · 1 change

Install MagicScreenshots in Claude Code, Cursor or VS Code

claude mcp add --transport http magicscreenshots-mcp https://www.magicscreenshots.com/api/mcp

Add to Cursor

What the publisher says

From the MagicScreenshots repository's README, as published. We do not edit it. Read it on GitHub

MagicScreenshots for agents

Give your AI agent a library of real App Store screenshots and preview videos from thousands of top apps, updated daily, then let it generate and localize your own App Store screenshots.

with screenshots, preview videos and listing history.

Library: the top 100 free and top-grossing apps in every Apple category,

lifestyle, ...) or app name.

Search by category, today's chart, look (dark, headline, device frame,

translate them into 40+ languages at App Store resolution.

Generate: restyle your screenshots like any app in the library, or

Setup guides for every agent: https://www.magicscreenshots.com/agents

MCP endpoint (Streamable HTTP): https://www.magicscreenshots.com/api/mcp

Install

Searching needs no key. Generation, video downloads and listing history need an API key: ask your agent to call createapikey, or create one in Settings > API on magicscreenshots.com, then set MAGICSCREENSHOTSAPIKEY.

Any agent with skills (Claude Code, Codex, Cursor, Cline, Windsurf, ...)

npx skills add Humanleap/magicscreenshots-mcp

This installs the skill only. Add the MCP server too (below) so the agent can call the tools.

Claude Code

Plugin (skill + MCP server):

/plugin marketplace add Humanleap/magicscreenshots-mcp
/plugin install magicscreenshots@magicscreenshots

Or just the MCP server:

claude mcp add --transport http magicscreenshots https://www.magicscreenshots.com/api/mcp \
  --header "Authorization: Bearer $MAGICSCREENSHOTS_API_KEY"

The plugin sends Authorization: Bearer ${MAGICSCREENSHOTSAPIKEY}. Set the variable before starting Claude Code. With no key set, search still works, but getappvideos, getapphistory and generation return an auth error. For fully keyless use, delete the headers block from the plugin's .mcp.json.

Cursor

Install the plugin from the Cursor Marketplace, or add this to .cursor/mcp.json (project) or ~/.cursor/mcp.json:

{
  "mcpServers": {
    "magicscreenshots": {
      "url": "https://www.magicscreenshots.com/api/mcp",
      "headers": { "Authorization": "Bearer ${env:MAGICSCREENSHOTS_API_KEY}" }
    }
  }
}

Without MAGICSCREENSHOTSAPIKEY set, leave out headers (same reason as Claude Code above).

Codex

codex mcp add magicscreenshots --url https://www.magicscreenshots.com/api/mcp

For generation, set the key in config.toml:

[mcp_servers.magicscreenshots]
url = "https://www.magicscreenshots.com/api/mcp"
bearer_token_env_var = "MAGICSCREENSHOTS_API_KEY"

Gemini CLI

Extension (skill + MCP server, search tools):

gemini extensions install https://github.com/Humanleap/magicscreenshots-mcp

With a key:

gemini mcp add --transport http --header "Authorization: Bearer $MAGICSCREENSHOTS_API_KEY" \
  magicscreenshots https://www.magicscreenshots.com/api/mcp

Any other MCP client

{
  "mcpServers": {
    "magicscreenshots": {
      "type": "http",
      "url": "https://www.magicscreenshots.com/api/mcp",
      "headers": { "Authorization": "Bearer ms_live_..." }
    }
  }
}

Some clients call the URL field serverUrl (Windsurf) or httpUrl (Gemini). Leave out headers to use search only.

Command line

npx magic-screenshots search --category finance --chart grossing
npx magic-screenshots app duolingo
npx magic-screenshots screens duolingo --out ./reference
npx magic-screenshots videos instagram

Tools

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

MagicScreenshots: common questions

Is MagicScreenshots MCP server safe?: Yes, by our scan: it is graded A (89/100). Read the MagicScreenshots safety report
How do I install MagicScreenshots?: It runs remotely at www.magicscreenshots.com. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
Does MagicScreenshots need an API key?: Yes. The registry entry asks for Authorization.
Is MagicScreenshots maintained?: The last commit was 38 days ago (2026-09-27). The latest release is v1.3.0.
Is MagicScreenshots up?: 100% of our last 28 checks got an answer. We check remote servers about four times a day.
What can I use instead of MagicScreenshots?: Servers from other publishers that do the same job: Storeshots MCP server, Apify MCP server and Mneme Memory MCP server.
How does MagicScreenshots compare with other E-commerce MCP servers?: safety score 89/100 (higher than 87% of 2,174 E-commerce servers); tools 19 (the typical E-commerce server has 6); tools that change things 16% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to MagicScreenshots

Same job from other publishers: the closest match first, then the best rated.

Storeshots
Render store-ready App Store and Google Play screenshots: device frames, headlines, exact sizes.
not reviewed
Growing
A
Apify
Extract data from any website with thousands of scrapers, crawlers, and automations on Apify Store ⚡
not reviewed
Established
A
Mneme Memory
Cross-session memory for AI coding agents via six tools; local-first SQLite store.
not reviewed
Established
A
Heimdall
Every App Store Connect + StoreKit 2 endpoint. 929 tools in 13 profiles, narrow to 27.
not reviewed
Established
B
Buywhere
Agent-native product catalog: 300M+ products, 150,000+ stores, deliver_to ranking.
not reviewed
Established
A

Run it through the gateway

With the gateway added, ask your agent for it by name:

agent prompt

call io.github.Humanleap/magicscreenshots-mcp → approve_restyle

Free per call. Metered, capped by your key, logged for reliability.

Add the gateway (gw.mcp.market)

Rating: —
Safety grade: A · 89/100
Stars: 0
Downloads/wk: –
Price: Free
Licence: MIT
Transport: Remote
Uptime: 100% · 28/28 checks
Version: 1.3.0
Category: E-commerce
Last release: 2026-09-27

Endpoint

https://www.magicscreenshots.com/api/mcp

streamable-http

Own this server?

Claim it to keep the listing current and reply to reviews. Claiming never changes the grade or hides a review.

Claim listing

Badge for your README

Shows the safety grade and links back to this page. It updates itself after every scan and review.

[![mcp.market](https://mcp.market/badge/humanleap-magicscreenshots-mcp.svg)](https://mcp.market/server/humanleap-magicscreenshots-mcp)

How the badge works