@poof/mcp-server

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, URL, or file path)
get_account - Check your account info and credit balance

Installation

npm install -g @poof/mcp-server

Or install locally:

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

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 Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "poof": {
      "command": "npx",
      "args": ["-y", "@poof/mcp-server"],
      "env": {
        "POOF_API_KEY": "your_api_key_here"
      }
    }
  }
}

Or if installed from source:

{
  "mcpServers": {
    "poof": {
      "command": "node",
      "args": ["/path/to/poof-sdks/mcp-server/dist/index.js"],
      "env": {
        "POOF_API_KEY": "your_api_key_here"
      }
    }
  }
}

Tools

remove_background

Remove the background from an image.

Parameters:

Parameter	Type	Required	Description
`image`	string	Yes	Base64-encoded image, URL, or file path
`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`)
`output_path`	string	No	Save result to file instead of returning base64

Example prompts:

Remove the background from this image: https://example.com/photo.jpg

Remove the background from /Users/me/photos/headshot.png and save it to /Users/me/photos/headshot-nobg.png

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

# Watch mode
npm run dev

# Run
npm start

License

MIT

Poof Background Removal MCP Server