MCP, CLI, and API setup
Connect MagicScreenshots to Claude, ChatGPT-compatible MCP clients, Codex, Cursor, terminal scripts, or your own agents. Directory browse needs no key. Restyle uses an API key.
MCP Endpoint
https://www.magicscreenshots.com/api/mcp
Directory tools work with no account. For generation, use bearer authentication with an API key from create_api_key or Settings > API.
Claude Desktop
Use mcp-remote and pass the MagicScreenshots API key as an authorization header.
HTTP MCP Clients
Use Streamable HTTP with URL https://www.magicscreenshots.com/api/mcp and header Authorization: Bearer $MAGICSCREENSHOTS_API_KEY.
CLI
Install and run with npx magic-screenshots. Set MAGICSCREENSHOTS_API_KEY before running commands. Use create-localize with repeatable --locale flags for localization jobs.
REST API
POST to https://xpzoprjuvscmpywxwfug.supabase.co/functions/v1/agent-api with an action field.
Tool Reference
- list_directory_categories / list_directory_tags / list_directory_apps: browse curated listing sets. No API key.
- get_directory_app / get_directory_screens: ordered listing screenshots.
- get_screenshots: directory first; live App Store lookup with a key.
- create_restyle: restyle using inspiration_slug from the directory.
- create_localize: create localization jobs for one or more target locales.
- approve_restyle: approve an overview and start final extraction.
- get_job_group: poll status and retrieve URLs.
- list_results: list recent restyle and localization groups.