Braze Universal MCP Server

What is Braze Universal MCP Server about?

The Braze Universal MCP Server implements a Model Context Protocol (MCP) service that exposes Braze's marketing and engagement capabilities via a common, language‑agnostic API. It allows developers to call Braze functionality (such as user profiling, campaign triggers, and analytics) without dealing with Braze‑specific SDKs.

How to use Braze Universal MCP Server?

1. Prerequisites – Install Python 3.11+ and the uv package manager.
2. Install dependencies – Run uv sync to create a virtual environment and install the project's packages.
3. Start the MCP inspector – Execute mcp dev src/universal_mcp_braze/server.py to launch the server locally and obtain the address/port.
4. Register the application – Use mcp install src/universal_mcp_braze/server.py so the service becomes discoverable by other MCP‑compatible tools.
5. Consume the API – From any MCP client, call the exposed Braze tools (listed in src/universal_mcp_braze/README.md).

Key features of Braze Universal MCP Server

• Unified MCP interface – Consistent request/response schema across all Braze endpoints.
• Python‑first implementation – Leverages the Universal MCP framework for rapid development.
• Local development workflow – Simple commands (uv sync, mcp dev, mcp install) for rapid iteration.
• Extensible toolset – All Braze operations are defined as separate tools under src/universal_mcp_braze/app.py.
• MIT licensed – Free to use and modify.

Use cases of Braze Universal MCP Server

• Customer engagement automation – Trigger Braze campaigns from custom business logic without embedding Braze SDKs.
• Cross‑service orchestration – Combine Braze actions with other MCP services (e.g., data analytics, recommendation engines) in a single workflow.
• Testing & prototyping – Run a local Braze mock server to validate integration before deploying to production.
• Multi‑language clients – Any language that supports MCP can interact with Braze through this server.

FAQ from the Braze Universal MCP Server

Q: Do I need a Braze account to run the server? A: Yes. The server forwards calls to Braze’s REST endpoints, so a valid Braze API key and project configuration are required (set via environment variables in .env).

Q: Can I run this server in production? A: Absolutely. Deploy the same entry point (src/universal_mcp_braze/server.py) to any environment that supports Python 3.11+, and configure the necessary Braze credentials.

Q: How do I add new Braze operations? A: Implement additional tool classes in src/universal_mcp_braze/app.py following the existing pattern and update the README for the tool list.

Q: Is there built‑in authentication for the MCP server? A: Authentication is handled by the underlying MCP framework; you can configure additional security layers (e.g., API tokens) as needed.

Braze Universal MCP Server

This repository contains an implementation of an Braze Universal MCP (Model Context Protocol) server. It provides a standardized interface for interacting with Braze's tools and services through a unified API.

The server is built using the Universal MCP framework.

This implementation follows the MCP specification, ensuring compatibility with other MCP-compliant services and tools.

Usage

You can start using Braze directly from agentr.dev. Visit agentr.dev/apps and enable Braze.

If you have not used universal mcp before follow the setup instructions at agentr.dev/quickstart

Available Tools

The full list of available tools is at ./src/universal_mcp_braze/README.md

Local Development

📋 Prerequisites

Ensure you have the following before you begin:

• Python 3.11+ (recommended)
• uv (install globally with pip install uv)

🛠️ Setup Instructions

Follow the steps below to set up your development environment:

1. Sync Project Dependencies

   uv sync
   

   This installs all dependencies from pyproject.toml into a local virtual environment (.venv).

2. Activate the Virtual Environment

   For Linux/macOS:

   source .venv/bin/activate
   

   For Windows (PowerShell):

   .venv\Scripts\Activate
   

3. Start the MCP Inspector

   mcp dev src/universal_mcp_braze/server.py
   

   This will start the MCP inspector. Make note of the address and port shown in the console output.

4. Install the Application

   mcp install src/universal_mcp_braze/server.py
   

📁 Project Structure

.
├── src/
│   └── universal_mcp_braze/
│       ├── __init__.py       # Package initializer
│       ├── server.py            # Server entry point
│       ├── app.py            # Application tools
│       └── README.md         # List of application tools
├── tests/                    # Test suite
├── .env                      # Environment variables for local development
├── pyproject.toml            # Project configuration
└── README.md                 # This file

📄 License

This project is licensed under the MIT License.

---

Generated with MCP CLI — Happy coding! 🚀