Metadata-Version: 2.4
Name: techtenstein-bg-mcp
Version: 1.0.0
Summary: MCP server for Techtenstein Background Removal API. Strip backgrounds from images via Claude, Cline, and Cursor.
Project-URL: Homepage, https://apis.techtenstein.com
Project-URL: Documentation, https://bg.api.techtenstein.com
Project-URL: Repository, https://github.com/sathvic-kollu/techtenstein-bg-mcp
Author-email: Sathvic Kollu <sathvic777@gmail.com>
License: MIT
Keywords: ai,api,background-removal,claude,image,mcp,techtenstein
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: fastmcp>=0.2.0
Requires-Dist: requests>=2.31.0
Description-Content-Type: text/markdown

# Techtenstein Background Removal MCP

MCP server that gives your Claude, Cline, or Cursor session the ability to strip
backgrounds from any image — product photos, portraits, cars, or general subjects —
returning a transparent PNG. Powered by the [Techtenstein Background Removal API](https://apis.techtenstein.com).

## Tools exposed

- `remove_background_url(image_url, mode="auto")` — Strip background from an image URL
- `remove_background_base64(image_base64, mode="auto")` — Strip background from a base64 image (user upload)

Modes: `auto`, `product`, `portrait`, `car`.

## Install (Claude Desktop)

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "techtenstein-bg": {
      "command": "uvx",
      "args": ["techtenstein-bg-mcp"],
      "env": {
        "TECHTENSTEIN_API_KEY": "your_key_from_techtenstein.com"
      }
    }
  }
}
```

Restart Claude Desktop. `remove_background_url` and `remove_background_base64` will appear as available tools.

## Install (Cline / VS Code)

Same config path as Claude Desktop — Cline auto-detects.

## Install (Cursor)

Add to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "techtenstein-bg": {
      "command": "uvx",
      "args": ["techtenstein-bg-mcp"],
      "env": {"TECHTENSTEIN_API_KEY": "your_key"}
    }
  }
}
```

## Get an API key

Free tier (30 images/day, no card): https://apis.techtenstein.com

Paid tiers start at $9/month for 1,000 images.

## Example usage

Once installed, ask Claude:

> "Remove the background from this product photo: https://cdn.example.com/shoe.jpg"

Claude will call `remove_background_url` in `product` mode and return a transparent PNG.

Or for a portrait:

> "This is a headshot — cut out just the person: https://example.com/team-photo.jpg"

Claude will call `remove_background_url(image_url, mode="portrait")`.

## Response schema

```json
{
  "png_base64": "iVBORw0KGgoAAAANS...",
  "content_type": "image/png",
  "bytes": 48212
}
```

## Support

- Docs: https://apis.techtenstein.com
- Issues: https://github.com/sathvic-kollu/techtenstein-bg-mcp/issues
- Email: sathvic777@gmail.com

## License

MIT
