simplypng-mcp
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@simplypng-mcp remove background from the product photo"
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.
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 |
| Check credit cost before processing |
| Remove background from a single image |
| Remove backgrounds from up to 50 images |
| Poll status of a single job or batch |
| Get signed download URL for a completed job |
Related MCP server: forgemesh-imagegen
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 buildAdd 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/mcpEnvironment Variables
Variable | Required | Default | Description |
| Yes | — | Your SimplyPNG API key |
| No |
| Override for staging |
| No |
| 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 ( | 2 credits (4096px max) |
Use estimate_credits before processing to verify you have sufficient balance.
License
MIT — see LICENSE
Available Tools
5 toolsbatch_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
Scored across 5 tools
Each tool has a clearly distinct purpose: estimating credits, removing backgrounds singly or in batches, polling job status, and downloading results. No overlap.
All tool names follow a consistent verb_noun pattern in snake_case: download_results, estimate_credits, remove_background, batch_remove_background, get_job_status.
5 tools tightly cover the service's workflow without redundancy. The count is appropriate for a focused background removal MCP server.
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
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>
MCP server exposing the YourImageShare upload API (upload/list/delete) as tools for AI agents.
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.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP Server that integrates with Stability AI's API to provide high-quality image generation, editing, and manipulation capabilities including background removal, outpainting, search-and-replace, and upscaling.84MIT

forgemesh-imagegenofficial
AlicenseAqualityBmaintenanceMCP server for AI image generation with automatic USDC payments on Base mainnet. Generate, remove backgrounds, and upscale images via simple tool calls.4851 npm1MIT- AlicenseNot gradedqualityCmaintenanceMCP server for generating, editing, and processing images via multiple providers including Kilo, OpenRouter, OpenAI, and Gemini, with local tools for background removal, resizing, and cropping.16 npm3MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides image generation using Google's Nano Banana Gemini models, with additional tools for background removal, upscaling, and format conversion via deterministic post-processing.1MIT