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.1.2

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.1.2
File Size Uploaded Provenance Actions
bria_mcp-2.1.2.tar.gz 17.3 kB Without provenance Details for bria_mcp-2.1.2.tar.gz

Built distribution (wheel)

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

Total release size: 37.8 kB

Release files / bria_mcp-2.1.2.tar.gz

Download URL bria_mcp-2.1.2.tar.gz
Size 17.3 kB
Tags Source
SHA-256 checksum
How to use checksums
eb41a438732452071bd34e7968adc305a925457c1eba98ef9a87a2104281f0a6
BLAKE2b-256 checksum
How to use checksums
4696ddb7dcf4df5c82cfb8f1620c54991a1b606953ce06d42f88a15d5da6307b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.20 {"installer":{"name":"uv","version":"0.12.20","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.1.2-py3-none-any.whl

Download URL bria_mcp-2.1.2-py3-none-any.whl
Size 20.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8b9ad070e23b0df88408c90d755f5cb00d39170caf2bef33579420347cd6e466
BLAKE2b-256 checksum
How to use checksums
e2dd9376c9fc9b279771f258f7bf0d1443e6c7c626cf40a176ec40a9cae65c7e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.20 {"installer":{"name":"uv","version":"0.12.20","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.1.2

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