AI Agents (MCP)

The open-source FAPIHub MCP server lets AI agents use the FAPIHub API on files on your computer. It works with Claude Code, Claude Desktop, Cursor, VS Code and Windsurf. Once it’s installed, ask your agent in plain language:

“Remove the background from assets/product.jpg”
“Put every photo in ./team on a #F5F5F5 background”
“How many FAPIHub requests do I have left?”

Results are saved next to the input as <name>_<operation>.png. The server never overwrites an existing file.

Install

Install uv

The server runs with uv. Install it if you don’t have it yet.

Get an API key

Create an API key in the dashboard. Keys look like bg_live_sk_….

Add the server to your agent

Claude Code
Claude Desktop
Cursor
VS Code
Windsurf

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

-s user makes the server available in every project. Without it, the server is added to the current project only.Verify: start a new Claude Code session and run /mcp. fapihub should show as connected with 7 tools.Remove:

claude mcp remove fapihub -s user

Open Settings → Developer → Edit Config. This opens claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the server, with the full path to uvx in "command":

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

Desktop apps on macOS often don’t inherit your shell PATH, so a bare "command": "uvx" fails with spawn uvx ENOENT. Find the full path with which uvx (macOS/Linux) or where uvx (Windows). It’s usually ~/.local/bin/uvx, but write it out in full (for example /Users/you/.local/bin/uvx) because ~ doesn’t work in JSON.

After saving, fully quit Claude Desktop and reopen it.

Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

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

Use the full path to uvx in "command". Find it with which uvx (macOS/Linux) or where uvx (Windows); ~ doesn’t work in JSON.

Verify: in Settings → MCP, fapihub should show as connected.

Add the server to .vscode/mcp.json. The top-level key is servers, not mcpServers:

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

Use the server from Copilot Chat in Agent mode.

Add the server to ~/.codeium/windsurf/mcp_config.json:

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

Use the full path to uvx in "command". Find it with which uvx (macOS/Linux) or where uvx (Windows); ~ doesn’t work in JSON.

Try it

Ask your agent: “Remove the background from assets/product.jpg”.

Test without an AI

Use the MCP Inspector to check the server on its own:

FAPIHUB_API_KEY=bg_live_sk_... npx @modelcontextprotocol/inspector uvx --from git+https://github.com/Firdavs-coder/fapihub-mcp fapihub-mcp

Open the URL it prints.
Click Connect.
Open Tools and choose get_usage.
Click Run. You should see your plan and remaining requests. get_usage is free.

Tools

Tool	Does	Options
`remove_background`	Transparent cutout	`model`
`create_mask`	Subject mask	`model`
`blur_background`	Blurs the background	`radius` (1–50, default 10)
`color_background`	Solid color background	`color`
`gradient_background`	Vertical gradient background	`top_color`, `bottom_color`
`add_shadow`	Drop shadow	`shadow_color`, `offset_x`, `offset_y`, `blur_radius`
`get_usage`	Plan, limits, used/remaining	— (free)

Each image tool takes image_path and an optional output_path.
Colors can be hex (#FF8C00) or RGB(A) (255, 140, 0).

Environment variables

Variable	Required	Default	Description
`FAPIHUB_API_KEY`	Yes	—	Your FAPIHub API key
`FAPIHUB_BASE_URL`	No	`https://fapihub.com`	API base URL
`FAPIHUB_TIMEOUT`	No	`120`	Request timeout in seconds

Quota

Each image tool call uses one request from your quota. get_usage is free.
Invalid inputs (missing file, wrong format, wrong size) are caught locally before anything is sent, so they don’t use quota.

See Rate Limit for your plan’s limits.

Troubleshooting

spawn uvx ENOENT / the server won't start

Use the full path to uvx in "command" (find it with which uvx or where uvx), or install uv first.

"FAPIHUB_API_KEY is not set"

Add the key to the env block of your config, or to the -e flag in Claude Code.

"Authentication failed … Check FAPIHUB_API_KEY"

The key is wrong or deactivated. Create a new one in the dashboard.

"Monthly request limit reached …" (402)

Your quota is used up. Check it with get_usage, and upgrade at fapihub.com/billing.

"Rate limit exceeded. Retry after N seconds."

Wait N seconds, then try again. Retrying is free.

The tools don't appear

Fully restart the app or start a new session. The server is loaded only at startup.

Updates

uvx fetches the latest version from GitHub. To force an update, run uv cache clean fapihub-mcp or restart the app.

fapihub-mcp on GitHub

Source code, issues and the latest install instructions.

Not the same as the docs MCP server. Mintlify also hosts an MCP server for this documentation at https://docs.fapihub.com/mcp. It lets AI tools search these docs; it doesn’t process images. To edit images, use the FAPIHub MCP server above.

Get Started

Endpoints

Integrations

Comparison

Install

Test without an AI

Tools

Environment variables

Quota

Troubleshooting

Updates

fapihub-mcp on GitHub

​Install

​Test without an AI

​Tools

​Environment variables

​Quota

​Troubleshooting

​Updates

fapihub-mcp on GitHub

Install

Test without an AI

Tools

Environment variables

Quota

Troubleshooting

Updates