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
erase_from_image Erase what a mask covers, context aware (default, also removes its shadow or reflection) or pixel perfect
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 2 model — text-to-image or image-to-image. Supports FIBO (Fibo 2) and FIBO_LITE model variants, and an optional style look for text-to-image on FIBO: kodak_film, hard_flash, hazy_dreamy or rough_realism.

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.6.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.6.0
File Size Uploaded Provenance Actions
bria_mcp-2.6.0.tar.gz 25.5 kB Without provenance Details for bria_mcp-2.6.0.tar.gz

Built distribution (wheel)

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

Total release size: 54.9 kB

Release files / bria_mcp-2.6.0.tar.gz

Download URL bria_mcp-2.6.0.tar.gz
Size 25.5 kB
Tags Source
SHA-256 checksum
How to use checksums
0782cb1e3aa8df386256893b4dfb58586da3448a81b4eda6a6fba7b94efb86a4
BLAKE2b-256 checksum
How to use checksums
2545cca1c991fbd8a4342c8aa11245685de12c620bd73ecf5d5dfa5bab081f3f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","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.6.0-py3-none-any.whl

Download URL bria_mcp-2.6.0-py3-none-any.whl
Size 29.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d7f0435eaa76fbf4dd43dfebb886b870342102740b76a4f91ba0ea5062cb85d5
BLAKE2b-256 checksum
How to use checksums
0096df0c3173bd7d9bb8d22b7bf4b8484882cd1ac37c6f42be35e03953b2ae75
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","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.6.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