
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.
- URL:
https://api.nukebg.com/mcp - Transport: Streamable HTTP (stateless, JSON responses)
- Auth: your NukeBG API key in the
X-Api-Keyheader (orAuthorization: Bearer <key>) - Docs: https://nukebg.com/mcp-server
- API reference: https://nukebg.com/docs
Tools
| Tool | What it does | Credits |
|---|---|---|
remove_background | Transparent cutout, or the subject on white, a colour, gradient or built-in scene, at an optional marketplace size | 1 (HD 2, Ultra 4) |
erase_objects | Removes what you describe ("the cables on the desk"); the rest stays pixel for pixel | 25 (enhance 40) |
upscale_image | 2× or 4× Real-ESRGAN upscale | 2 or 4 |
get_credits | Balance and plan | free |
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.