Skip to main content
Glama
Sign In
remove-ac-mcp

remove-ac-mcp

by szp2005
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

remove.ac Official SDKs, CLI & MCP Server (Node.js · Python · MCP · Drop-in remove.bg Migration)

Zero-dependency official developer SDKs, hot-folder CLI, and Model Context Protocol (MCP) server for remove.ac — the dual-mode background removal platform pairing a free on-device WebAssembly studio with a remove.bg-compatible Cloud GPU REST API (POST https://remove.ac/v1.0/removebg).

Key Capabilities

  • 1:1 remove.bg v1.0 Field Compatibility: Swap https://api.remove.bg/v1.0/removebg to https://remove.ac/v1.0/removebg using standard X-Api-Key: rac_live_... headers and form fields (image_file, image_file_b64, image_url, size, format, channels, type, roi, crop, crop_margin, scale, position, bg_color, bg_image_url, add_shadow, shadow_type, shadow_opacity, semitransparency).

  • Up to 25 MB / 40 MP Zero-Disk Direct GPU Streaming: Payloads above 4 MB automatically negotiate a short-lived HMAC ticket (POST /v1.0/removebg/ticket) and stream directly to ephemeral GPU RAM without disk or database blob persistence.

  • Atomic Credit Holds (Idempotency-Key): Upstream timeouts or errors automatically release held credits with zero charge. Every verified account starts with 1 free credit; pay-as-you-go credit packs never expire.

  • Zero External Runtime Dependencies: The Node.js 18+ SDK, CLI, MCP stdio server, and Python 3.8+ SDK run purely on standard library primitives (fetch/crypto in Node, urllib in Python).

Related MCP server: techtenstein-bg-mcp

1. Quick curl Migration

curl -X POST https://remove.ac/v1.0/removebg \
  -H "X-Api-Key: rac_live_your_key_here" \
  -F "image_file=@photo.jpg" \
  -F "size=full" \
  -o cutout.png

2. Node.js / TypeScript SDK (Node 18+)

Install via npm or GitHub

npm install remove-ac
# or directly from GitHub:
npm install github:szp2005/remove-ac-sdk

Usage

import fs from "node:fs";
import { RemoveAcClient } from "remove-ac";

const client = new RemoveAcClient({
  apiKey: process.env.REMOVE_AC_API_KEY, // rac_live_...
});

// Files > 4 MB (up to 25 MB) automatically use /v1.0/removebg/ticket zero-disk GPU streaming
const result = await client.removeBackground("./studio-shot-18mb.png", {
  size: "full",
  format: "png",
  shadowType: "contact",
});

fs.writeFileSync("./studio-shot-cutout.png", result.buffer);
console.log(`Saved ${result.width}x${result.height} (${result.creditsCharged} credit)`);

3. CLI & --watch Hot-Folder Batch Tool

Run directly with npx or after installing:

export REMOVE_AC_API_KEY="rac_live_..."

# Process an entire folder with 4 parallel workers
npx github:szp2005/remove-ac-sdk ./input-photos ./output-pngs --concurrency=4 --size=full

# Watch a hot folder continuously and output transparent WebP cutouts
npx github:szp2005/remove-ac-sdk ./incoming ./cutouts --watch --format=webp --crop

4. Python SDK (Python 3.8+, Zero External Dependencies)

Install directly via GitHub

pip install git+https://github.com/szp2005/remove-ac-sdk.git

Native Client

from remove_ac import RemoveAcClient

client = RemoveAcClient()  # reads REMOVE_AC_API_KEY
png_bytes = client.remove_background(
    "product.jpg",
    size="full",
    shadow_type="contact",
)
with open("product-nobg.png", "wb") as fh:
    fh.write(png_bytes)

1:1 removebg Drop-In Replacement Shim

Existing scripts written for from removebg import RemoveBg work without rewriting call sites:

from removebg import RemoveBg

rmbg = RemoveBg("rac_live_your_key_here")
rmbg.remove_background_from_img_file("car.jpg", size="full", new_file_name="car-cutout.png")

5. MCP Server (Claude Desktop · Cursor · Windsurf · Cline)

remove-ac includes a zero-dependency Model Context Protocol (MCP) stdio server (remove-ac-mcp) exposing three tools to AI coding and design agents:

  • remove_background_file — remove background from any local .png / .jpg / .webp up to 25 MB / 40 MP (auto-streams >4 MB via /v1.0/removebg/ticket)

  • remove_background_url — remove background from a public https:// image URL and save locally

  • get_account_balance — inspect remaining remove.ac API credits

Claude Desktop / Cursor Configuration

{
  "mcpServers": {
    "remove-ac": {
      "command": "npx",
      "args": ["-y", "-p", "remove-ac", "remove-ac-mcp"],
      "env": {
        "REMOVE_AC_API_KEY": "rac_live_your_key_here"
      }
    }
  }
}

License

MIT © remove.ac

Tool Schema Changelog

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

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    • Image Background Remover — Small U2NetP, PNG Base64
      io.github.kriton-dev

      Remove image backgrounds with U2NetP and return transparent PNG pixels without identifying metadata

      Image & Video ProcessingAI & Machine Learning
      1
      https://mcp.apify.com/?tools=hermeskd/image-background-remover
    • Editmamei ConnectA
      io.github.editmamei

      Hosted MCP server for AI photo editing: nothing to install, no desktop photo editor needed.

      AI & Machine LearningImage & Video Processing
      531
      https://connect.editmamei.com/mcp
    • Maskr.io MCP ServerA
      io.maskr.mcp

      AI-powered image processing via GPU. Remove backgrounds and upscale images (2x/4x) directly from any MCP client. OAuth 2.1 authenticated, returns processed images inline with download links. Free credits on signup at maskr.io.

      Image & Video ProcessingMultimedia ProcessingApp Automation
      2
      https://mcp.maskr.io/mcp
    • PoofA
      bg.poof.api

      # 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>

      E-commerce & RetailImage & Video ProcessingMarketing
      41
      https://api.poof.bg/mcp

    Related MCP Servers