MCP - PhotoTools

PhotoTools MCP

The MCP server exposes the same trusted image operations as the web/API layer: remove background, transparent cutout, upscale, product photo background, background presets, restore photo, and strip metadata.

Local Setup

cd /home/mcuser/phototools/server
python3 -m pip install -r requirements.txt
PHOTO_TOOLS_MCP_TRANSPORT=stdio python3 mcp_server.py

Use stdio for local agent integrations. For hosted HTTP MCP, run the same server with streamable HTTP behind an auth-aware reverse proxy.

Paid Access

API and hosted MCP access require Clerk auth or a PhotoTools API key. This build includes dummy billing gates through `PHOTO_TOOLS_DUMMY_PAID_USERS` and `PHOTO_TOOLS_DUMMY_API_KEYS` while Clerk plans are being tested.

Authorization: Bearer <clerk-session-token>
X-PhotoTools-API-Key: <dummy-or-real-api-key>

Pricing

Starter API/MCP

$12/mo

200 credits, 1 API key, MCP access.

Pro API/MCP

$29/mo

500 credits, 3 API keys, higher rate limits.

Studio

$79/mo

1,500 credits, team keys, priority queue.

Overage

$0.06

Per extra credit after plan credits.

Tools

remove_background(image_base64)
make_transparent_png(image_base64)
upscale_image(image_base64, scale=2)
product_photo_background(image_base64, background="white")
replace_background_preset(image_base64, background="studio")
restore_photo(image_base64)
strip_metadata(image_base64)