Skip to main content

Set up the Braze MCP server

The Braze MCP server gives AI agents read access to Braze data (Canvas and campaign analytics, custom attributes, segments, and content) without exposing individual user-level PII. This guide covers enrolling in Braze's MCP Server Early Access program, granting the Use MCP Server permission, and connecting the server to MintMCP using per-user OAuth.

Prerequisites​

  • A MintMCP admin account
  • Braze Early Access enrollment for the MCP server: ask your Braze account manager to enroll your organization in the MCP Server Early Access program. Customers who use IP allowlisting cannot participate in Early Access at this time.
  • A Braze admin to grant the Use MCP Server permission to the users who need it, see Enable MCP access below.
  • A valid Braze dashboard account with standard login credentials (SSO/SAML supported).

Enable MCP access​

Braze gates the MCP server behind a dedicated permission. Users don't have it by default, so an admin needs to grant it before anyone can connect.

  1. In Braze, go to Settings > User Management.
  2. Open Company Users to grant access to an individual user, or Roles / Permission Sets to grant it at scale.
  3. Select the user, role, or permission set to edit, and enable the Use MCP Server permission alongside their existing permissions.
  4. Click Update user (or save the role/permission set).

Removing the Use MCP Server permission revokes agent access on the user's next request, and MCP authentication events are logged to Braze's security event report.

Add Braze to MintMCP​

Braze runs two regional MCP endpoints, and each is a separate recommended server in the MintMCP store. Install the one matching your Braze cluster: the wrong region won't reach your organization's data. If you operate in both regions, install both as separate connectors.

RegionRecommended serverBraze cluster
USBraze - USdashboard.braze.com
EUBraze - EUdashboard.braze.eu
  1. In MintMCP, go to MCP store > Manage store.
  2. Find Braze - US or Braze - EU in the list of recommended servers.
  3. Install the entry matching your Braze cluster. The endpoint URL is already set, so there's no URL to enter.
  4. Set Connection type to Per-user credentials.
  5. Set Authorization method to OAuth.
  6. Click Install.

Security considerations​

  • The Use MCP Server permission gates access, but the agent still only sees what the user's Braze dashboard role already allows: a user scoped to a single team rather than the full workspace will find some tools don't work.
  • The server is designed to expose non-PII data only, including Canvas and campaign analytics, custom attributes, and segments, not individual user-level personal data.
  • OAuth ties every action to the signing-in user's identity, so Braze's security event report reflects who authenticated and when.
  • Revoking the Use MCP Server permission cuts off agent access immediately on the user's next request.

Troubleshooting​

  • Can't find the MCP server in Braze: the server is in Early Access. Confirm with your Braze account manager that your organization is enrolled.
  • Enrollment blocked: customers using IP allowlisting cannot participate in Early Access at this time.
  • OAuth consent screen doesn't appear, or the connection fails: confirm the user has the Use MCP Server permission, and that you connected to the endpoint matching your Braze cluster (US vs. EU).
  • Tools return no data or fail: the user's Braze dashboard access may be scoped to a single team rather than the full workspace. MCP access mirrors the user's existing dashboard permissions.
  • Confusing this with the local beta server: a separate, locally hosted Braze MCP server (beta) is deprecated but still available. This guide covers the remote OAuth server at mcp.braze.com / mcp.braze.eu, not the local beta.

Next steps​