How do I use MCP Braze?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP Braze list my campaigns" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

MCP Braze

by delta-and-beta

Overview Schema Related Servers Score Discussions

TypeScript

Hybrid

MCP Braze

Production-ready MCP server for Braze customer engagement

TypeScript Node.js Tests License

Built with the MCP SDK — Works with Claude Desktop & Claude.ai

Overview

A comprehensive MCP server enabling AI assistants to interact with Braze's customer engagement platform. Features 92 tools covering user management, messaging, campaigns, analytics, email/SMS operations, catalogs, and SCIM provisioning—built for production reliability.

Related MCP server: GHL MCP Server

Δ Capabilities

Core

92 Tools — Users, messaging, campaigns, analytics Multi-Channel — Push, email, SMS, in-app, webhooks Header Auth — Multi-tenant ready architecture

Reliability

Circuit Breaker — Cascading failure prevention Auto-Retry — Exponential backoff with jitter Health Checks — K8s liveness & readiness probes

Security

Input Validation — Zod schemas everywhere Injection Prevention — XSS & path attacks blocked Rate Limiting — Token bucket algorithm

Performance

Request Queue — Concurrency control (10 max) Request Deduplication — Shares concurrent results Response Caching — TTL-based with LRU eviction

Quick Start

npm install && npm run build
node dist/index.js

Configuration

{
  "mcpServers": {
    "braze": {
      "command": "node",
      "args": ["/path/to/mcp-braze/dist/index.js"],
      "env": {
        "BRAZE_API_KEY": "your-api-key",
        "BRAZE_REST_ENDPOINT": "https://rest.iad-01.braze.com"
      }
    }
  }
}

{
  "mcpServers": {
    "braze": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://your-server.com/mcp",
        "--header", "x-braze-api-key:your-api-key",
        "--header", "x-braze-rest-endpoint:https://rest.iad-01.braze.com"
      ]
    }
  }
}

Deploy server with HTTP transport
Claude.ai → Settings → Connectors
Add URL: https://your-server.com/mcp
Add headers: x-braze-api-key, x-braze-rest-endpoint

Platform	Config Path
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`

→ Get your API key

β Tools

Category	Tools
Users	`users_track` · `users_identify` · `users_alias_new` · `users_alias_update` · `users_delete` · `users_merge` · `users_external_id_rename` · `users_external_id_remove`
Messaging	`messages_send` · `campaigns_trigger_send` · `canvas_trigger_send` · `transactional_email_send` · `send_id_create` · `live_activity_update`
Scheduling	`scheduled_broadcasts_list` · `messages_schedule_create` · `messages_schedule_update` · `messages_schedule_delete` · `campaigns_schedule_create` · `campaigns_schedule_update` · `campaigns_schedule_delete` · `canvas_schedule_create` · `canvas_schedule_update` · `canvas_schedule_delete`
Exports	`campaigns_list` · `campaigns_details` · `campaigns_analytics` · `sends_analytics` · `canvas_list` · `canvas_details` · `canvas_analytics` · `canvas_summary` · `segments_list` · `segments_details` · `segments_analytics` · `users_export` · `users_export_segment` · `users_export_control_group` · `kpi_dau` · `kpi_mau` · `kpi_new_users` · `kpi_uninstalls` · `events_list` · `events_analytics` · `purchases_products` · `purchases_quantity` · `purchases_revenue` · `sessions_analytics`
Email	`email_hard_bounces` · `email_unsubscribes` · `email_subscription_status` · `email_bounce_remove` · `email_spam_remove` · `email_blocklist` · `email_blacklist`°
SMS	`sms_invalid_phones` · `sms_invalid_phones_remove`
Subscriptions	`subscription_status_get` · `subscription_user_status` · `subscription_status_set` · `subscription_status_set_v2`
Templates	`email_templates_list` · `email_templates_info` · `email_templates_create` · `email_templates_update` · `content_blocks_list` · `content_blocks_info` · `content_blocks_create` · `content_blocks_update`
Catalogs	`catalogs_list` · `catalogs_create` · `catalogs_delete` · `catalog_items_list` · `catalog_items_create` · `catalog_items_update` · `catalog_items_edit` · `catalog_items_delete` · `catalog_item_get` · `catalog_item_create` · `catalog_item_update` · `catalog_item_edit` · `catalog_item_delete`
Preferences	`preference_centers_list` · `preference_center_get` · `preference_center_url` · `preference_center_create` · `preference_center_update`
SCIM	`scim_users_search` · `scim_users_get` · `scim_users_create` · `scim_users_update` · `scim_users_delete`

° Deprecated — use email_blocklist instead

Usage

"Track a purchase event for user123 with amount $99.99"

"Send the welcome campaign to users who signed up today"

"Get campaign analytics for the last 30 days"

"List all users in the Premium segment"

"Create a new email template for order confirmations"

Authentication

Priority	API Key	REST Endpoint
1	`x-braze-api-key` header	`x-braze-rest-endpoint` header
2	`Authorization: Bearer` header	`restEndpoint` parameter
3	`brazeApiKey` parameter	`BRAZE_REST_ENDPOINT` env
4	`BRAZE_API_KEY` env	—

Braze REST Endpoints

Region	Endpoint
US-01	`https://rest.iad-01.braze.com`
US-02	`https://rest.iad-02.braze.com`
US-03	`https://rest.iad-03.braze.com`
US-04	`https://rest.iad-04.braze.com`
US-05	`https://rest.iad-05.braze.com`
US-06	`https://rest.iad-06.braze.com`
US-07	`https://rest.iad-07.braze.com`
US-08	`https://rest.iad-08.braze.com`
EU-01	`https://rest.fra-01.braze.eu`
EU-02	`https://rest.fra-02.braze.eu`

Find your endpoint in Braze Dashboard → Settings → APIs and Identifiers

Stability & Resilience

Auto-retries on HTTP 429, 500, 502, 503, 504
Handles network errors (ECONNRESET, ETIMEDOUT, ECONNREFUSED)
Respects Retry-After headers
Configurable max retries, delays, jitter

Prevents cascading failures:

CLOSED — Normal operation
OPEN — Fast-fail mode (5 failures trigger)
HALF_OPEN — Recovery testing

Timeout: 30s default (AbortController)
Deduplication: Shares identical concurrent requests
Queue: Limits to 10 concurrent requests
Rate Limiting: Token bucket algorithm

Kubernetes-ready probes:

health — Full status report
liveness — Alive check
readiness — Traffic ready

Deployment

FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --production
COPY dist ./dist
EXPOSE 3000
CMD ["node", "dist/index.js"]

docker build -t mcp-braze .
docker run -p 3000:3000 \
  -e BRAZE_API_KEY=your-key \
  -e BRAZE_REST_ENDPOINT=https://rest.iad-01.braze.com \
  mcp-braze

# Server
PORT=3000
NODE_ENV=production

# Auth (prefer headers in production)
BRAZE_API_KEY=
BRAZE_REST_ENDPOINT=
BRAZE_APP_ID=

# Rate Limiting
RATE_LIMIT_ENABLED=true
RATE_LIMIT_REQUESTS_PER_SECOND=10

# Caching
CACHE_ENABLED=true
CACHE_TTL_SECONDS=300
CACHE_MAX_SIZE=1000

# Circuit Breaker
CIRCUIT_BREAKER_ENABLED=true
CIRCUIT_BREAKER_THRESHOLD=5
CIRCUIT_BREAKER_RESET_TIMEOUT=60000

# Logging
LOG_LEVEL=info

# Sentry (Optional)
SENTRY_DSN=
SENTRY_ENVIRONMENT=production

Architecture

src/
├── index.ts                 # Entry point
├── server.ts                # MCP server init
├── tools/                   # 92 tools
│   ├── users.ts
│   ├── messaging.ts
│   ├── scheduling.ts
│   ├── exports.ts
│   ├── email.ts
│   ├── sms.ts
│   ├── subscriptions.ts
│   ├── templates.ts
│   ├── catalogs.ts
│   ├── preference-center.ts
│   └── scim.ts
└── lib/                     # Core utilities
    ├── auth.ts              # API key extraction
    ├── client.ts            # Braze HTTP client
    ├── validation.ts        # Zod schemas
    ├── errors.ts            # Error handling
    ├── retry.ts             # Backoff
    ├── circuit-breaker.ts   # Failure prevention
    ├── rate-limiter.ts      # Token bucket
    ├── cache.ts             # TTL cache
    ├── request-queue.ts     # Concurrency
    ├── deduplication.ts     # Request dedup
    ├── idempotency.ts       # Safe retries
    ├── health.ts            # K8s probes
    ├── logger.ts            # Structured logging
    └── sentry.ts            # Error tracking

~3,500 lines · 154 unit tests · 126 e2e tests

References


MCP Specification	modelcontextprotocol.io
MCP SDK	github.com/modelcontextprotocol/typescript-sdk
mcp-remote	npmjs.com/package/mcp-remote
Braze API	braze.com/docs/api

MIT License

DELTΔ & βETΑ

From Change to What's Next

This server cannot be installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/delta-and-beta/mcp-braze'

If you have feedback or need assistance with the MCP directory API, please join our Discord server