The Braze MCP server
Learn about the Braze MCP server, a secure connection that lets AI tools like Claude and Cursor access non-PII Braze data to answer questions, analyze trends, and provide insights.
Braze MCP server is in beta. You don’t need to request access to use it. Follow the setup instructions to get started. By using the Braze MCP server, you agree to the Braze Beta Terms. To help us make it better, send your feedback to [email protected].
What is Model Context Protocol (MCP)?
Model Context Protocol, or MCP, is a standard that lets AI agents connect to and work with data from another platform. It has two main parts:
- MCP client: The application where the AI agent runs, such as Cursor or Claude.
- MCP server: A service provided by another platform, like Braze, that defines which tools the AI can use and what data it can access.
About the Braze MCP server
After setting up the Braze MCP server, you can connect AI tools like agents, assistants, and chatbots directly to Braze, allowing them to read aggregated data such as Canvas and Campaign analytics, custom attributes, segments, and more. The Braze MCP server is great for:
- Building AI-powered tools that need Braze context.
- CRM engineers creating multi-step agent workflows.
- Technical marketers experimenting with natural language queries.
The Braze MCP server supports 39 endpoints that do not return data from Braze user profiles. You can choose which endpoints to assign to your Braze API key to control what an agent can access or change.
Only assign the API key permissions you want your agent to have. If you don’t want your agent to make changes in Braze, ensure you leave write permissions off. Agents may try to write data through any permission you grant.
Usage example
You can interact with Braze through natural language using tools like Claude or Cursor. For other examples and best practices, see Using the Braze MCP server.
Frequently Asked Questions (FAQ)
Which MCP clients are supported?
Only Claude and Cursor are officially supported. You must have an account for one of these clients to use the Braze MCP server.
What Braze data can my MCP client access?
MCP clients can access endpoints that don’t return PII. You control which endpoints an agent can use through the permissions you assign to your API key.
Can my MCP client change Braze data?
The server only exposes the /media_library/create write endpoint, which enables you to upload media assets into your media library. If you don’t want your agent to make those changes in Braze, leave the media_library.create permission unchecked when you create your API key.
Can I use a third-party MCP server for Braze?
Using a third-party MCP server for Braze data is not recommended. Only use the official Braze MCP server hosted on PyPi.
Why doesn’t the Braze MCP server offer PII access?
To protect user data while supporting valuable use cases, the server is limited to endpoints that don’t typically return PII. This reduces risk for your workspace and the people in it.
Can I reuse my API keys?
No. You’ll need to create a new API key for your MCP client. Remember to only give your AI tools access to what you’re comfortable with, and avoid elevated permissions.
Is the Braze MCP server hosted locally or remotely?
The Braze MCP server is hosted locally.
Why is Cursor only listing functions?
Check if you’re in ask mode or agent mode. To use the MCP server, you need to be in agent mode.
What do I do when the agent returns an answer that looks incorrect?
When working with tools like Cursor, you may want to try changing the model used. For example, if you have it set to auto, try changing it to a specific model and experiment to find which model performs best for your use case. You can also try starting a new chat and retrying the prompt.
If issues persist, you can email us at [email protected] to let us know. If possible, include a video and expand the call functions so we can see what calls the agent attempted.
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 Braze Support.