MCP Server

Cutout Magic

Last Updated: September 19, 2026

Cutout Magic runs a Model Context Protocol (MCP) server at https://cutoutmagic.com/api/mcp so you can use it from any MCP client, such as Claude Desktop, with your own API key.

1. Get an API key

  1. Log in and open Settings.
  2. Under API keys, enter a name (for example Claude Desktop) and click create key.
  3. Copy the key now — it is shown only once and cannot be recovered.
  4. Revoke keys from the same page at any time.

2. Connect your client

Remote MCP servers in Claude Desktop are configured by adding a connector in Settings → Connectors → Add custom connector, pointing it at https://cutoutmagic.com/api/mcp and pasting your API key (format Bearer cmk_...) in the Authorization header of the connector.

Claude Code:

claude mcp add --transport http cutout-magic https://cutoutmagic.com/api/mcp --header "Authorization: Bearer cmk_your_key"

3. Available tools and credit costs

Tool What it does Credits
list_images List your image folders (source + derivatives) Free
upload_image Add an image to your library from a URL Free
remove_background Remove the background, keep the subject 5
label_image Detect objects, return names + bounding boxes 2
crop_image Crop to a normalized bounding box (0-1) Free
extract_object Cut an object out, replace the surroundings 20-50 by model
remove_object Remove an object and inpaint the area behind it 20-50 by model
get_favorites List favorited images Free

Credits are deducted per action as they are in the web app. See the MCP reference page for exact parameter schemas.

4. Security

API keys grant the same access to your images and credits as your browser session. They are stored hashed; the plaintext key is shown once on creation and never stored. Revoke immediately if a key leaks, and treat each client as a separate key so revoking one doesn't affect the rest.