Skip to content
Conduit

mcp server

mcp-braze

A Python server for interacting with the Braze API

TMEFRT/mcp-brazecommunitylistedunreviewed
Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

  • uv (`curl -LsSf https://astral.sh/uv/install.sh | sh`)
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "tmefrt-mcp-braze": {
      "command": "uvx",
      "args": [
        "mcp-braze"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 23, 2026

MCP Braze Integration

A Model context Protocol (MCP) integration for Braze's REST API, allowing you to manage catalogs, emails, segments, and more through a simple interface.

Features

  • Authentication Management

    • Configure Braze API token and base URL
    • Automatic authentication for all API operations

  • Catalog Management

    • Create and list catalogs
    • Add and list catalog items
    • Support for item attributes and metadata

  • Email Management

    • Query hard bounced and unsubscribed emails
    • Update email subscription status
    • Manage spam and blocklist entries
    • Support for subscription groups

  • Segment Management

    • List all segments with pagination
    • Get detailed segment information
    • Support for analytics tracking

Installation

pip install mcp-braze

Configuration

Before using the integration, configure your Braze API credentials:

{
    "api_token": "your-braze-api-token",
    "base_url": "https://rest.iad-01.braze.com"  # Optional, defaults to US-01 instance
}

Usage Examples

Managing Catalogs

# Create a catalog
{
    "name": "products",
    "description": "Our product catalog"
}

# Add items to catalog
{
    "catalog_name": "products",
    "item_id": "prod-123",
    "name": "Sample Product",
    "description": "A great product",
    "attributes": {
        "price": 99.99,
        "category": "electronics"
    }
}

Managing Emails

# Update email subscription
{
    "email": "user@example.com",
    "status": "subscribed",
    "subscription_group_id": "group-123"  # optional
}

# Query bounced emails
{
    "start_date": "2024-01-01",
    "end_date": "2024-03-20",
    "limit": 100,
    "offset": 0
}

Managing Segments

# List segments
{
    "page": 0,
    "sort_direction": "desc"
}

# Get segment details
{
    "segment_id": "your-segment-id"
}

Development

  1. Clone the repository:
git clone https://github.com/TMEFRT/mcp-braze.git
cd mcp-braze
  1. Install dependencies:
pip install -r requirements.txt
  1. Run tests:
pytest

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

↑↓ navigate openesc close