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

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

Built distribution (wheel)

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

Total release size: 37.8 kB

Release files / bria_mcp-2.1.3.tar.gz

Download URL bria_mcp-2.1.3.tar.gz
Size 17.3 kB
Tags Source
SHA-256 checksum
How to use checksums
b9fef28e0a39929183fdba7a4cf84d877f3d8f820db2a1a190d410b9b018c505
BLAKE2b-256 checksum
How to use checksums
56fe7d1adc5cf6a2e37ac75bcfd0553f0f0b72151e0db2609b414dd4791258fb
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.1.3-py3-none-any.whl

Download URL bria_mcp-2.1.3-py3-none-any.whl
Size 20.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c452cc426f3c3287bb7dac1c90a8b39791eb1740c16ef62d24d0cb02ac7e1ac1
BLAKE2b-256 checksum
How to use checksums
00c9cf03677d50baa4e08ba7496eb587c6a264f8e3d164b40c95a3b8187f6502
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.1.3

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