What can you do with this server?

This server allows AI assistants like Claude to remove backgrounds from images and manage your Poof API account. * Remove image backgrounds (remove_background): Process images by providing either a URL or base64-encoded image, with the following options: * Format: png, jpg, or webp (default: png) * Color channels: rgba for transparency or rgb for opaque output (default: rgba) * Background color: hex, RGB, or color name (e.g., #ffffff) when using rgb channels * Output size: full, preview, small, medium, or large (default: full) * Crop to subject bounds (default: false) * Check account information (get_account): Retrieve your Poof account details including organization ID, plan type, maximum credits, used credits, remaining credits, and auto-recharge threshold

How do I use Poof Background Removal MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Poof Background Removal MCP Server remove the background from https://example.com/portrait.jpg" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Poof Background Removal MCP Server

by poof-bg

Overview Schema Related Servers Score Discussions

TypeScript

Hybrid

@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

Installation

Local (stdio transport)

npm install -g @poof-bg/mcp

Or install locally:

git clone https://github.com/poof-bg/mcp.git
cd mcp
npm install
npm run build

Remote (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_here

Get your API key at dash.poof.bg

Claude Code

OAuth (recommended)

claude mcp add --transport http poof https://api.poof.bg/mcp

API 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"
    }
  }
}

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 instead

get_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 format

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 deploy

Set the required environment secrets:

wrangler secret put POOF_API_KEY
wrangler secret put MCP_JWT_SECRET
wrangler secret put COOKIE_ENCRYPTION_KEY

Also set the dashboard URL variable:

wrangler secret put DASHBOARD_URL

You'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 --preview

License

MIT

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/poof-bg/mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

@poof-bg/mcp

Features

Installation

Local (stdio transport)

Remote (HTTP transport via Cloudflare Worker)

Configuration

Environment Variable

Claude Code

OAuth (recommended)

API Key

Claude Desktop

Option 1: Remote with OAuth (recommended)

Option 2: Local (stdio transport)

Option 3: Remote with API key

Cursor

OAuth (recommended)

Local (stdio)

Remote with API key

Windsurf

OAuth (recommended)

Local (stdio)

Remote with API key

VS Code + Copilot

OAuth (recommended)

Local (stdio)

Remote with API key

Cline (VS Code Extension)

OAuth (recommended)

Local (stdio)

Remote with API key

Tools

remove_background

get_account

Development

Deployment (Cloudflare Worker)

License

Links

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API