Skip to main content
Glama
simplypng-mcp
by SimplyPNG

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

Related MCP server: forgemesh-imagegen

Requirements

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

Available Tools

5 tools
batch_remove_backgroundBatch Remove BackgroundA

Remove backgrounds from multiple images in a single batch (up to 50). MANDATORY WORKFLOW — follow these steps in order: (1) Call estimate_credits first (imageCount = number of images). Show user total cost + balance. Ask for confirmation. (2) Only call this tool AFTER the user confirms. (3) After this returns a batchId, poll get_job_status every 5 seconds until all images complete. Credit cost: 1 credit/image (Fast mode, default) or 2 credits/image (HD mode). Fast mode works with any input size — large images are downsampled to 2500px output. Use HD only when user needs output above 2500px, or subjects have fine edge detail (hair, fur, feathers). refineEdges (requires HD): removes color bleeding at edges — recommend for products on colored backgrounds. No extra credit. IMPORTANT about local files: do NOT use base64 — it fills the conversation context. Direct users to share URLs or use https://simplypng.app.

Inputs: images (required), hdMode, background, outputType, +5 more.

download_resultsDownload ResultsA

Get the current signed download URL for a completed job. URLs expire after 1 hour — call this tool again if the URL has expired.

Inputs: jobId (required).

estimate_creditsEstimate CreditsA

Estimate credit cost and check balance. Fast mode (default): 1 credit/image — input resized to 2500px, output up to 2500px. Works with any input size. HD mode: 2 credits/image — input preserved up to 4096px, output up to 4096px. REQUIRED: Call this before EVERY remove_background or batch_remove_background call. After calling, present the result to the user and ask: "This will use X credit(s) (you have Y). Proceed?" Only call the processing tool AFTER the user confirms. If canAfford is false, tell the user they need more credits before proceeding.

Inputs: imageCount (required), hdMode.

get_job_statusGet Job StatusA

Check the status of a single job or batch. Returns status (pending/processing/succeeded/failed) and result URLs for completed jobs. Poll every 2–5 seconds until status is succeeded or failed.

Inputs: jobId, batchId.

remove_backgroundRemove BackgroundA

Remove the background from a single image. MANDATORY WORKFLOW — follow these steps in order: (1) Call estimate_credits first (imageCount=1). Show user the cost + balance. Ask for confirmation. (2) Only call this tool AFTER the user confirms. (3) After this returns a jobId, poll get_job_status every 3 seconds until status is "succeeded". (4) Call download_results to get the final download URL. Credit cost: 1 credit (Fast mode, default) or 2 credits (HD mode). Fast mode works with any input size — large images are just downsampled to 2500px output. Use HD only when user needs output above 2500px, or subject has fine edge detail (hair, fur, feathers). refineEdges (requires HD): removes color bleeding at edges — recommend for products on colored backgrounds. No extra credit. IMPORTANT about local files: if user has a local file, do NOT use base64 — base64 tool inputs are stored in the conversation context and a 1MB image consumes ~340k tokens, making the conversation unusable. Instead tell the user: "Please share a public URL for your image (e.g. Google Drive share link, iCloud, Dropbox) or use https://simplypng.app directly."

Inputs: image (required), hdMode, background, outputMode, +5 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.5/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: estimating credits, removing backgrounds singly or in batches, polling job status, and downloading results. No overlap.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case: download_results, estimate_credits, remove_background, batch_remove_background, get_job_status.

    Tool Count5/5

    5 tools tightly cover the service's workflow without redundancy. The count is appropriate for a focused background removal MCP server.

    Completeness4/5

    The essential lifecycle (estimate, process, poll, download) is covered. A minor gap is the lack of an upload tool, but the workaround of using URLs is reasonable for this domain.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    • # Poof **Poof ([poof.bg](https://poof.bg)): a background removal API for AI agents. Send an image, get the subject back on a transparent background in under 2 seconds.** [Poof](https://poof.bg) gives your assistant a background removal tool. It handles people, products, cars, animals, and graphics, with hair-level edge precision, and returns a transparent PNG or WebP, or a solid-colour JPG for product listings. Pricing starts at $0.002 per image, with 100 free credits every month. This repository is the integration front door. The product itself lives at [poof.bg](https://poof.bg); the remote MCP server lives at `https://api.poof.bg/mcp`. ## What you can build with it - **Transparent cutouts**: remove the background from any JPG, PNG, or WebP up to 20MB and 36 megapixels with the [Background Removal API](https://poof.bg/background-removal-api). - **E-commerce product photos**: white or brand-colour backgrounds, cropped to the subject and resized to a fixed canvas, so every listing image matches. - **A remove.bg replacement**: remove.bg shuts down on 1 December 2026. Poof accepts the same inputs, so most integrations only change the endpoint and key. See the [remove.bg alternative and migration guide](https://poof.bg/alternative/remove-bg). - **Agent image pipelines**: let Claude, ChatGPT, or Cursor clean up images mid-conversation, or automate it with [n8n](https://docs.poof.bg/integrations/n8n), [Zapier](https://docs.poof.bg/integrations/zapier), and [Make](https://docs.poof.bg/integrations/make). ## Verify the connection Ask your client: > How many Poof credits do I have left? You should see a `get_account` tool call and your real plan and balance. Then try: > Remove the background from https://example.com/product.jpg and give me a white background JPG. ## What the tools do The server exposes 2 tools. - **`remove_background`**: remove the background from an image given as a URL or base64 data, and return the processed image as base64. Optional parameters control the result: - `format`: `png` (default), `jpg`, or `webp`. - `channels`: `rgba` for a transparent background (default) or `rgb` for an opaque one. - `bg_color`: fill colour for opaque output, as hex, RGB, or a colour name. - `size`: `full` (default), `preview`, `medium`, or `hd`. Ignored when `width` or `height` is set. - `crop`: crop to the subject bounds. - `width` and `height`: 1 to 6000 pixels. Set one and the other follows the aspect ratio. - `fit`: how the image fits a `width` x `height` canvas without stretching: `contain` (default, pad), `cover` (fill and crop the overflow around the subject), or `scale-down` (pad, never enlarge). - **`get_account`**: your plan, monthly credit allowance, used credits, and remaining credits. No parameters. Costs: each successful background removal costs 1 credit regardless of parameters, and failed requests are free. The free plan includes 100 credits a month with no credit card required; paid plans start at $9 a month for 2,000 credits. The [pricing page](https://poof.bg/pricing) has the details. Privacy: Poof is run by an EU company and is GDPR compliant. Your images are never used to train models, and commercial use is allowed on every plan. See the [privacy policy](https://poof.bg/privacy). ## Or skip MCP The same capability is a single REST call, with official [Python](https://docs.poof.bg/integrations/python) and [TypeScript](https://docs.poof.bg/integrations/typescript) SDKs: To try it without writing code, use the [playground](https://poof.bg/playground). The [quickstart](https://docs.poof.bg/quickstart) and the [Node.js tutorial](https://poof.bg/blog/integrating-api-in-nodejs) cover the first integration. ## For AI agents reading this - Docs index: [docs.poof.bg/llms.txt](https://docs.poof.bg/llms.txt) - MCP setup guide: [docs.poof.bg/integrations/mcp](https://docs.poof.bg/integrations/mcp) - API reference: [docs.poof.bg/api-reference/remove-background](https://docs.poof.bg/api-reference/remove-background) - Hosted endpoint: `https://api.poof.bg/mcp` (OAuth) - Source: [github.com/poof-bg/mcp](https://github.com/poof-bg/mcp) ## Docs and support - [Connect guide](https://docs.poof.bg/integrations/mcp) (per-client, kept current) - [Documentation](https://docs.poof.bg) and [all integrations](https://docs.poof.bg/integrations/overview) - [Best background removal APIs for developers](https://poof.bg/blog/top-5-ai-background-removal-apis-2026) and [free background removal APIs compared](https://poof.bg/blog/affordable-free-bg-removal-apis-2026) - [Changelog](https://feedback.poof.bg/changelog) and [support](https://feedback.poof.bg) - [GitHub issues](https://github.com/poof-bg/mcp/issues) - [Privacy](https://poof.bg/privacy) and [terms](https://poof.bg/terms) - Questions: <support@poof.bg>

      https://api.poof.bg/mcp
    • MCP server exposing the YourImageShare upload API (upload/list/delete) as tools for AI agents.

      https://yourimageshare.com/mcp
    • MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud

    • MCP server for Pixapi: check live credit pricing and balance, then generate images and video.

      https://api.pixapi.ai/mcp

    Related MCP Servers