Braze MCP server functions
The Braze MCP server exposes a set of read-only API functions that map to specific Braze REST API endpoints. MCP clients like Claude and Cursor can call these functions to retrieve data without accessing PII or making changes to your workspace. For more general information, see Braze MCP server.
important:
Braze MCP Server is currently in beta. Want to help us make it better? Send us feedback at [email protected].
Prerequisites
Before you can use this feature, you’ll need to set up the Braze MCP server.
Available Braze API Functions
These are the API functions that your MCP client references to interact with The Braze MCP server:
General functions
| Function |
Description |
list_functions |
Lists all available Braze API functions with their descriptions and parameters |
call_function |
Calls a specific Braze API function with provided parameters |
Campaigns
| Function |
Endpoint |
Description |
get_campaign_list |
/campaigns/list |
Export a list of campaigns with metadata. |
get_campaign_details |
/campaigns/details |
Get detailed information about specific campaigns. |
get_campaign_dataseries |
/campaigns/data_series |
Retrieve time series analytics data for campaigns. |
Canvases
| Function |
Endpoint |
Description |
get_canvas_list |
/canvas/list |
Export a list of Canvases with metadata. |
get_canvas_details |
/canvas/details |
Get detailed information about specific Canvases. |
get_canvas_data_summary |
/canvas/data_summary |
Get summary analytics for Canvas performance. |
get_canvas_data_series |
/canvas/data_series |
Retrieve time series analytics data for Canvases. |
Catalogs
Cloud Data Ingestion
Content Blocks
Custom Attributes
| Function |
Endpoint |
Description |
get_custom_attributes |
/custom_attributes |
Export custom attributes recorded for your app. |
Events
| Function |
Endpoint |
Description |
get_events_list |
/events/list |
Export a list of custom events recorded for your app. |
get_events_data_series |
/events/data_series |
Retrieve time series data for custom events. |
get_events |
/events |
Get detailed event data with pagination support. |
KPIs
Messages
Preference Centers
Purchases
Segments
| Function |
Endpoint |
Description |
get_segment_list |
/segments/list |
Export list of segments with analytics tracking status. |
get_segment_data_series |
/segments/data_series |
Time series analytics data for segments. |
get_segment_details |
/segments/details |
Detailed information about specific segments. |
Sends
| Function |
Endpoint |
Description |
get_send_data_series |
/sends/data_series |
Daily analytics for tracked campaign sends. |
Sessions
| Function |
Endpoint |
Description |
get_session_data_series |
/sessions/data_series |
Time series data for app session counts. |
SDK Authentication Keys
Subscription
| Function |
Endpoint |
Description |
get_user_subscription_groups |
/subscription/user/status |
List and get the subscription groups of a certain user. |
get_subscription_group_status |
/subscription/status/get |
Get the subscription state of a user in a subscription group. |
Templates
Disclaimer
The Model Context Protocol (MCP) is a newly introduced open-source protocol that may be susceptible to security issues or vulnerabilities at this time.
Braze MCP Server setup code and instructions are provided by Braze “as is” and without any warranties, and customers use it at their own risk. Braze shall not be responsible for any consequences arising from improper setup, misuse of the MCP, or any potential security issues that may arise. Braze strongly encourages customers to review their configurations carefully and to follow the outlined guidelines to reduce risks associated with the integrity and security of their Braze environment.
For assistance or clarification, please contact [email protected].