The OAuth route means a client can be connected in one command with no key handling at all, which is the right default here. Because every cut-out spends credits, `get_account` is worth calling before you point a model at a folder of images — it returns remaining credits directly, so the model can decide whether to continue.
The MCP server for Poof's background-removal API. Two tools: one strips the background from an image you pass as a URL or base64, the other reports what is left of your credit balance.
- `remove_background` takes a base64 image or a URL and returns the cut-out
- Output control on the same call: `format` for `png`, `jpg` or `webp`; `channels` for `rgba` transparency or a flat `rgb`; `bg_color` to drop in a solid colour instead
- `size` picks the render scale — `full`, `preview`, `small`, `medium` or `large` — and `crop` trims the frame down to the subject
- `get_account` returns the plan name with used and remaining credits, so a batch can stop before it runs dry
A Poof account. The hosted endpoint is `https://api.poof.bg/mcp` over Streamable HTTP, which handles OAuth in supported clients — no key to paste. To run it locally instead, install the npm package `@poof-bg/mcp` (version 1.1.0) and set `POOF_API_KEY`; the same key also works remotely as an `x-api-token` header. Self-hosting on Cloudflare Workers is documented and needs `MCP_JWT_SECRET`, `COOKIE_ENCRYPTION_KEY` and a KV namespace for OAuth state.
One command plus a key — claude mcp add --transport http poof https://api.poof.bg/mcp, then supply credentials