# Braze MCP for AI Agents MCP

> Braze lets you manage customer engagement directly from your AI client. Track user behavior, list campaigns, trigger specific journeys (Canvases), or export profile data using simple conversational prompts.

## Overview
- **Category:** growth-engine
- **Price:** Free
- **Tags:** customer-engagement, user-segmentation, campaign-management, omnichannel, event-tracking, personalization

## Description

Managing marketing automation usually means jumping between dashboards and writing complex API calls. This MCP changes that. It connects the full power of Braze to any compatible AI agent, letting you orchestrate entire user tracking workflows just by talking to your client.

Need to know if a segment is ready for a promotion? Ask your agent to list all existing campaigns or check detailed metadata on a specific one. Want to update a user's status? You can track new attributes and events instantly, even identifying anonymous users who need proper profile merging. Need compliance data? Export the necessary user profiles by their external ID. The system also lets you inspect multi-step journeys, triggering users into the exact Canvas workflow they need right now. It’s about treating your entire customer engagement stack like a conversational chat.

## Tools

### get_canvas_details
Fetches detailed information about a specific multi-step Canvas journey.

### track_user
Records new attributes or user events against an existing profile.

### trigger_campaign
Manually sends out an API-triggered marketing campaign to defined users.

### trigger_canvas
Forces a specific user into a defined Canvas workflow.

### delete_user
Removes a user profile entirely using their external ID for compliance.

### export_user_ids
Generates and exports detailed profile data based on provided external IDs.

### get_campaign_details
Retrieves all the setup details for a specific marketing campaign.

### identify_user
Merges or updates user aliases to ensure accurate identification via an external ID.

### list_campaigns
Lists every active and inactive marketing campaign configured in Braze.

### list_canvases
Retrieves a list of all defined multi-step Canvas journeys available for use.

## Prompt Examples

**Prompt:** 
```
What campaigns are active right now, and what's the status of the 'Holiday Promo'?
```

**Response:** 
```
**Campaign Status Report**

*   **Total Active Campaigns:** 3
*   **Welcome Series (ID: camp_1):** Live. Last send: Today.
*   **Abandoned Cart (ID: camp_2):** Needs review. Next scheduled run: Tomorrow.
*   **Holiday Promo (ID: camp_3):** **ACTIVE.** Ready to trigger for segment 'High Value'.

Use the `get_campaign_details` tool for full setup info.
```

**Prompt:** 
```
I just updated a user's loyalty tier. How do I make sure that change is recorded?
```

**Response:** 
```
**User Attribute Update Success**
The attribute 'loyalty_tier: Gold' was successfully tracked for user `usr_992`. This ensures all future marketing decisions and journey triggers reflect their new status. 

*Action:* `track_user` executed.
*Result:* Data synchronized with Braze.
```

**Prompt:** 
```
I need to get a list of all available user journeys, please.
```

**Response:** 
```
Here are the Canvases currently configured in your workspace:

1.  **Onboarding Journey (ID: can_1):** Status: Active.
2.  **Win-back Flow (ID: can_2):** Status: Draft.
3.  **Reactivation Path (ID: can_3):** Status: Active, last edited: Yesterday.
```

## Capabilities

### Update and track user data
Track new attributes or events for a user profile, identify unknown users by merging aliases to external IDs, or permanently delete profiles when required.

### Manage marketing campaigns
List all current marketing campaigns and retrieve detailed metadata about any specific campaign.

### Initiate user journeys (Canvases)
Inspect configured multi-step Canvases or trigger a specific Canvas workflow for targeted users.

### Export customer data
Programmatically export user profile data using known external identifiers.

## Use Cases

### Handling anonymous user segmentation
A new visitor signs up but their details aren't fully merged. The agent is asked to identify the person, using `identify_user` to merge a known alias with the external ID, ensuring they get the correct welcome journey.

### Testing an urgent promotion rollout
Marketing needs to verify if the 'Black Friday' campaign is ready. The agent lists all campaigns using `list_campaigns` and retrieves detailed metadata on the specific ID, confirming it can be triggered.

### Auditing user compliance records
The legal team requires a list of all profiles associated with a given external ID. The agent uses `export_user_ids` to pull the necessary data for review.

## Benefits

- You gain instant visibility into your campaigns. Instead of logging into the platform to check campaign status, you simply ask your agent to list all campaigns using `list_campaigns`.
- Managing user data is cleaner. Need to update a loyalty tier or track a new event? Use `track_user` and let your agent handle the API call for you.
- Journey control becomes conversational. If a user needs to restart their onboarding, you just tell your agent to trigger that specific Canvas using `trigger_canvas`.
- Compliance is simplified. When you need to delete records, running `delete_user` through your agent handles the process safely and accurately.
- Data retrieval is immediate. Instead of building a complex export request, you can use `export_user_ids` and get profile data programmatically.

## How It Works

The bottom line is that talking to your AI agent becomes the single point of control for all your customer journey logic in Braze.

1. Subscribe to this MCP and provide your Braze REST API Key and Base URL.
2. Your AI agent reads the available tools, understanding which operations you need (e.g., tracking attributes or listing campaigns).
3. You ask your client a natural language question, and it translates that request into an actionable tool call against Braze.

## Frequently Asked Questions

**How do I use the Braze MCP to manage user segments?**
You track attributes and events using the MCP. This allows you to update a user's status or profile data, ensuring that segmentation rules are always based on the most current information in your system.

**Can I use this Braze MCP for compliance tasks?**
Yes. If you need to delete specific user profiles or export sensitive data for legal review, the MCP handles these actions using the dedicated tools, ensuring a clean and verifiable process.

**What is the easiest way to start a customer journey? Does Braze MCP help?**
You can use the MCP to list all available Canvases first. Once you know which journey ID you need, you can instruct your agent to trigger that specific Canvas for any user.

**Does the Braze MCP let me test campaigns before sending them?**
Yes. You can list all campaigns and retrieve detailed metadata on a campaign using `get_campaign_details` so you know exactly what it does before hitting send.

**Is this Braze MCP compatible with my existing AI client like Claude or Cursor?**
Yes. This MCP is designed to connect to any compatible AI agent, allowing your preferred tool—whether it's in an IDE or a chat interface—to manage your Braze workflows.