MCP

​

Overview

​

Features

• Multi-Platform Support — Works with Claude, Claude Code, ChatGPT, Cursor, Windsurf, VS Code, and more
• Remote or Local — Connect via the hosted server at https://api.poof.bg/mcp (OAuth) or run locally over stdio
• AI-First Design — Natural language interface for background removal
• Multiple Tools — Remove backgrounds and check account balance

​

Installation

env POOF_API_KEY=your-api-key npx -y @poof-bg/mcp

npm install -g @poof-bg/mcp

​

Integration Setup

​

Claude / Claude Desktop / Cowork

1. Go to Settings → Connectors
2. Click Add custom connector and enter Poof as the name and https://api.poof.bg/mcp as the URL. Click Add.
3. Click Authorize when prompted to grant MCP access.

​

Claude Code

1. Add the Poof MCP server:

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

2. Run /mcp in Claude Code and select Authenticate for Poof to complete the OAuth flow in your browser.

​

ChatGPT

1. Go to Settings → Apps & Connectors
2. Click Create to add a new connector
3. Enter Poof as the name and https://api.poof.bg/mcp as the connector URL
4. Click Save

​

Cursor

1. Open Cursor Settings
2. Navigate to MCPs & Integrations → New MCP Server
3. Add new MCP server:

{
  "poof": {
    "command": "npx",
    "args": ["-y", "@poof-bg/mcp"],
    "env": {
      "POOF_API_KEY": "your-api-key"
    }
  }
}

​

Windsurf

{
  "mcpServers": {
    "poof": {
      "command": "npx",
      "args": ["-y", "@poof-bg/mcp"],
      "env": {
        "POOF_API_KEY": "your-api-key"
      }
    }
  }
}

​

VS Code

1. Install the MCP extension
2. Add Poof server configuration
3. Set your API key in environment settings

​

Other Clients

​

Configuration

​

Environment Variables

• POOF_API_KEY: Your Poof API key (required for local stdio; remote connections can use OAuth instead). Get yours at dash.poof.bg.

​

Available Tools

​

remove_background

​

get_account

{
  "success": true,
  "data": {
    "organizationId": "org_abc123",
    "plan": "Pro",
    "maxCredits": 5000,
    "usedCredits": 1234,
    "remainingCredits": 3766
  }
}

​

Example Conversations

​

Remove Background from an Image

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

Claude: I’ll remove the background from that image for you. [Uses remove_background tool with the URL] Done! The background has been removed and here’s the result with a transparent background.

​

White Background for E-commerce

You: Take this product photo, remove the background, and give me a white background version for our website

Claude: I’ll process that product image with a white background for your website. [Uses remove_background with channels=“rgb”, bg_color=“#ffffff”, format=“jpg”] Done! I’ve created a version with a clean white background, perfect for e-commerce display.

​

Check Account Status

You: How many Poof credits do I have left?

Claude: Let me check your account. [Uses get_account tool] You’re on the Pro plan with 3,766 credits remaining out of 5,000 this billing cycle.

​

Troubleshooting

​

Server Not Appearing

1. Verify JSON syntax: Use a JSON validator to ensure your config file is valid
2. Check API key: Ensure your POOF_API_KEY is correct and active at dash.poof.bg
3. Full restart: Quit the client completely and reopen
4. Check logs: Look at your client’s developer console for error messages

​

API Errors

1. Verify your API key is correct
2. Check your credit balance at dash.poof.bg
3. Ensure your API key has not expired or been revoked

​

”Command not found” Errors

1. Ensure Node.js is installed: node --version (requires Node.js 18+)
2. Try installing the server globally: npm install -g @poof-bg/mcp
3. Use the global command in your config: "command": "poof-mcp"

​

Support

• npm Package
• GitHub Issues
• MCP Documentation