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), file path, or base64-encoded data as input.
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
- Python 3.10+
- A Bria API token
License
MIT — see LICENSE for details.
Metadata
Release files for bria-mcp 2.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| bria_mcp-2.0.1.tar.gz | 15.2 kB | Without provenance | Details for bria_mcp-2.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| bria_mcp-2.0.1-py3-none-any.whl | Python 3 | none | any | Details for bria_mcp-2.0.1-py3-none-any.whl |
Total release size: 32.5 kB
Release files / bria_mcp-2.0.1.tar.gz
| Download URL | bria_mcp-2.0.1.tar.gz |
|---|---|
| Size | 15.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1ac51ea3003645358db5bfed25985bb787f87a1fb9693faf0434909c9d978bb1
|
|
BLAKE2b-256 checksum How to use checksums |
149967eaad6822a55032f1f1d7ed9b4f000f7e0243a2d06308f467ce5f55a8e8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","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.0.1-py3-none-any.whl
| Download URL | bria_mcp-2.0.1-py3-none-any.whl |
|---|---|
| Size | 17.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
466f5c68515a507a5e773a6b60f02c4bff30ad5282a6a616801baee25f752a09
|
|
BLAKE2b-256 checksum How to use checksums |
c8cf40afc15ff175c13bf078462abd18a26c75695e107f5de964059dc03fea54
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","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.0.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.
