# MagicScreenshots 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.

## CLI

Set MAGICSCREENSHOTS_API_KEY and run:

```bash
npx magic-screenshots get-screenshots --query "Duolingo"
npx magic-screenshots create-localize --source "Your App" --locale JPN --locale DEU --limit 5
npx magic-screenshots create-restyle --source "Your App" --inspiration "Duolingo" --limit 5
npx magic-screenshots get-job-group --group-id <group_id>
npx magic-screenshots approve-restyle --group-id <group_id>
```

## REST API

POST to https://xpzoprjuvscmpywxwfug.supabase.co/functions/v1/agent-api with an action field.

## Tools

- get_screenshots
- create_restyle
- create_localize
- approve_restyle
- get_job_group
- list_results