FAPIHUB MCP Server

An MCP server that gives AI agents (Claude Code, Claude Desktop, Cursor, VS Code, Windsurf and others) background-removal tools from FAPIHUB.

Ask your agent things like:

Remove the background from assets/product.jpg

Put every photo in ./team on a solid #F5F5F5 background

Blur the background of portrait.png and add a soft drop shadow to logo.png

The server reads images from your disk, sends them to the FAPIHUB API and saves the results next to the originals.

Preview

One photo, every tool:

Related MCP server: obrobka-mcp

Tools

Every image tool takes image_path (JPG, PNG, WEBP, BMP or GIF, 1 KB to 10 MB) and an optional output_path. Without output_path, the result is saved as <name>_<operation>.<ext> beside the input and never overwrites an existing file.

Colors can be hex (#FF8C00, #FF8C0080) or RGB(A) (255, 140, 0 or 255, 140, 0, 128).

Each image tool call uses one request from your FAPIHUB plan. Invalid inputs (missing file, wrong format, bad size) are caught locally before anything is sent, so they don't use quota. get_usage is free, so agents can check how much quota is left before a large batch:

Plan: Pro (monthly, $15.00)
Status: active
Requests: 1,240 of 7,500 used (16.5%), 6,260 remaining
Successful: 1,225, failed (4xx, counted): 15
Rate limit: 60 requests per minute
Billing period: 2026-10-01 to 2026-11-01 (quota resets on 2026-11-01)

Setup

1. Create an API key in your FAPIHUB dashboard.

2. Install uv, which provides uvx.

3. Add the server to your client using one of the configurations below.

Claude Code

claude mcp add fapihub -e FAPIHUB_API_KEY=bg_live_sk_... -- uvx --from git+https://github.com/Firdavs-coder/fapihub-mcp fapihub-mcp

Claude Desktop, Cursor, Windsurf and other JSON-configured clients

Add this to your client's MCP config (claude_desktop_config.json, .cursor/mcp.json, etc.):

{
  "mcpServers": {
    "fapihub": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/Firdavs-coder/fapihub-mcp", "fapihub-mcp"],
      "env": {
        "FAPIHUB_API_KEY": "bg_live_sk_..."
      }
    }
  }
}

VS Code

Add this to .vscode/mcp.json:

{
  "servers": {
    "fapihub": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/Firdavs-coder/fapihub-mcp", "fapihub-mcp"],
      "env": {
        "FAPIHUB_API_KEY": "bg_live_sk_..."
      }
    }
  }
}

Configuration

Development

git clone https://github.com/Firdavs-coder/fapihub-mcp
cd fapihub-mcp
uv sync
uv run pytest

To try the server against a local FAPIHUB instance:

FAPIHUB_API_KEY=bg_live_sk_... FAPIHUB_BASE_URL=http://127.0.0.1:8000 uv run fapihub-mcp

License

MIT