⌁ labsco summary — our analysis, not the vendor's
What it is — An MCP server for the Poof background-removal API, letting AI assistants like Claude strip backgrounds from images with a single tool call.
What you get —
- Background removal —
remove_backgroundaccepts a base64 image or URL and returns a cutout with transparency or a custom background - Account info —
get_accountchecks your credit balance - Flexible deployment — both stdio (local) and HTTP transports (including a Cloudflare Worker)
- OAuth or API-key auth options for Claude Code/Desktop, Cursor, Windsurf
Requirements — A Poof account and POOF_API_KEY from dash.poof.bg (or OAuth for the hosted endpoint).
Cost snapshot — Server license unspecified. It fronts the paid Poof API, which is credit-based (get_account reports your credit balance) — the README lists no per-image price.
Setup effort — npx -y @poof-bg/mcp with a key, or add the hosted URL https://api.poof.bg/mcp with OAuth.
Our take — A simple, well-integrated way to add image background removal to an agent; the caveat is the credit-based dependency — removals consume Poof credits, so it's only free within whatever your account balance allows.
Source: the project README — summarized 2026-07-08.
⌁ readme from github — mirrored (latest on GitHub ↗)
@poof-bg/mcp
MCP (Model Context Protocol) server for the Poof background removal API. Use AI assistants like Claude to remove backgrounds from images.
Features
- remove_background - Remove background from images (accepts base64 or URL)
- get_account - Check your account info and credit balance
- Supports both stdio (local) and HTTP (remote/Cloudflare Worker) transports
Tools
remove_background
Remove the background from an image.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
image | string | Yes | Base64-encoded image or URL to an image |
format | string | No | Output format: png, jpg, webp (default: png) |
channels | string | No | Color channels: rgba for transparency, rgb for opaque (default: rgba) |
bg_color | string | No | Background color when using rgb channels (e.g., #ffffff) |
size | string | No | Output size: full, preview, small, medium, large (default: full) |
crop | boolean | No | Crop to subject bounds (default: false) |
Example prompts:
Remove the background from this image: https://example.com/photo.jpg
Remove the background and add a white background insteadget_account
Get your account information and credit balance.
Example prompts:
Check my Poof account balance
How many credits do I have left?Response:
{
"success": true,
"data": {
"organizationId": "org_abc123",
"plan": "Pro",
"maxCredits": 5000,
"usedCredits": 1234,
"remainingCredits": 3766,
"autoRechargeThreshold": 100
}
}Development
# Install dependencies
npm install
# Build
npm run build
# Run in dev mode (Cloudflare Worker)
npm run dev
# Run locally (stdio mode)
POOF_API_KEY=your_key npm start
# Lint
npm run lint
# Format
npm run formatLinks
{
"mcpServers": {
"poof": {
"url": "https://api.poof.bg/mcp"
}
}
}Before it works, you'll need: POOF_API_KEY
Installation
Local (stdio transport)
npm install -g @poof-bg/mcpOr install locally:
git clone https://github.com/poof-bg/mcp.git
cd mcp
npm install
npm run buildRemote (HTTP transport via Cloudflare Worker)
The Poof MCP server can be deployed as a Cloudflare Worker, allowing remote access via HTTP.
Configuration
Environment Variable
Set your Poof API key:
export POOF_API_KEY=your_api_key_hereGet your API key at dash.poof.bg
Claude Code
OAuth (recommended)
claude mcp add --transport http poof https://api.poof.bg/mcpAPI Key
claude mcp add --transport http poof https://api.poof.bg/mcp \
--header "x-api-token: YOUR_POOF_API_KEY"Claude Desktop
Add to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Option 1: Remote with OAuth (recommended)
{
"mcpServers": {
"poof": {
"url": "https://api.poof.bg/mcp"
}
}
}Option 2: Local (stdio transport)
{
"mcpServers": {
"poof": {
"command": "npx",
"args": ["-y", "@poof-bg/mcp"],
"env": {
"POOF_API_KEY": "your_api_key_here"
}
}
}
}Option 3: Remote with API key
{
"mcpServers": {
"poof": {
"url": "https://api.poof.bg/mcp",
"headers": {
"x-api-token": "YOUR_POOF_API_KEY"
}
}
}
}Cursor
Add to .cursor/mcp.json in your project root (or global config):
OAuth (recommended)
{
"mcpServers": {
"poof": {
"url": "https://api.poof.bg/mcp"
}
}
}Local (stdio)
{
"mcpServers": {
"poof": {
"command": "npx",
"args": ["-y", "@poof-bg/mcp"],
"env": {
"POOF_API_KEY": "your_api_key_here"
}
}
}
}Remote with API key
{
"mcpServers": {
"poof": {
"url": "https://api.poof.bg/mcp",
"headers": {
"x-api-token": "YOUR_POOF_API_KEY"
}
}
}
}Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
OAuth (recommended)
{
"mcpServers": {
"poof": {
"serverUrl": "https://api.poof.bg/mcp"
}
}
}Local (stdio)
{
"mcpServers": {
"poof": {
"command": "npx",
"args": ["-y", "@poof-bg/mcp"],
"env": {
"POOF_API_KEY": "your_api_key_here"
}
}
}
}Remote with API key
{
"mcpServers": {
"poof": {
"serverUrl": "https://api.poof.bg/mcp",
"headers": {
"x-api-token": "YOUR_POOF_API_KEY"
}
}
}
}VS Code + Copilot
Add to your VS Code settings.json:
OAuth (recommended)
{
"mcp": {
"servers": {
"poof": {
"url": "https://api.poof.bg/mcp"
}
}
}
}Local (stdio)
{
"mcp": {
"servers": {
"poof": {
"command": "npx",
"args": ["-y", "@poof-bg/mcp"],
"env": {
"POOF_API_KEY": "your_api_key_here"
}
}
}
}
}Remote with API key
{
"mcp": {
"servers": {
"poof": {
"url": "https://api.poof.bg/mcp",
"headers": {
"x-api-token": "YOUR_POOF_API_KEY"
}
}
}
}
}Cline (VS Code Extension)
Open Cline settings and add to the MCP Servers configuration:
OAuth (recommended)
{
"poof": {
"url": "https://api.poof.bg/mcp"
}
}Local (stdio)
{
"poof": {
"command": "npx",
"args": ["-y", "@poof-bg/mcp"],
"env": {
"POOF_API_KEY": "your_api_key_here"
}
}
}Remote with API key
{
"poof": {
"url": "https://api.poof.bg/mcp",
"headers": {
"x-api-token": "YOUR_POOF_API_KEY"
}
}
}Deployment (Cloudflare Worker)
To deploy the MCP server as a Cloudflare Worker:
# Install Wrangler if you haven't already
npm install -g wrangler
# Login to Cloudflare
wrangler login
# Deploy
wrangler deploySet the required environment secrets:
wrangler secret put POOF_API_KEY
wrangler secret put MCP_JWT_SECRET
wrangler secret put COOKIE_ENCRYPTION_KEYAlso set the dashboard URL variable:
wrangler secret put DASHBOARD_URLYou'll also need to create a KV namespace for OAuth state storage and update the IDs in wrangler.toml:
wrangler kv namespace create OAUTH_KV
wrangler kv namespace create OAUTH_KV --previewNo common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
License
MIT