MCP, CLI, and API setup
Connect MagicScreenshots to Claude, ChatGPT-compatible MCP clients, Codex, Cursor, terminal scripts, or your own agents.
MCP Endpoint
https://www.magicscreenshots.com/api/mcp
Use bearer authentication with an API key created from 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
- get_screenshots: fetch App Store screenshots.
- create_restyle: create a restyle overview group.
- 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.