The Braze MCP server

Learn about the Braze MCP server, a secure, read-only connection that lets AI tools like Claude and Cursor access non-PII Braze data to answer questions, analyze trends, and provide insights without altering data.

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 38 read-only endpoints that do not return data from Braze user profiles. You can choose to assign only some of these endpoints to your Braze API key to further restrict which data an agent can access.

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.

• claude
• cursor

Frequently Asked Questions (FAQ)

Which MCP clients are supported?

Currently, only Claude and Cursor are officially supported. You’ll need an account for one of these clients to use the Braze MCP server.

What Braze data can my MCP client access?

MCP clients can only access read-only endpoints that are not built to retrieve PII. They cannot manipulate data in Braze.

Can my MCP client manipulate Braze data?

No. The MCP server only exposes tools that handle non-PII, read-only data.

Can I use a third-party MCP server for Braze?

Using a third-party MCP server for Braze data is not recommend. Only use the official Braze MCP server hosted on PyPi.

Why doesn’t the Braze MCP server offer PII or write access?

To protect data while still enabling innovation, we have built the server to be limited to endpoints that are read-only and do not typically return PII. This reduces risk while supporting valuable use cases.

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?

Currently, 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 [email protected].