simplypng-mcp
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | HTTP server port (HTTP transport only) | 3000 |
| SIMPLYPNG_API_KEY | Yes | Your SimplyPNG API key | |
| SIMPLYPNG_API_URL | No | Override for staging | https://simplypng.app |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| estimate_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. |
| remove_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." |
| batch_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. |
| get_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. |
| download_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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| amazon-main-image-pipeline | Full workflow to process a product image for Amazon: credit check → background removal with Amazon-compliant settings (white background, centered, 2000×2000, JPG) → poll for completion → download URL. |
| shopify-bulk-listing | Bulk workflow to process multiple product images for Shopify: credit check → batch background removal (white background, centered, 2000×2000, PNG) → poll for batch completion → download URLs. |
| etsy-listing-pipeline | Full workflow to process a product image for Etsy: credit check → background removal with Etsy-recommended settings (white background, centered, 2000×2000, PNG) → poll for completion → download URL. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| amazon-main-image | SimplyPNG options for Amazon main product images. Amazon requires pure white background (RGB 255,255,255), product centered and filling ≥85% of frame, minimum 1000px (2000px+ recommended). Source: sellercentral.amazon.com/help/hub/reference/G1881 |
| shopify-thumbnail | SimplyPNG options for Shopify product images. Shopify recommends 2048×2048px square images; PNG format for best quality. Source: help.shopify.com/en/manual/products/product-media/product-media-types |
| etsy-listing | SimplyPNG options for Etsy listing images. Etsy recommends square images ≥2000px to display well in search results and on listing pages. Source: help.etsy.com/hc/en-us/articles/115015663347 |
| mode-fast | Standard processing: input resized to 2500px max before background removal. 1 credit per image. Best for most use cases. |
| mode-hd | High-definition processing: input preserved up to 4096px. 2 credits per image. Best for large products or when fine edge detail matters. |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/SimplyPNG/simplypng-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server