Skip to main content

Bria MCP Server

An MCP server that gives AI assistants access to Bria's image and video generation and editing APIs.

Built on Bria's commercially-licensed generative AI, trained exclusively on licensed data.

Quick Start

1. Get an API Token

Sign up at bria.ai and grab your API token. See the authentication docs for details.

2. Set Your API Token

export BRIA_API_TOKEN=<your-token>

3. Run

The fastest way to run is with uvx (no install needed):

uvx bria-mcp

Or install with pip / uv and run directly:

# with pip
pip install bria-mcp

# or with uv
uv pip install bria-mcp

# then run
bria-mcp

4. Configure Your MCP Client

Claude Desktop / Claude Code

Add to your Claude config (claude_desktop_config.json):

{
  "mcpServers": {
    "bria": {
      "command": "uvx",
      "args": ["bria-mcp"],
      "env": {
        "BRIA_API_TOKEN": "<your-token>"
      }
    }
  }
}
Cursor

Add to your Cursor MCP config (.cursor/mcp.json):

{
  "mcpServers": {
    "bria": {
      "command": "uvx",
      "args": ["bria-mcp"],
      "env": {
        "BRIA_API_TOKEN": "<your-token>"
      }
    }
  }
}

Available Tools

Image Editing

Tool Description
remove_background Remove the background from an image
blur_background Apply blur to an image background (intensity 1-5)
crop_out_foreground Remove background and crop tightly around the foreground
increase_resolution Upscale an image by 2x or 4x
expand_image Expand an image or change its aspect ratio using generative AI
generate_background Generate a new background from a text prompt or reference images
erase_foreground Erase the foreground object and generate the area behind it
enhance_image Enhance detail, sharpness, and clarity of an image
edit_image Edit an image with a natural language instruction, optionally combining up to 4 images in total (the one being edited plus references)

Image Generation

Tool Description
text_to_image Generate images using Bria's FIBO model — text-to-image or image-to-image. Supports FIBO and FIBO_LITE model variants.

Ads

Tool Description
ad_to_layers Turn a finished, flat ad image back into editable layers (background, imagery, logo, headline, body copy, CTA). Takes 2-3 minutes; ads over 2048px per side require an enterprise plan

Video Editing

Tool Description
remove_video_background Remove background from a video
increase_video_resolution Upscale video resolution by 2x or 4x
video_mask_by_prompt Create a video mask guided by a text prompt
erase_from_video Erase an object from a video using a mask or text prompt

All image tools accept a URL (recommended) or base64-encoded data as input. Local file paths work only when the server runs on the same machine; the hosted server rejects them.

Examples

Remove the background from this product photo: https://example.com/photo.jpg

Generate an image of a minimalist workspace with natural lighting

Take this image and change its aspect ratio to 16:9

Upscale this video to 4x resolution

Requirements

License

MIT — see LICENSE for details.

Metadata

Release files for bria-mcp 2.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bria-mcp 2.2.1
File Size Uploaded Provenance Actions
bria_mcp-2.2.1.tar.gz 18.5 kB Without provenance Details for bria_mcp-2.2.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for bria-mcp 2.2.1
File Interpreter ABI Platform Actions
bria_mcp-2.2.1-py3-none-any.whl Python 3 none any Details for bria_mcp-2.2.1-py3-none-any.whl

Total release size: 40.0 kB

Release files / bria_mcp-2.2.1.tar.gz

Download URL bria_mcp-2.2.1.tar.gz
Size 18.5 kB
Tags Source
SHA-256 checksum
How to use checksums
a6a2975d295850dee6314fadfcc40d9186a5609a61eefc0ea64bfff0e338b3bc
BLAKE2b-256 checksum
How to use checksums
8c4c45ad8eb652db39affe0d2c53a06e4e1d45e2cc8088de2348d61338c43f91
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / bria_mcp-2.2.1-py3-none-any.whl

Download URL bria_mcp-2.2.1-py3-none-any.whl
Size 21.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6c366db750c5a4853aadb04381de67bf100e279d50ad1dba851cd07974de6513
BLAKE2b-256 checksum
How to use checksums
fada43bad895181ce9931ada553804363217d14b7bdbdcb3db3b3cd8056a7180
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for bria-mcp 2.2.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page