engineer-api

Send and manage Braze messages via REST API and MCP tools.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/delta-and-beta/braze-agency --skill engineer-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: engineer-api
Source: https://github.com/delta-and-beta/braze-agency/tree/main/skills/engineer-api
Command: npx skills add https://github.com/delta-and-beta/braze-agency --skill engineer-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill removes friction for engineering teams that need to call Braze programmatically by consolidating REST API usage, MCP server configuration, and function-to-endpoint mappings into a single reference workflow. It helps translate conversational assistant requests into correctly authenticated API calls and MCP tool invocations so sends, user updates, and exports work reliably.

Core Features & Use Cases

  • REST API Quick Reference: Endpoint summaries, authentication headers, common request/response shapes, and SMS send examples.
  • MCP Server Guidance: Installation notes, environment variable configuration, Claude Code registration, and available MCP functions mapped to REST endpoints.
  • Debug & Best Practices: Region selection, permission scoping for API keys, subscription group handling for SMS, and common error fixes for failed calls.
  • Use Case: Trigger a transactional SMS from a backend service, update user attributes prior to a send, or have Claude Code invoke an MCP send_message tool and return a dispatch_id.

Quick Start

Configure BRAZE_API_KEY and BRAZE_API_URL, register the MCP server with Claude Code, then ask the assistant to "Send an SMS to external_id ext_456 using subscription group sg_abc with body Your order has shipped."

Frequently Asked Questions about engineer-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send a transactional SMS through the Braze REST API?

Send a transactional SMS via the Braze REST API by authenticating with an API key, specifying the region-specific endpoint, and passing the recipient external_id, subscription group ID, and message body in the request payload.

How do I configure the Braze MCP server for Claude Code?

Configure the Braze MCP server for Claude Code by installing the server package, setting BRAZE_API_KEY and BRAZE_API_URL environment variables, and registering the server to map conversational requests to authenticated REST endpoints.

What API authentication and permissions do I need to send Braze messages?

Braze API authentication requires an API key with properly scoped permissions for messaging. You must also select the correct region-specific REST endpoint URL to ensure sends, user updates, and exports work reliably.

Why does my Braze SMS send fail when calling the REST API?

Braze SMS sends fail due to incorrect region selection, insufficient API key permissions, or missing subscription group handling. Verify the subscription group ID and review the error response to apply the correct fixes.

Can I update user attributes and trigger a Braze campaign in the same workflow?

Yes, you can update user attributes and trigger Braze campaigns in the same workflow by making sequential REST API calls or invoking mapped MCP tools to first update the profile and then dispatch the message.

What is the best way to map Braze REST endpoints to MCP tools?

The best way to map Braze REST endpoints to MCP tools is by registering the MCP server, which translates semantic assistant requests like send_message into correctly authenticated API calls and returns the dispatch_id.