Repository avatar
Multimedia
v1.0.0
active

nukebg

io.github.nukebg/nukebg

Remove image backgrounds, remove objects and upscale images. Transparent PNG or Amazon-ready white.

Documentation

NukeBG MCP server

NukeBG runs a remote Model Context Protocol server, so AI assistants and agents (Claude, Cursor, VS Code, Windsurf and others) can remove backgrounds, remove objects and upscale images with your NukeBG credits.

Tools

ToolWhat it doesCredits
remove_backgroundTransparent cutout, or the subject on white, a colour, gradient or built-in scene, at an optional marketplace size1 (HD 2, Ultra 4)
erase_objectsRemoves what you describe ("the cables on the desk"); the rest stays pixel for pixel25 (enhance 40)
upscale_image2× or 4× Real-ESRGAN upscale2 or 4
get_creditsBalance and planfree

Inputs are a public image_url or image_base64. Results come back as a download link valid for 24 hours, plus the image inline when it's under 1.5 MB. Failed calls are never charged.

Connect a client

Create an API key at https://nukebg.com/account first.

Claude Code

claude mcp add --transport http nukebg https://api.nukebg.com/mcp --header "X-Api-Key: YOUR_KEY"

Cursor (~/.cursor/mcp.json) and Windsurf

{
  "mcpServers": {
    "nukebg": {
      "url": "https://api.nukebg.com/mcp",
      "headers": { "X-Api-Key": "YOUR_KEY" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "nukebg": {
      "type": "http",
      "url": "https://api.nukebg.com/mcp",
      "headers": { "X-Api-Key": "${input:nukebg-key}" }
    }
  },
  "inputs": [{ "id": "nukebg-key", "type": "promptString", "description": "NukeBG API key", "password": true }]
}

Claude Desktop (claude_desktop_config.json, through the mcp-remote bridge)

{
  "mcpServers": {
    "nukebg": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.nukebg.com/mcp", "--header", "X-Api-Key:${NUKEBG_API_KEY}"],
      "env": { "NUKEBG_API_KEY": "YOUR_KEY" }
    }
  }
}

Test it

curl -s https://api.nukebg.com/mcp -H "content-type: application/json" -H "X-Api-Key: YOUR_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_credits","arguments":{}}}'

Or run the MCP Inspector: npx @modelcontextprotocol/inspector, choose Streamable HTTP, enter the URL and add the X-Api-Key header.

About

NukeBG is a background remover for online sellers and developers, made by VOLODS LTD (England and Wales). New accounts get 50 free credits with no watermark, and failed calls are never charged. The server is hosted; there is nothing to install. Questions: nukebg@volods.com.

No installation packages available.

Remote