MCP Server

removecolor.online is available as a Model Context Protocol server. Connect it to Claude Code, Cursor, Codex, or any MCP-compatible agent to remove colors and convert images to grayscale directly from your AI workflow. MCP shares the same account, API keys, and credit balance as the REST API.

Endpoint

https://removecolor.online/mcp

Transport: Streamable HTTP (stateless). Each request is independent — no session management required.

Authentication

Send your API key as a Bearer token — the same live key (rc_live_…) used for the REST API. Create one in Dashboard → API Keys.

Authorization: Bearer rc_live_YOUR_KEY

Test keys (rc_test_…) are not accepted on the production endpoint.

Available Tools

remove_color_from_image1 credit

Remove a target color (or a connected color region) and return a transparent PNG. Identical algorithm and parameters as the REST API.

{
  "image_base64": "…",          // required: PNG/JPEG/WebP, ≤ 5 MB
  "target_color": "#00FF00",    // hex color to remove
  "sample_x": 10,               // or sample the color at (x, y)
  "sample_y": 10,               //   (also the connected-mode seed)
  "tolerance": 20,              // 0–100, default 20
  "mode": "global",             // "global" | "connected", default "global"
  "edge_smooth": 2              // 0–10, default 2
}

With both target_color and a sample point, the hex color is the removal target and the point acts as the connected-mode seed. connected removes only the region connected to the seed point.

convert_image_to_grayscale1 credit

Convert an image to grayscale using the Rec.709 luminance standard.

{
  "image_base64": "…"          // required: PNG/JPEG/WebP, ≤ 5 MB
}

get_image_processing_capabilitiesfree

Returns supported formats, size/pixel limits, processing options, and per-operation credit costs. Takes no arguments and costs nothing.

Result Format

Successful tool calls return the processed image as an image content block (base64 PNG) plus a metadata block:

{
  "operation": "remove_color",
  "mime_type": "image/png",
  "width": 1920, "height": 1080,
  "credits_used": 1,
  "credits_remaining": 41,
  "removed_pixels": 812344,      // remove_color only
  "removed_percent": 39.1
}

Credits

Each successful remove_color_from_image or convert_image_to_grayscale call costs exactly 1 credit — the same balance as the REST API.
get_image_processing_capabilities is free.
Failed calls cost 0 credits — including invalid input, unsupported images, oversized images, insufficient credits, rate limits, and processing errors.
Out of credits? Recharge at Settings → Credits.

Image Limits

Input formats: PNG, JPEG, WebP (validated by content, not filename).
Base64 payload: decoded image must be ≤ 5 MB per tool call.
Maximum 25 megapixels; maximum dimension 8192 × 8192.
Output format: PNG (with transparency for color removal).
Remote image URLs are not accepted in v1 — send the image as base64. For larger files, use the REST API multipart upload (up to 20 MB).

Client Configuration

Replace rc_live_YOUR_KEY with your own key — never commit real keys.

Claude Code

claude mcp add --transport http removecolor https://removecolor.online/mcp \
  --header "Authorization: Bearer rc_live_YOUR_KEY"

Or in .mcp.json / ~/.claude.json:

{
  "mcpServers": {
    "removecolor": {
      "type": "http",
      "url": "https://removecolor.online/mcp",
      "headers": {
        "Authorization": "Bearer rc_live_YOUR_KEY"
      }
    }
  }
}

Cursor

Settings → MCP → Add server, or in ~/.cursor/mcp.json:

{
  "mcpServers": {
    "removecolor": {
      "url": "https://removecolor.online/mcp",
      "headers": {
        "Authorization": "Bearer rc_live_YOUR_KEY"
      }
    }
  }
}

Other MCP clients

Any client supporting Streamable HTTP remote servers works: point it at the endpoint URL and set the Authorization: Bearer header.

Error Handling

Failed tool calls return isError: true with a structured error. Codes mirror the REST API:

UNAUTHORIZED	Missing, invalid, or revoked API key (HTTP 401).
INVALID_INPUT	Malformed arguments — bad base64, invalid hex, out-of-range tolerance, connected mode without a sample point.
UNSUPPORTED_IMAGE	Bytes are not a decodable PNG/JPEG/WebP image.
IMAGE_TOO_LARGE	Over the 5 MB (decoded) / 25 MP / 8192 px limits.
INSUFFICIENT_CREDITS	Balance below 1 credit. Response includes credits_available and a recharge_url.
RATE_LIMITED	Per-minute or daily abuse limit hit (HTTP 429).
PROCESSING_FAILED	Decoding or processing failed / timed out. Nothing was charged.
INTERNAL_ERROR	Unexpected server error. Nothing was charged.

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "You do not have enough credits…",
    "credits_required": 1,
    "credits_available": 0,
    "recharge_url": "https://removecolor.online/settings/credits"
  }
}

Privacy

Web tools (removecolor.online homepage and grayscale converter): images are processed entirely in your browser and never leave your device.
MCP & REST API: images are uploaded to removecolor.online servers for processing — this is how server-side APIs work. Images are processed in memory and never permanently stored; only usage metadata (byte size, dimensions, timing) is recorded for billing.