# How to integrate Braze MCP with Atomic Agent

```json
{
  "title": "How to integrate Braze MCP with Atomic Agent",
  "toolkit": "Braze",
  "toolkit_slug": "braze",
  "framework": "Atomic Agent",
  "framework_slug": "atomic-agent",
  "url": "https://composio.dev/toolkits/braze/framework/atomic-agent",
  "markdown_url": "https://composio.dev/toolkits/braze/framework/atomic-agent.md",
  "updated_at": "2026-09-04T05:31:09.939Z"
}
```

## Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Braze.
This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Braze account. See the [Atomic Agent documentation](https://atomicagent.io/docs/?cta_placement=atomic-agent-docs) for installation instructions.

## Also integrate Braze with

- [ChatGPT](https://composio.dev/toolkits/braze/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/braze/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/braze/framework/hermes-agent)

## TL;DR

### How Atomic Agent connects to Braze
Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.
Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

## Connect Braze to Atomic Agent

### Connect Braze to Atomic Agent
- Sign up or sign in to the [Composio dashboard](https://dashboard.composio.dev/?cta_placement=atomic-agent-api-key). Copy your API key.
- In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
- Ask Atomic Agent to do something in Braze. It searches Composio for the right tool.
- On first use, open the sign-in link returned in the chat. Connect your Braze account, then return to Atomic Agent to continue.
### Headless setup
Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

```bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY
```

## What is the Braze MCP server, and what's possible with it?

The Braze MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Braze account. It provides structured and secure access so your agent can perform Braze operations on your behalf.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `BRAZE_BLOCKLIST_EMAILS` | Blocklist Emails | HIGH IMPACT: globally unsubscribe and mark as hard bounced one to 50 exact email addresses. This can affect every profile sharing an address and prevent delivery across campaigns. Success is rejected unless Braze explicitly returns message=success. Default rate limit: 250,000 requests/hour. |
| `BRAZE_CANCEL_SEGMENT_EXPORTS` | Cancel Segment Exports | Ask Braze to cancel all ongoing exports for a segment. Braze documents no response confirmation schema, so a successful call is only the provider response and must not be treated as proof that cancellation completed. |
| `BRAZE_CREATE_CAMPAIGN_TRIGGER_SCHEDULE` | Schedule Campaign Trigger | HIGH IMPACT: schedule one durable API-triggered campaign dispatch. Provide up to 50 recipients, optionally intersected with a Connected Audience. Audience-only targeting requires broadcast=true, which cannot include individual recipients. Recipient trigger properties override shared keys. Requires a dashboard API-triggered campaign and campaigns.trigger.schedule.create. Acceptance and a schedule ID do not prove delivery. |
| `BRAZE_CREATE_CANVAS_TRIGGER_SCHEDULE` | Schedule Canvas Trigger | HIGH IMPACT: schedule one durable API-triggered Canvas entry. Provide up to 50 recipients, optionally intersected with a Connected Audience. Audience-only targeting requires broadcast=true, which cannot include individual recipients. Per-recipient context overrides shared context. Requires a dashboard API-triggered Canvas and canvas.trigger.schedule.create. Users are recorded as entries only at scheduled time; acceptance is not delivery. |
| `BRAZE_CREATE_CATALOG` | Create Catalog | Create one persistent catalog in the connected Braze workspace. The catalog name must be unique and identifies the resource for later reads or deletion. |
| `BRAZE_CREATE_CATALOG_FIELDS` | Create Catalog Fields | Asynchronously create up to 50 fields in one Braze catalog. Requires the immutable catalogs.create_fields API-key permission and shares a 50 requests/minute limit with asynchronous catalog field and selection endpoints. A 202 response only confirms acceptance; Braze documents no job ID or terminal result. |
| `BRAZE_CREATE_CATALOG_ITEM` | Create Catalog Item | Synchronously create one Braze catalog item by exact item ID. Requires the immutable catalogs.create_item API-key permission and shares a 50 requests/minute synchronous item limit. Existing IDs and body-level id fields are rejected. |
| `BRAZE_CREATE_CATALOG_ITEMS` | Create Multiple Catalog Items | Asynchronously create up to 50 Braze catalog items. Requires the immutable catalogs.add_items API-key permission and shares a 16,000 requests/minute limit with asynchronous catalog item endpoints. A 202 response confirms acceptance only; Braze documents no job ID, per-item result, or terminal completion. |
| `BRAZE_CREATE_CATALOG_SELECTION` | Create Catalog Selection | Asynchronously create one Braze catalog selection. Requires the immutable catalogs.create_selection API-key permission and shares a 50 requests/minute limit with asynchronous field and selection endpoints. Geo filters force nearest-first ordering. Storage and selection-count gates may reject the request. A 202 response confirms acceptance only and includes no documented job result. |
| `BRAZE_CREATE_CONTENT_BLOCK` | Create Content Block | Persist a reusable HTML or text Content Block in the connected Braze workspace. This creates content only; it does not send or deliver a message. |
| `BRAZE_CREATE_EMAIL_TEMPLATE` | Create Email Template | Persist an HTML email template on Braze's Templates & Media page. This creates template content only; it does not send or deliver an email. |
| `BRAZE_CREATE_MEDIA_LIBRARY_ASSET` | Create Media Library Asset | Upload one asset to Braze from a public HTTP(S) URL or local file. URL mode sends JSON; local-file mode uses the multipart asset_file contract implemented by Braze's official MCP server and does not send base64. Images, vectors, and documents are limited to 5 MB; ZIP files are limited to 50 MB total and 5 MB per supported root-level file. Videos and VCF files are dashboard-only. Media Library Public APIs must be enabled; free-trial workspaces have a default 200-asset limit. Rate limit: 100/hour. |
| `BRAZE_CREATE_MESSAGE_SCHEDULE` | Create Message Schedule | HIGH IMPACT: schedule API-only channel messages for future processing. Individual targets are limited to 50 combined IDs and aliases; otherwise explicit broadcast=true is required. Requires messages.schedule.create. The returned schedule and dispatch IDs confirm acceptance only and never delivery; rendered payload size, subscription state, and channel eligibility remain gates. |
| `BRAZE_CREATE_PREFERENCE_CENTER` | Create Preference Center | HIGH IMPACT: durably create and optionally activate a Braze-hosted preference center. Its name cannot be changed after creation. Confirm HTML, state, and identifiers before calling. Limited to 10 requests/minute per workspace; Braze publishes no separate plan-tier gate. |
| `BRAZE_CREATE_SDK_AUTHENTICATION_KEY` | Create SDK Authentication Key | HIGH IMPACT SECURITY OPERATION: create an SDK Authentication key from an RSA public key for one exact app. Set make_primary only when the new key should immediately replace the current primary key. Never submit private-key material. Braze permits at most three keys per app. Success is rejected unless Braze returns a new key ID. Default rate limit: 250,000 requests/hour. |
| `BRAZE_CREATE_SEND_ID` | Create Send ID | Create or assign a send ID for programmatic message-performance tracking. Every explicit campaign_id and send_id combination counts toward the workspace limit of 100 custom send IDs/day. Requires sends.id.create; this action creates tracking identity and does not send a message. |
| `BRAZE_CREATE_USER_ALIASES` | Create User Aliases | Add up to 50 Braze aliases to existing external-ID users or create alias-only profiles. Requires users.alias.new. Duplicate alias-label/name pairs can return success without changing a profile; a 201-style success is acceptance, not proof that every alias was attached. Shares a 20,000 requests/minute rate limit. |
| `BRAZE_DELETE_CAMPAIGN_TRIGGER_SCHEDULE` | Delete Campaign Trigger Schedule | HIGH IMPACT: durably cancel a scheduled API-triggered campaign before send time. This cannot undo sends already processed. Last-second cancellation is best-effort and may affect all, some, or none of the target users. Requires campaigns.trigger.schedule.delete; an accepted response is not proof that no sends occurred. |
| `BRAZE_DELETE_CANVAS_TRIGGER_SCHEDULE` | Delete Canvas Trigger Schedule | HIGH IMPACT: durably cancel a scheduled API-triggered Canvas before entry time. This cannot undo entries already processed. Last-second cancellation is best-effort and may affect all, some, or none of the target users. Requires canvas.trigger.schedule.delete; acceptance is not proof that no Canvas entries occurred. |
| `BRAZE_DELETE_CATALOG` | Delete Catalog | Permanently delete one Braze catalog and all of its contents by exact catalog name through DELETE /catalogs/{catalog_name}. This cannot be undone and requires catalogs.delete permission. |
| `BRAZE_DELETE_CATALOG_FIELD` | Delete Catalog Field | Asynchronously request deletion of one field by exact catalog and field name. Requires the immutable catalogs.delete_fields API-key permission and shares a 50 requests/minute field/selection limit. Fields used by a selection or as an inventory field cannot be deleted. A 202 response is acceptance, not completion. |
| `BRAZE_DELETE_CATALOG_ITEM` | Delete Catalog Item | Request deletion of one catalog item by exact catalog name and item ID. HTTP 202 with message=success confirms acceptance, not terminal deletion. Requires the immutable catalogs.delete_item API-key permission and shares a 50 requests/minute synchronous item limit. |
| `BRAZE_DELETE_CATALOG_ITEMS` | Delete Multiple Catalog Items | Asynchronously request deletion of up to 50 catalog items by exact IDs. Requires the immutable catalogs.delete_items API-key permission and shares a 16,000 requests/minute asynchronous item limit. A 202 response is only request acceptance; Braze returns no documented job ID or per-item deletion proof. |
| `BRAZE_DELETE_CATALOG_SELECTION` | Delete Catalog Selection | Asynchronously request deletion of a selection by exact catalog and selection name. Requires the immutable catalogs.delete_selection API-key permission and shares a 50 requests/minute field/selection limit. A 202 response confirms acceptance only; Braze documents no terminal deletion result. |
| `BRAZE_DELETE_MESSAGE_SCHEDULE` | Delete Message Schedule | HIGH IMPACT: durably cancel an API-only message schedule before it is sent. This cannot undo a send already processed. Requires messages.schedule.delete. An accepted cancellation does not prove that a send already being processed was stopped. |
| `BRAZE_DELETE_SDK_AUTHENTICATION_KEY` | Delete SDK Authentication Key | HIGH IMPACT SECURITY OPERATION: permanently delete one exact non-primary SDK Authentication key from one exact app. Braze refuses deletion of the primary key; select another primary first. Success is rejected unless the returned remaining-key list excludes the exact requested key ID. Default rate limit: 250,000 requests/hour. |
| `BRAZE_DELETE_USERS` | Delete Users | Permanently queue deletion of up to 50 users using exactly one identifier type. Requires users.delete and shares a 20,000 requests/minute rate limit. This cannot be undone; success reports queued count, not completion, and cache propagation can take up to five minutes. |
| `BRAZE_DUPLICATE_CAMPAIGN` | Duplicate Campaign | HIGH IMPACT: request an asynchronous, durable duplicate of a Braze campaign. The duplicate persists until explicitly deleted and can consume workspace campaign capacity. HTTP 202 confirms only that Braze accepted the request, not that campaign creation completed. Existing tags only; a supplied tag list replaces source tags. Requires campaigns.duplicate and is limited to 100 calls/minute. |
| `BRAZE_DUPLICATE_CANVAS` | Duplicate Canvas | HIGH IMPACT: request an asynchronous, durable duplicate of a Braze Canvas. The duplicate persists until explicitly deleted and can consume workspace Canvas capacity. HTTP 202 confirms only acceptance, not completed Canvas creation. Existing tags only; a supplied tag list replaces source tags. Requires canvas.duplicate and is limited to 100 calls/minute. |
| `BRAZE_END_LIVE_ACTIVITY` | End Live Activity | IRREVERSIBLE: end an SDK-registered iOS Live Activity with a final ContentState. An optional past dismissal_date removes it from the UI immediately. Requires messages.live_activity.update. HTTP 201 confirms receipt only, not APNs dispatch, display, dismissal, or delivery. An ended activity cannot be resumed. |
| `BRAZE_EXPORT_GLOBAL_CONTROL_GROUP_USERS` | Export Global Control Group Users | Start an asynchronous export of all current Global Control Group users. The response only acknowledges dispatch and identifies files; completion arrives through the callback, temporary URL, or configured cloud storage. Files are generally split per 5,000 users. |
| `BRAZE_EXPORT_SEGMENT_USERS` | Export Segment Users | Start an asynchronous newline-delimited JSON export for one segment. The response acknowledges dispatch, not completion. Only one export per segment may run at once, with at most 100 concurrent segment exports company-wide; event, purchase, campaign, and Canvas history fields contain 90 days of detail. |
| `BRAZE_EXPORT_USERS_BY_IDENTIFIERS` | Export Users by Identifiers | Return user profiles matching one or more Braze, external, alias, device, email, or phone identifiers; this reads profiles and does not track events or consume data points. |
| `BRAZE_GENERATE_PREFERENCE_CENTER_URL` | Generate Preference Center URL | Generate a user-specific URL for an API-created or drag-and-drop Braze preference center. HIGH IMPACT: the returned URL is a sensitive capability that can change that user's subscriptions. Do not log, publish, or share it. This does not support legacy preference centers. Limited to 1,000 requests/minute per workspace. |
| `BRAZE_GET_CAMPAIGN` | Get Campaign | Return configuration and delivery details for one campaign identified by its Braze campaign ID. |
| `BRAZE_GET_CAMPAIGN_ANALYTICS` | Get Campaign Analytics | Get up to 100 daily campaign analytics points. Dashboard and Currents aggregation definitions can differ. |
| `BRAZE_GET_CAMPAIGN_TRANSLATION_SOURCE` | Get Campaign Translation Source | Read the default source values inside translation tags for one campaign message variation. Requires campaigns.translations.get, translation tags on a multi-language message, and observes a 250,000 requests/minute limit. |
| `BRAZE_GET_CANVAS` | Get Canvas | Return configuration and step details for one Canvas identified by its Braze Canvas ID. |
| `BRAZE_GET_CANVAS_ANALYTICS` | Get Canvas Analytics | Export Canvas daily time-series analytics with optional variant, step, and deleted-step breakdowns. Dashboard and Currents definitions can differ. |
| `BRAZE_GET_CANVAS_ANALYTICS_SUMMARY` | Get Canvas Analytics Summary | Export Canvas analytics rollups with optional variant, step, and deleted-step breakdowns. Braze normalizes range timestamps to midnight in the company time zone. |
| `BRAZE_GET_CANVAS_TRANSLATION_SOURCE` | Get Canvas Translation Source | Read default source values inside translation tags for one Canvas step message variation. Requires canvas.translations.get, translation tags on a multi-language message, and observes a 250,000 requests/minute limit. |
| `BRAZE_GET_CATALOG_ITEM` | Get Catalog Item | Return one Braze catalog item by exact catalog name and item ID. Requires the immutable catalogs.get_item API-key permission and shares a 50 requests/minute limit with synchronous catalog item endpoints. |
| `BRAZE_GET_CONTENT_BLOCK` | Get Content Block | Return one persisted Braze Content Block by API identifier, optionally with its current campaign and Canvas inclusion records. |
| `BRAZE_GET_CONTENT_BLOCK_TRANSLATION_SOURCE` | Get Content Block Translation Source | Read default source values inside one Content Block's translation tags. Requires content_blocks.translations.get, configured translation tags, and observes a 250,000 requests/minute limit. |
| `BRAZE_GET_CUSTOM_EVENT_ANALYTICS` | Get Custom Event Analytics | Get 1 to 100 daily or hourly occurrence counts for one custom event, optionally filtered by app and analytics-enabled segment. |
| `BRAZE_GET_EMAIL_TEMPLATE` | Get Email Template | Return one stored HTML email template by API identifier. Braze does not accept drag-and-drop-editor templates on this endpoint. |
| `BRAZE_GET_EMAIL_TEMPLATE_TRANSLATION_SOURCE` | Get Email Template Translation Source | Read default source values inside an email template's translation tags. This source endpoint specifically requires templates.email.info, plus a multi-language template, and observes a 250,000 requests/minute limit. |
| `BRAZE_GET_PREFERENCE_CENTER` | Get Preference Center | Get persisted HTML, state, options, identifiers, and timestamps for one Braze preference center. Limited to 1,000 requests/minute per workspace. |
| `BRAZE_GET_PURCHASE_SERIES` | Get Purchase Series | Get 1 to 100 daily or hourly purchase quantity or revenue points, optionally filtered by app and product. The selected metric determines the exact Braze purchase endpoint. |
| `BRAZE_GET_SEGMENT` | Get Segment | Return Braze's documented configuration details for one segment identified by its segment API identifier. |
| `BRAZE_GET_SEGMENT_ANALYTICS` | Get Segment Analytics | Get up to 100 daily estimated segment-size points. Export and count segment users when an exact size is required. |
| `BRAZE_GET_SEND_ANALYTICS` | Get Send Analytics | Get up to 100 daily analytics points for a tracked send from an API campaign. Braze retains send analytics for 14 days after the send and attributes campaign conversions to the most recent send_id received by each user. Counts may not match dashboard analytics or Currents one-for-one because aggregation windows and definitions differ. |
| `BRAZE_GET_SESSION_ANALYTICS` | Get Session Analytics | Get 1 to 100 daily or hourly session-count points, optionally filtered by app and analytics-enabled segment. |
| `BRAZE_GET_SUBSCRIPTION_GROUP_STATUS` | Get Subscription Group Status | Get saved membership status for up to 50 users in one exact subscription group. External IDs take query precedence if also supplied; email and phone cannot be combined. Results are Subscribed, Unsubscribed, or Unknown and do not include the overriding global email state. Default rate limit: 250,000 requests/hour. |
| `BRAZE_GET_USER_KPI_SERIES` | Get User KPI Series | Get 1 to 100 points for one user KPI: daily active users, rolling 30-day monthly active users, daily new users, or daily uninstalls. Optionally filter to one Braze app. The selected metric determines the exact Braze KPI endpoint. |
| `BRAZE_GET_WEBHOOK_TEMPLATE_TRANSLATION_SOURCE` | Get Webhook Template Translation Source | Read default source values inside a webhook template's translation tags. Requires templates.translations.get and webhook template translations enabled by Braze; otherwise Braze may return FEATURE_NOT_ENABLED. The endpoint has a 250,000 requests/minute limit. |
| `BRAZE_IDENTIFY_USERS` | Identify Users | Assign external IDs to alias-only, email-only, or phone-only Braze profiles, merging into an existing identified profile when applicable. This is irreversible when a merge occurs: the source alias-only, email-only, or phone-only profile is removed after its data is transferred. Requires users.identify and shares a 20,000 requests/minute rate limit. A 201 success only confirms acceptance: case mismatches, duplicate matches, or prioritization can produce no merge. |
| `BRAZE_LIST_CAMPAIGNS` | List Campaigns | Return one page of Braze campaigns for discovery, optionally including archived campaigns and filtering by last edit time. |
| `BRAZE_LIST_CAMPAIGN_TRANSLATIONS` | List Campaign Translations | View every configured locale translation map for one campaign message variation, or filter by locale. Requires campaigns.translations.get, multi-language support on the message, and observes a 250,000 requests/minute limit. |
| `BRAZE_LIST_CANVASES` | List Canvases | Return one fixed provider page of up to 100 Braze Canvases for discovery, optionally including archived Canvases and filtering by last edit time. Braze exposes no page-size control; returning the complete page avoids losing continuation records. A local 10-item cap would save context tokens, not provider requests. |
| `BRAZE_LIST_CANVAS_TRANSLATIONS` | List Canvas Translations | Preview configured locale translations for one Canvas step message variation. Requires canvas.translations.get, multi-language support on the message, and observes a 250,000 requests/minute limit. |
| `BRAZE_LIST_CATALOG_ITEMS` | List Catalog Items | Return one fixed provider page of up to 50 items from a Braze catalog, preserving arbitrary item attributes and exposing Braze Link-header pagination. Braze exposes no page-size control; returning the complete page avoids losing continuation records. A local 10-item cap would save context tokens, not provider requests. Requires the immutable catalogs.get_items API-key permission and shares the 50 requests/minute synchronous catalog item limit. |
| `BRAZE_LIST_CATALOGS` | List Catalogs | Return all catalogs in the connected Braze workspace. Braze exposes no page-size control or resumable boundary, so a local 10-item cap would hide catalogs and save context tokens, not provider requests. |
| `BRAZE_LIST_CLOUD_DATA_INGESTION_INTEGRATIONS` | List Cloud Data Ingestion Integrations | Return one 10-item page of configured Cloud Data Ingestion integrations. Requires the workspace's Cloud Data Ingestion entitlement and has a 50 requests/minute limit. |
| `BRAZE_LIST_CLOUD_DATA_INGESTION_SYNC_STATUSES` | List Cloud Data Ingestion Sync Statuses | Return one 10-item page of sync statuses for a Cloud Data Ingestion integration. Requires the workspace's CDI entitlement and has a 100 requests/minute limit. |
| `BRAZE_LIST_CONTENT_BLOCKS` | List Content Blocks | Return one offset-based page of persisted Braze Content Blocks. Omit offset on the first call and use next_request only when it is returned. |
| `BRAZE_LIST_CONTENT_BLOCK_TRANSLATIONS` | List Content Block Translations | View every configured locale translation map for one Content Block, or filter by locale. Requires content_blocks.translations.get, multi-language translation tags on the block, and observes a 250,000 requests/minute limit. |
| `BRAZE_LIST_CUSTOM_ATTRIBUTES` | List Custom Attributes | Return one fixed provider page of up to 50 alphabetically sorted custom-attribute definitions and a Link-header continuation cursor. Braze exposes no page-size control; returning the complete page avoids losing continuation records. A local 10-item cap would save context tokens, not provider requests. |
| `BRAZE_LIST_CUSTOM_EVENT_NAMES` | List Custom Event Names | Return one fixed provider page of up to 250 alphabetically sorted custom event names. Braze exposes no page-size control; returning the complete page avoids losing continuation records. A local 10-item cap would save context tokens, not provider requests. |
| `BRAZE_LIST_CUSTOM_EVENTS` | List Custom Events | Return one fixed provider page of up to 50 alphabetically sorted custom-event definitions and a Link-header continuation cursor. Braze exposes no page-size control; returning the complete page avoids losing continuation records. A local 10-item cap would save context tokens, not provider requests. |
| `BRAZE_LIST_EMAIL_TEMPLATE_LOCALE_TRANSLATIONS` | List Email Template Locale Translations | View email template translations, optionally filtered to one locale. Braze documents locale_id as optional: when omitted, this action sends no locale filter and returns Braze's translation-list response without asserting which locales Braze will include. Requires templates.translations.get, a multi-language template, and observes a 250,000 requests/minute limit. |
| `BRAZE_LIST_EMAIL_TEMPLATES` | List Email Templates | Return one offset-based page of stored HTML email templates. Drag-and-drop templates are excluded; omit offset on the first call. |
| `BRAZE_LIST_EMAIL_TEMPLATE_TRANSLATIONS` | List Email Template Translations | View all configured translations and locales for one email template. Requires templates.translations.get, a multi-language template, and observes a 250,000 requests/minute limit. |
| `BRAZE_LIST_HARD_BOUNCED_EMAILS` | List Hard Bounced Emails | Return one newest-first offset page of hard-bounced emails. end_date and either start_date or email are required; an email lookup takes precedence over dates. Increase offset until a page has fewer than limit. Default rate limit: 250,000 requests/hour. |
| `BRAZE_LIST_INVALID_PHONE_NUMBERS` | List Invalid Phone Numbers | Return one newest-first offset page of invalid SMS numbers by UTC date range, or check exact E.164 numbers. Exact numbers take precedence over dates. Reasons are provider_error or deactivated. Increase offset until a page has fewer than limit. Default rate limit: 250,000 requests/hour. |
| `BRAZE_LIST_PREFERENCE_CENTERS` | List Preference Centers | List all available Braze preference centers and their IDs and timestamps. Braze exposes no page-size control or resumable boundary, so a local 10-item cap would hide centers and save context tokens, not provider requests. Limited to 1,000 requests/minute per workspace. Braze publishes no separate plan-tier gate. |
| `BRAZE_LIST_PURCHASE_PRODUCTS` | List Purchase Products | Return every product ID from an optional caller-selected provider page. Braze documents page as a string but does not publish a page size, continuation token, or terminal marker, so a local 10-item cap could hide products and would save context tokens, not provider requests. |
| `BRAZE_LIST_SCHEDULED_BROADCASTS` | List Scheduled Broadcasts | List dashboard and API scheduled campaigns and Canvas entries through an ISO 8601 end date. Recurring broadcasts appear only once at their next occurrence. Braze exposes no page-size control or resumable boundary, so a local 10-item cap would hide broadcasts and save context tokens, not provider requests. Requires messages.schedule_broadcasts and uses the default 250,000 requests/hour limit. |
| `BRAZE_LIST_SDK_AUTHENTICATION_KEYS` | List SDK Authentication Keys | HIGH IMPACT SECURITY READ: list all SDK Authentication public keys, IDs, descriptions, and primary status for one exact app. Braze exposes no page-size control or resumable boundary, so a local 10-item cap would hide security inventory and save context tokens, not provider requests. The response contains RSA public keys, never private keys. Restrict output handling because key inventory supports security administration. Default rate limit: 250,000 requests/hour. |
| `BRAZE_LIST_SEGMENTS` | List Segments | Return one fixed provider page of up to 100 Braze segments and their IDs for audience discovery. Braze exposes no page-size control; returning the complete page avoids losing continuation records. A local 10-item cap would save context tokens, not provider requests. Archived segments are excluded by Braze and cannot be requested from this endpoint. |
| `BRAZE_LIST_UNSUBSCRIBED_EMAILS` | List Unsubscribed Emails | Return one offset page of latest unsubscribe records for a UTC date range or exact email. end_date and either start_date or email are required. This is latest state, not full history; use Currents for history. Default rate limit: 250,000 requests/hour. |
| `BRAZE_LIST_USER_SUBSCRIPTION_GROUPS` | List User Subscription Groups | Return one offset page of subscription groups that have status history for users selected by exactly one email or phone identifier type. Newly created groups with no user update are omitted. limit defaults to 10 and cannot exceed 100. Default rate limit: 250,000 requests/hour. |
| `BRAZE_LIST_WEBHOOK_TEMPLATE_TRANSLATIONS` | List Webhook Template Translations | View configured translations for one webhook template, optionally filtered by locale. Requires templates.translations.get and webhook template translations enabled by Braze; otherwise Braze may return FEATURE_NOT_ENABLED. The endpoint has a 250,000 requests/minute limit. |
| `BRAZE_MERGE_USERS` | Merge Users | Asynchronously merge up to 50 Braze source profiles into retained target profiles. Each completed merge is irreversible: the source profile is removed after its data is transferred to the retained target. Requires users.merge and shares a 20,000 requests/minute rate limit. Target values take precedence for existing attributes; counters and selected dates are combined. A 202 success confirms acceptance only, and invalid non-E.164 stored phones can cause a silent skipped merge. |
| `BRAZE_REMOVE_EXTERNAL_IDS` | Remove Deprecated External IDs | Permanently remove up to 50 deprecated Braze external IDs. Requires users.external_ids.remove and is limited to 1,000 requests/minute. Primary IDs cannot be removed; inspect removal_errors because valid requests can partially fail. |
| `BRAZE_REMOVE_HARD_BOUNCED_EMAILS` | Remove Hard Bounced Emails | HIGH IMPACT: remove one to 50 exact addresses from both the Braze bounce list and the email provider's bounce list, potentially making them deliverable again. Revalidate ownership and deliverability first. Success is rejected unless Braze explicitly returns message=success. Default rate limit: 250,000 requests/hour. |
| `BRAZE_REMOVE_INVALID_PHONE_NUMBERS` | Remove Invalid Phone Numbers | HIGH IMPACT: remove one to 50 exact E.164 numbers from Braze's invalid list so they can be revalidated and may receive SMS again. Confirm number ownership and deliverability first. Success is rejected unless Braze explicitly returns message=success. Default rate limit: 250,000 requests/hour. |
| `BRAZE_REMOVE_SPAM_EMAILS` | Remove Emails From Spam List | HIGH IMPACT: remove one to 50 exact addresses from both the Braze spam list and the email provider's spam list, potentially making them deliverable again. Confirm recipient consent first. Success is rejected unless Braze explicitly returns message=success. Default rate limit: 250,000 requests/hour. |
| `BRAZE_RENAME_EXTERNAL_IDS` | Rename External IDs | Rename up to 50 primary Braze external IDs, preserving each old ID as deprecated. Requires users.external_ids.rename, is limited to 1,000 requests/minute, logs no data points, and does not affect MAU. Items process independently; inspect rename_errors and later remove deprecated IDs when migration is complete. |
| `BRAZE_REPLACE_CATALOG_ITEM` | Replace Catalog Item | Synchronously replace a Braze catalog item, creating it if item_id does not exist. Requires the immutable catalogs.replace_item API-key permission and shares a 50 requests/minute synchronous item limit. |
| `BRAZE_REPLACE_CATALOG_ITEMS` | Replace Multiple Catalog Items | Asynchronously replace or create up to 50 Braze catalog items by id. Requires the immutable catalogs.replace_items API-key permission and shares a 16,000 requests/minute asynchronous item limit. Catalog storage limits can reject the request. A 202 response is acceptance only, with no documented job or terminal result. |
| `BRAZE_REPLACE_MEDIA_LIBRARY_ASSET_FILE` | Replace Media Library Asset File | HIGH IMPACT: request replacement of the file associated with one exact Braze media-library asset ID using a public HTTP(S) URL. The existing asset ID and hosted URL are preserved only when Braze confirms success. The replacement extension must exactly match. Replacement supports images, SVGs, documents, fonts, contact cards, and code files; video is unsupported and provider-enforced size limits apply. This action supports the implemented asset_url mode only and does not claim replacement from HTTP status alone. Rate limit: 100/hour. |
| `BRAZE_SEND_CAMPAIGN_TRIGGER` | Send Campaign Trigger | HIGH IMPACT: immediately request an API-triggered campaign send. Provide up to 50 recipients, optionally intersected with a Connected Audience. Audience-only targeting requires broadcast=true; broadcast cannot include individual recipients. An accepted send cannot be retracted. Recipient attributes can update a profile or, with send_to_existing_only=false and an external ID, create a profile. Requires an active dashboard API-triggered campaign and campaigns.trigger.send. A dispatch ID means Braze accepted one batched transmission; it does not prove per-user dispatch or delivery. Per-recipient errors are returned. |
| `BRAZE_SEND_CANVAS_TRIGGER` | Send Canvas Trigger | HIGH IMPACT: immediately request entry into an API-triggered Canvas. Provide up to 50 recipients, optionally intersected with a Connected Audience. Audience-only targeting requires broadcast=true; broadcast cannot include individual recipients. Accepted entry cannot be retracted. Recipient attributes can update a profile or, with send_to_existing_only=false and an external ID, create a profile. Requires canvas.trigger.send and an active Canvas. A paused or archived 201 response is rejected because no entry occurs. A dispatch ID is acceptance, never proof of message delivery; per-recipient errors are preserved. |
| `BRAZE_SEND_MESSAGES` | Send API-Only Messages | HIGH IMPACT: immediately request API-only messages to existing Braze users. Individual targets are limited to 50 combined external IDs and aliases; without individuals you must explicitly set broadcast=true with a segment or Connected Audience. An accepted send cannot be retracted. Requires messages.send. Channel payloads enforce documented required fields, enums, and exclusions; rendered payload size and channel eligibility are provider gates, and a dispatch ID confirms acceptance only, not recipient dispatch or delivery. |
| `BRAZE_SEND_TRANSACTIONAL_CAMPAIGN` | Send Transactional Campaign | HIGH IMPACT: send one immediate transactional email from a Braze Transactional Email campaign to exactly one external-ID or alias recipient; an accepted send cannot be retracted. Recipient attributes can update a profile or create a missing external-ID profile before sending. This is a select-package paid capability requiring an active transactional campaign, transactional.send, and hourly units. external_send_id deduplicates for 24 hours. sent and processed are not delivery; aborted and bounced are terminal failures, while delivered confirms inbox-provider acceptance. |
| `BRAZE_SET_EMAIL_SUBSCRIPTION_STATUS` | Set Global Email Subscription Status | HIGH IMPACT: set the global email subscription state for one to 50 exact addresses, including addresses not yet attached to a profile. Global unsubscribed overrides every subscription group. Success is rejected unless Braze explicitly returns message=success. Default rate limit: 250,000 requests/hour. |
| `BRAZE_SET_PRIMARY_SDK_AUTHENTICATION_KEY` | Set Primary SDK Authentication Key | HIGH IMPACT SECURITY OPERATION: make one exact existing SDK Authentication key the primary key for one exact app. This changes which key new SDK clients should use. Success is rejected unless the returned key list marks that exact key primary. Default rate limit: 250,000 requests/hour. |
| `BRAZE_SET_SUBSCRIPTION_GROUP_STATUS` | Set Subscription Group Status | HIGH IMPACT: batch subscribe or unsubscribe up to 50 users in one exact group. Email-only or phone-only calls can affect every profile sharing the identifier; external IDs may be combined with one channel identifier. Orphaned channel states persist up to 30 days. LINE group use requires approval from the Braze customer success manager. message=success confirms acceptance only, not the resulting state. In particular, SMS double opt-in can no-op when no user profile exists. Shared V1/V2 rate limit: 5,000 requests/minute. |
| `BRAZE_SET_SUBSCRIPTION_GROUP_STATUSES` | Set Subscription Group Statuses | HIGH IMPACT: batch subscribe or unsubscribe users across multiple groups. Each group update must use exactly one of external_ids, emails, or E.164 phones; only external IDs may span email and SMS groups in one call. Orphaned channel states persist up to 30 days. LINE group use requires approval from the Braze customer success manager. message=success confirms acceptance only, not resulting states. In particular, SMS double opt-in can no-op when no user profile exists. Shared V1/V2 rate limit: 5,000 requests/minute. |
| `BRAZE_START_LIVE_ACTIVITY` | Start Live Activity | HIGH IMPACT: remotely request an iOS Live Activity start for exactly one target mode: up to 50 external users, one Connected Audience, or one segment. Requires Swift SDK push-to-start setup, matching ActivityAttributes and ContentState shapes, payload-size compliance, and messages.live_activity.start. HTTP 201 means Braze received a valid request; it does not prove APNs dispatch, display, or delivery. |
| `BRAZE_TRACK_USERS` | Create and Update Users | Asynchronously ingest Braze attributes, custom events, or purchases, up to 75 combined objects per portable request. Attribute objects can create or update profiles; event and purchase objects are durably recorded. Requires users.track. Each custom attribute consumes a data point; rate limits vary by contract (3,000 requests per three seconds for data-point pricing). Inspect errors because valid requests can partially process, and separate calls are not ordered. Conflicting data may process out of order; wait five minutes between requests containing conflicting data to guarantee final ordering. Callers should batch writes instead of making one-object calls when possible. |
| `BRAZE_TRIGGER_CLOUD_DATA_INGESTION_SYNC` | Trigger Cloud Data Ingestion Sync | HIGH IMPACT: enqueue a sync for an existing Cloud Data Ingestion integration. This can ingest durable user or non-user data and consume data points. A 202 success only confirms acceptance, not completion; poll sync statuses. Requires CDI entitlement and is limited to 20 requests/minute. |
| `BRAZE_UPDATE_CAMPAIGN_TRANSLATIONS` | Update Campaign Translations | Submit a durable update request with translation-tag string values for one campaign message locale. This does not publish, launch, send, or prove delivery; read back the translations to verify resulting stored content. A launched campaign must first have its message saved as a draft. Requires campaigns.translations.update and has a 250,000 requests/minute limit. |
| `BRAZE_UPDATE_CAMPAIGN_TRIGGER_SCHEDULE` | Update Campaign Trigger Schedule | HIGH IMPACT: durably replace the full schedule for a previously scheduled API-triggered campaign. Omitted local or optimal-time flags do not carry forward. Near send time changes are best-effort, and a local-time schedule cannot be updated after its time passed in any zone. Requires campaigns.trigger.schedule.update; the change persists until updated, deleted, or sent, and acceptance does not prove every recipient was changed. |
| `BRAZE_UPDATE_CANVAS_TRANSLATIONS` | Update Canvas Translations | Submit a durable update request with translation-tag string values for one Canvas step message locale. This does not publish, launch, send, or prove delivery; read back the translations to verify resulting stored content. A launched Canvas must first have its message saved as a draft. Requires canvas.translations.update and has a 250,000 requests/minute limit. |
| `BRAZE_UPDATE_CANVAS_TRIGGER_SCHEDULE` | Update Canvas Trigger Schedule | HIGH IMPACT: durably replace the full schedule for a previously scheduled API-triggered Canvas. Omitted local or optimal-time flags do not carry forward, and near-send changes are best-effort. Requires canvas.trigger.schedule.update; the change persists until updated, deleted, or entered, and acceptance does not prove every intended entry was changed. |
| `BRAZE_UPDATE_CATALOG_ITEM` | Update Catalog Item | Synchronously patch one existing Braze catalog item. Requires the immutable catalogs.update_item API-key permission and shares a 50 requests/minute synchronous item limit. The item ID belongs only in the path. |
| `BRAZE_UPDATE_CATALOG_ITEMS` | Update Multiple Catalog Items | Asynchronously patch up to 50 existing Braze catalog items. Requires the immutable catalogs.update_items API-key permission and shares a 16,000 requests/minute asynchronous item limit. A 202 response confirms acceptance only and supplies no documented job ID, per-item result, or completion proof. |
| `BRAZE_UPDATE_CONTENT_BLOCK` | Update Content Block | Persist changes to one existing Braze Content Block by API identifier. This updates stored content only; it does not send or deliver a message. |
| `BRAZE_UPDATE_CONTENT_BLOCK_TRANSLATIONS` | Update Content Block Translations | Submit a durable update request with translation-tag string values for one Content Block locale. This does not publish, send, or prove delivery in a message using the block; read back the translations to verify resulting stored content. Requires content_blocks.translations.update and has a 250,000 requests/minute limit. |
| `BRAZE_UPDATE_EMAIL_TEMPLATE` | Update Email Template | Persist one or more changes to an existing Braze email template by API identifier. This updates stored content only; it does not send or deliver email. |
| `BRAZE_UPDATE_EMAIL_TEMPLATE_TRANSLATIONS` | Update Email Template Translations | Submit a durable update request with translation-tag string values for one email template locale. This does not send, schedule, publish, or prove email delivery; read back the translations to verify resulting stored content. Requires templates.translations.update and has a 250,000 requests/minute limit. |
| `BRAZE_UPDATE_LIVE_ACTIVITY` | Update Live Activity | Update an SDK-registered iOS Live Activity without ending it. Requires matching ContentState shape, payload-size compliance, and messages.live_activity.update. An optional dismissal_date updates when the activity is removed from the UI without ending it. Use END_LIVE_ACTIVITY for the irreversible terminal operation. HTTP 201 confirms receipt only, not APNs dispatch, display, dismissal, or delivery. |
| `BRAZE_UPDATE_MESSAGE_SCHEDULE` | Update Message Schedule | HIGH IMPACT: durably update the schedule, documented channel message objects, or both for an API-only scheduled message. The replacement persists until updated, deleted, or sent. Requires messages.schedule.update; acceptance confirms neither dispatch nor delivery. |
| `BRAZE_UPDATE_PREFERENCE_CENTER` | Update Preference Center | HIGH IMPACT: durably update a Braze preference center's required page HTML and confirmation HTML, plus an optional title, state, or options configuration. Omitted title, state, and options are not sent. The immutable name is not accepted. Limited to 10 requests/minute per workspace. |
| `BRAZE_UPDATE_PUSH_CREDENTIALS` | Update Push Credentials | HIGH IMPACT: replace one app's push credentials for exactly one platform. A bad credential can stop push delivery. Braze documents no endpoint-specific rate limit or public plan gate; the workspace must expose the Apps credential API. |
| `BRAZE_UPDATE_USER_ALIASES` | Update User Aliases | Asynchronously request renaming of up to 50 existing Braze aliases. Requires users.alias.update and shares a 20,000 requests/minute rate limit. A success response confirms acceptance only, not completion; update ordering is not guaranteed, and a nonmatching old alias may produce no change. |
| `BRAZE_UPDATE_WEBHOOK_TEMPLATE_TRANSLATIONS` | Update Webhook Template Translations | Submit a durable update request with translation-tag string values for one webhook template locale. This does not invoke, publish, deliver, or prove delivery of a webhook; read back the translations to verify resulting stored content. Requires templates.translations.update and webhook template translations enabled by Braze; otherwise Braze may return FEATURE_NOT_ENABLED. The endpoint has a 250,000 requests/minute limit. |

## Supported Triggers

None listed.

## Troubleshooting

### Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

### Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

### Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See [Composio pricing](/pricing) for the current limits that apply to your connection.

## Complete Code

None listed.

## Conclusion

### Use Braze from Atomic Agent
With your account connected, ask Atomic Agent to work with Braze in natural language. You can connect more apps through the same Composio integration as you need them.
Visit the [Atomic Agent website](https://atomicagent.io/?cta_placement=atomic-agent-site) or inspect the [Atomic Agent source code](https://github.com/AtomicBot-ai/atomic-agent?cta_placement=atomic-agent-repo).

## How to build Braze MCP Agent with another framework

- [ChatGPT](https://composio.dev/toolkits/braze/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/braze/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/braze/framework/hermes-agent)

## Related Toolkits

- [Reddit](https://composio.dev/toolkits/reddit) - Reddit is a social news platform with thriving user-driven communities (subreddits). It's the go-to place for discussion, content sharing, and viral marketing.
- [Facebook](https://composio.dev/toolkits/facebook) - Facebook is a social media and advertising platform for businesses and creators. It helps you connect, share, and manage content across your public Facebook Pages.
- [Linkedin](https://composio.dev/toolkits/linkedin) - LinkedIn is a professional networking platform for connecting, sharing content, and engaging with business opportunities. It's the go-to place for building your professional brand and unlocking new career connections.
- [Active campaign](https://composio.dev/toolkits/active_campaign) - ActiveCampaign is a marketing automation and CRM platform for managing email campaigns, sales pipelines, and customer segmentation. It helps businesses engage customers and drive growth through smart automation and targeted outreach.
- [ActiveTrail](https://composio.dev/toolkits/active_trail) - ActiveTrail is a user-friendly email marketing and automation platform. It helps you reach subscribers and automate campaigns with ease.
- [Adobe Marketing Agent MCP](https://composio.dev/toolkits/adobe_marketing_agent_mcp) - Adobe Marketing Agent MCP is Adobe's hosted MCP service that exposes marketing context, preferences, and agent capabilities. Use it to provide agents with campaign, audience, and analytics context via a managed integration.
- [Ahrefs](https://composio.dev/toolkits/ahrefs) - Ahrefs is an SEO and marketing platform for site audits, keyword research, and competitor insights. It helps you improve search rankings and drive organic traffic.
- [AimTell](https://composio.dev/toolkits/aimtell) - AimTell is a web push notification platform for managing websites, subscribers, campaigns, segments, and delivery analytics. Use it to send targeted browser notifications and measure engagement across your web push campaigns.
- [Amcards](https://composio.dev/toolkits/amcards) - AMCards lets you create and mail personalized greeting cards online. Build stronger customer relationships with easy, automated card campaigns.
- [Beamer](https://composio.dev/toolkits/beamer) - Beamer is a news and changelog platform for in-app announcements and feature updates. It helps companies boost user engagement by sharing news where users are most active.
- [Beehiiv](https://composio.dev/toolkits/beehiiv) - Beehiiv is a newsletter platform for creating and managing publications and subscribers. It helps grow audience engagement and monetize your mailing list.
- [Benchmark email](https://composio.dev/toolkits/benchmark_email) - Benchmark Email is a platform for creating, sending, and tracking email campaigns. It's built to help you engage audiences and analyze results—all in one place.
- [Bigmailer](https://composio.dev/toolkits/bigmailer) - BigMailer is an email marketing platform for managing multiple brands with white-labeling and automation. It helps teams streamline campaigns and simplify integration with Amazon SES.
- [Bitly](https://composio.dev/toolkits/bitly) - Bitly is a link management platform for shortening, customizing, sharing, and tracking links and QR codes. It helps teams create branded links and measure engagement across campaigns.
- [BlueFox Email](https://composio.dev/toolkits/bluefox_email) - BlueFox Email is an email API for managing contacts, subscriber lists, and sending transactional and triggered messages. Use it to reliably send transactional and triggered emails and manage subscribers at scale.
- [Brandfetch](https://composio.dev/toolkits/brandfetch) - Brandfetch is an API that delivers company logos, colors, and visual branding assets. It helps marketers and developers keep brand visuals consistent everywhere.
- [Brevo](https://composio.dev/toolkits/brevo) - Brevo is an all-in-one email and SMS marketing platform for transactional messaging, automation, and CRM. It helps businesses engage customers and streamline communications through powerful campaign tools.
- [Buffer](https://composio.dev/toolkits/buffer) - Buffer is a social media management platform for planning, creating, scheduling, and publishing posts across connected channels. It helps teams keep content organized and publish consistently without jumping between social apps.
- [BulkPublish](https://composio.dev/toolkits/bulkpublish) - BulkPublish is a social media publishing platform for managing scheduled content across multiple channels. It helps teams plan campaigns, publish consistently, and track performance in one place.
- [Campayn](https://composio.dev/toolkits/campayn) - Campayn is an email marketing platform for creating, sending, and managing campaigns. It helps businesses engage contacts and grow audiences with easy-to-use tools.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and Braze MCP?

With a standalone Braze MCP server, the agents and LLMs can only access a fixed set of Braze tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Braze and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Atomic Agent?

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Braze tools.

### Can I manage the permissions and scopes for Braze while using Tool Router?

Yes, absolutely. You can configure which Braze scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Braze data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)