PhotoSweat MCP server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
PhotoSweat MCP server
An MCP server for background removal. An agent hands it the absolute path to a photo; it calls the hosted PhotoSweat API, writes the cut-out PNG next to the original, and returns that path.
No GPU, no API client to write, no key required to start — the free tier is 10 images a day per IP.
photo_image_cutout({ path: "/Users/me/photo.jpg" })
→ Saved image/png to /Users/me/photo-cutout.png (1437218 bytes). jobId: 5f0c…Why this one
The tool list is generated, not hand-written. On startup the server reads
GET /api/capabilitiesand registers one tool per open capability, deriving each parameter schema (type, range, default, enum) from that document. There is no second copy of the API to drift out of date.Only capabilities that actually answer are registered. Tools marked
pausedin the capability document are skipped, so an agent never picks a tool that would return404 tool_paused. A short tool list beats a wasted call.Hosted on real GPUs. Edges are hair-level, output is a real alpha channel.
Related MCP server: Remover Fundo
Install
git clone <this-repo> photosweat-mcp
cd photosweat-mcp
npm installNode 18 or newer.
Connect it
Claude Code:
claude mcp add photo-workshop -- node /absolute/path/to/photosweat-mcp/server.mjsClaude Desktop / Cursor / any client that reads an MCP config file:
{
"mcpServers": {
"photo-workshop": {
"command": "node",
"args": ["/absolute/path/to/photosweat-mcp/server.mjs"],
"env": {
"PHOTO_API": "https://photosweat.shop"
}
}
}
}env can be omitted entirely — the defaults below are the public API.
Variable | Default | Meaning |
|
| Base URL of the API |
| (unset) | API key. Raises the daily allowance to 30 and gives you a stable identity |
| (unset) |
|
Tools
Exactly one tool is registered today, because exactly one capability is open.
Tool | Arguments |
|
|
path— absolute path to a JPG / PNG / WebP file, 10 MB max.out— where to write the result; defaults to<input>-<capability>.<ext>.background—transparent(default),white, orcolor.color—#rrggbb, only used whenbackgroundiscolor.format—png(default) orjpeg. JPEG only works on opaque backgrounds; transparency requires PNG.
Other capabilities in the document (restore, colorize, white-background, erase, upscale,
extend) are paused and will be registered automatically if they reopen.
Under the hood
Each call is the same three-step flow the website uses: POST /api/presign → PUT the bytes
to the returned presigned URL → POST /api/jobs → poll GET /api/jobs/{id} → download the
result. PHOTO_KEY, when set, is sent as Authorization: Bearer … on the API calls only —
never on the presigned URL, whose signature does not cover that header.
Using the HTTP API directly instead
If you are not driving an agent, the single-request endpoint is simpler:
curl -sS https://photosweat.shop/api/remove-background \
-H "Authorization: Bearer $PHOTO_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
--data-binary @photo.jpg \
-o photo-cutout.pngIt returns the image bytes with 200, or 202 with a JSON body containing status_url if
the synchronous wait (20 s by default, ?wait=N to change it) runs out — poll that URL rather
than resending the image. Add ?format=json to always get JSON with a result_url instead of
bytes, and ?params={"background":"white"} to change the options.
GET /api/capabilities— every capability, its parameters, status and price.GET /openapi.json— the full OpenAPI description.https://photosweat.shop/apikey— keys, quickstart, batch endpoint, SDK.
Limits
10 MB per image; JPG, PNG or WebP.
10 images/day anonymously (per IP), 30/day with a key, 200/day signed in on the website.
Past the free allowance: prepaid credits at $0.01/image ($10 = 1,000 images).
Anonymous requests are rate-limited to 30/minute.
Results are deleted after 24 hours. Save them yourself.
Development
server.mjs and client.mjs in this repository are generated from the private worker
source and carry a header saying so. Change them upstream and re-sync; edits here are
overwritten. Behaviour is versioned together with the API, which is why the server reports its
own version rather than tracking the npm package independently.
License
MIT. See LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Removes the background from an image by URL, cutting out the foreground person or object with AI and
Remove the background from any image: upload or link a photo, get a transparent PNG back.
Remove photo backgrounds to transparent, white, or solid color. $0.01/image; 10 free per day.
Remove backgrounds from images, videos and animated GIFs: transparent cutouts, mattes, GIF stickers.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to process images locally via file paths—converting, resizing, removing backgrounds, smart cropping, upscaling, reading or stripping metadata, and batch processing—without files ever leaving the device.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI-powered removal of image backgrounds from URLs, returning transparent PNGs with optional solid color replacement or resizing.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to remove image backgrounds from individual files, folders, or URLs and save processed results with options for preview or full-size output, background color, format, and cropping while handling account sign-in and credit checks.68 npmMIT
- AlicenseAqualityBmaintenanceEnables agents to compress JPEG, PNG, and WebP images to a target byte size, split PDFs by page or ranges, and remove image metadata while processing local files without sending file bytes over the network.73MIT