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 800px 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.0

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.0
File Size Uploaded Provenance Actions
bria_mcp-2.2.0.tar.gz 18.5 kB Without provenance Details for bria_mcp-2.2.0.tar.gz

Built distribution (wheel)

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

Total release size: 40.0 kB

Release files / bria_mcp-2.2.0.tar.gz

Download URL bria_mcp-2.2.0.tar.gz
Size 18.5 kB
Tags Source
SHA-256 checksum
How to use checksums
4e665add66cfccd79d78cbe4a40e25489c993bfb030bb1493b388eab9c9a7da3
BLAKE2b-256 checksum
How to use checksums
de5cc56a5798741b132e9297d1d779f78756d68a27ead8047e60bce88c42eff4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.21 {"installer":{"name":"uv","version":"0.12.21","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.0-py3-none-any.whl

Download URL bria_mcp-2.2.0-py3-none-any.whl
Size 21.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8493eddc7f5e73d074ff123547b051cb470932cc2feaeae682db6a89bddaae97
BLAKE2b-256 checksum
How to use checksums
c65c507cd1f204349ab885e125bcfb5d0c9c2bf5520647c7da6f8ce00cc86fcc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.21 {"installer":{"name":"uv","version":"0.12.21","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.0

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