simplypng-mcp

MCP server for SimplyPNG background removal APIs.

Exposes SimplyPNG's background removal capabilities as MCP tools, letting AI agents (Claude, GPT, etc.) process images programmatically without UI interaction.

Tools

Tool	Description
estimate_credits	Check credit cost before processing
remove_background	Remove background from a single image
batch_remove_background	Remove backgrounds from up to 50 images
get_job_status	Poll status of a single job or batch
download_results	Get signed download URL for a completed job

Requirements

• Node.js 18+
• A SimplyPNG API key — get one at https://simplypng.app/dashboard/api-keys

Quickstart (Local / Claude Desktop)

git clone https://github.com/SimplyPNG/simplypng-mcp.git
cd simplypng-mcp
npm install
npm run build

Add to your Claude Desktop config (%AppData%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "simplypng": {
      "command": "node",
      "args": ["C:\\path\\to\\simplypng-mcp\\build\\index.js"],
      "env": {
        "SIMPLYPNG_API_KEY": "sp_live_your_key_here"
      }
    }
  }
}

Quickstart (HTTP / Remote)

SIMPLYPNG_API_KEY=sp_live_your_key_here npm run serve
# MCP endpoint: POST http://localhost:3000/mcp

Environment Variables

Variable	Required	Default	Description
SIMPLYPNG_API_KEY	Yes	—	Your SimplyPNG API key
SIMPLYPNG_API_URL	No	https://simplypng.app	Override for staging
PORT	No	3000	HTTP server port (HTTP transport only)

Copy .env.example to .env and fill in your key.

Development

npm run dev        # stdio mode via tsx (no build step)
npm run serve      # HTTP mode via tsx
npm run type-check # TypeScript check without build
npm run build      # Compile to build/

Authentication

This server is a thin adapter — your API key is passed via SIMPLYPNG_API_KEY and forwarded as Authorization: Bearer to the SimplyPNG API. The server stores no credentials itself.

API keys: sp_live_xxx (production) or sp_test_xxx (testing).

Credit Usage

Mode	Credits per image
Fast (default)	1 credit (2500px max)
HD (hdMode: true)	2 credits (4096px max)

Use estimate_credits before processing to verify you have sufficient balance.

License

MIT — see LICENSE