MCP docs

Technical setup for the Edets MCP server.

Use these examples to connect Edets MCP to Claude Desktop, Cursor, or another MCP-compatible assistant and expose callable image editing tools.

npx install

{
  "mcpServers": {
    "edets": {
      "command": "npx",
      "args": ["edets-mcp"],
      "env": {
        "EDETS_API_KEY": "your_api_key_here"
      }
    }
  }
}

local package path

{
  "mcpServers": {
    "edets": {
      "command": "node",
      "args": ["/absolute/path/to/remoov/edets-mcp/dist/index.js"],
      "env": {
        "EDETS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Tool reference

remove_background

Remove the background and save a transparent PNG.

swap_background

Remove the background and composite onto a color or image.

passport_photo

Create a passport photo using a bundled country spec.

check_balance

Return plan, remaining calls, and current usage state.

get_country_specs

Return one country spec or the full 115-country dataset.

Current package status

`edets-mcp` lives in the Remoov repo under `/edets-mcp`
Build passes
Typecheck passes
Phase 1 smoke passed for background removal, swaps, passport photo, and balance checks
The bundled passport dataset currently covers 115 countries

Manual test prompts

How many edets API calls do I have left?

Remove the background from /Users/miguel/Downloads/Edets before.png and save it to /tmp/manual-edets-cutout.png

Put /Users/miguel/Downloads/Edets before.png on a white background and save it to /tmp/manual-edets-white.png

Create an Indonesia passport photo from /Users/miguel/Downloads/Edets before.png and save it to /tmp/manual-edets-id.jpg