remove_backgroundLABSCO SUMMARY
Credits are the thing to watch, not the setup.
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.
What it is
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.
What you get
remove_backgroundtakes a base64 image or a URL and returns the cut-out- Output control on the same call:
formatforpng,jpgorwebp;channelsforrgbatransparency or a flatrgb;bg_colorto drop in a solid colour instead sizepicks the render scale —full,preview,small,mediumorlarge— andcroptrims the frame down to the subjectget_accountreturns the plan name with used and remaining credits, so a batch can stop before it runs dry
Requirements
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.
Setup effort
One command, then sign in — claude mcp add --transport http poof https://api.poof.bg/mcp, then approve the OAuth sign-in
USE CASES
Removing a background without leaving the conversation
Paste an image URL and get the cut-out back, in the format and size the design needs.
Swapping in a solid backdrop
Ask for rgb channels with a background colour instead of transparency, for placements that cannot take an alpha channel.
Checking the budget before a batch
Read the plan and remaining credits first, so a bulk run does not stop halfway.
2 tools
Listed in project docs. Your client may show a different list.
get_accountBEFORE YOU INSTALL
What to know first
Tools you get
2 tools named in the project's documentation.
Requires
- A client that can reach a remote MCP server over HTTP
- A Poof account (dash.poof.bg)
Where it runs
All 5 documented clients connect to a hosted endpoint.
INSTALLATION
Connect your client
Server setup
claude mcp add
claude mcp add --transport http poof https://api.poof.bg/mcpHosted endpoint
https://api.poof.bg/mcpAdd this hosted endpoint to your MCP client, then sign in.
MCP Clients
Claude Code
claude mcp add --transport http poof https://api.poof.bg/mcpThese blocks carry no key: the hosted endpoint signs you in with OAuth. To use an API key instead, get one at dash.poof.bg and send it as an x-api-token header, or set POOF_API_KEY for the local @poof-bg/mcp package.
Cursor
{
"mcpServers": {
"poof": {
"url": "https://api.poof.bg/mcp"
}
}
}These blocks carry no key: the hosted endpoint signs you in with OAuth. To use an API key instead, get one at dash.poof.bg and send it as an x-api-token header, or set POOF_API_KEY for the local @poof-bg/mcp package.
Windsurf
{
"mcpServers": {
"poof": {
"serverUrl": "https://api.poof.bg/mcp"
}
}
}These blocks carry no key: the hosted endpoint signs you in with OAuth. To use an API key instead, get one at dash.poof.bg and send it as an x-api-token header, or set POOF_API_KEY for the local @poof-bg/mcp package.
VS Code
{
"servers": {
"poof": {
"url": "https://api.poof.bg/mcp"
}
}
}These blocks carry no key: the hosted endpoint signs you in with OAuth. To use an API key instead, get one at dash.poof.bg and send it as an x-api-token header, or set POOF_API_KEY for the local @poof-bg/mcp package.
Cline
{
"mcpServers": {
"poof": {
"type": "streamableHttp",
"url": "https://api.poof.bg/mcp"
}
}
}These blocks carry no key: the hosted endpoint signs you in with OAuth. To use an API key instead, get one at dash.poof.bg and send it as an x-api-token header, or set POOF_API_KEY for the local @poof-bg/mcp package.