MCP Tools

The Brew MCP exposes every Public API v1 operation as a tool. Each is strictly typed (Zod input schema) with readOnly / destructive annotations, and write tools accept an optional idempotency_key for safe retries. Call get_brew_capabilities for the live, machine-readable catalog including per-tool credit costs.

Discovery

Tool	What it does
`get_brew_capabilities`	The capability catalog + lifecycle workflows. Call this first.

Brand Lifecycle

These tools do not take brand_id. list_brands and get_brand_status are authenticated discovery reads available to both connection types: a brand connection sees only its bound brand, while an organization connection sees the organization partition. create_brand is available only on an organization connection.

Tool	What it does
`list_brands`	List the brands visible to the connection and their extraction states. Call this first to discover `brandId` values.
`create_brand`	Create a brand from a website and start extraction. Requires the `brands` permission. Pass `idempotency_key` for safe retries.
`get_brand_status`	Poll a created brand until `ready` is `true` or its status is `failed`.

The organization bootstrap sequence is:

list_brands -> create_brand -> get_brand_status -> brand_id

After polling succeeds, pass the returned brandId value as brand_id to brand-scoped tools on an organization connection. A brand connection resolves its bound brand automatically and only accepts brand_id as an optional matching assertion.

Email

Tool	What it does
`list_email_designs`	List designs, or fetch one (`include: ["html"]` / `["versions"]`).
`create_email_design`*	Generate a new on-brand design from a prompt. Takes an optional `category` that steers the design treatment.
`import_email_design`*	Import HTML / MJML / React-Email JSX.
`edit_email_with_ai`*	Apply a natural-language edit, producing a new version.
`restore_email_version`	Restore a previous version.
`delete_email_design`	Delete a design (idempotent).
`audit_email_accessibility`*	WCAG 2.1 accessibility audit of a design: a score, a summary, and the specific issues (contrast, alt text, link text, structure) to fix before sending.
`preview_email_across_clients`*	Render a design in real inboxes/devices (Gmail, Outlook, Apple Mail, iOS, light & dark): a screenshot per client.
`import_figma_design`	Deterministically convert a Figma frame into an editable design and return JSX or HTML. No model in the loop, and free. Needs a frame link with a `node-id` plus the brand’s connected Figma integration.
`clone_email_design`	Duplicate a design (optionally an exact historical version) into a new one.
`export_email_design`	Export a design to a connected ESP as a template. `dry_run` validates without writing.
`create_inbox_placement_test`*	Seed-list test of where a design lands: inbox vs spam vs missing, across real providers. Returns `status: "collecting"`.
`get_inbox_placement_results`	Poll one placement test until `completed`, or list a design’s recent tests.

Sending

Tool	What it does
`send_email`	Campaign or test send; pass `scheduledAt` to schedule. Fail-closed idempotency.
`cancel_send`	Cancel a scheduled / in-flight send.
`pause_send`	Pause an in-flight gradual send, halting the ramp without discarding it.
`resume_send`	Resume a paused gradual send, picking the ramp back up.

Audiences & Contacts

Tool	What it does
`list_audiences` / `create_audience` / `update_audience` / `delete_audience`	Saved segments built from contact filters.
`search_contacts` / `create_contact` / `update_contact` / `delete_contact` / `batch_delete_contacts`	Manage contacts. `create_contact` takes an optional `validate` to deliverability-check each address as it’s added and save the verdict (2 credits/address, charged only on success; batches over 100 addresses validate as a background job).
`validate_contacts`*	Deliverability check for up to 100 addresses: each returns valid / risky / invalid with a `reason`, a `didYouMean` typo suggestion, and risk / disposable / role signals. Also writes the verdict back onto matching contacts (no longer read-only). Metered per address.
`import_contacts_csv`	Bulk import contacts. Optional `validate` deliverability-checks each imported address and saves the verdict (2 credits/address on success; batches over 100 addresses validate as a background job).
`list_custom_fields` / `create_custom_field` / `delete_custom_field`	Custom contact fields (great for CRM-enriched attributes).

Domains

Tool	What it does
`list_domains` / `create_domain` / `verify_domain` / `update_domain` / `delete_domain`	Manage and verify sending domains.

Automations & Triggers

Tool	What it does
`list_automations` / `create_automation` / `update_automation` / `delete_automation`	Build and publish automated flows (`update_automation { published: true }`).
`test_automation`	Dry-run a flow.
`run_automation`	Run a manual-audience automation against its cohort.
`list_automation_runs`	Inspect runs.
`list_audience_runs`	Inspect manual-audience runs.
`list_triggers` / `create_trigger` / `update_trigger` / `delete_trigger`	The named events automations listen for.
`fire_trigger_event`	Fire a trigger with a payload to start its automations.

Analytics

Tool	What it does
`get_send_analytics` / `get_campaign_analytics` / `get_automation_analytics` / `get_event_analytics`	Delivery + engagement.
`list_trigger_instances`	Inbound trigger audit log.

Brand, Media & Account

Tool	What it does
`get_brand` / `update_brand` / `search_brand_images`	The active brand’s design context. Organization connections pass `brand_id`; brand connections resolve it automatically.
`generate_image`* / `create_gif`* / `transform_image`* / `html_to_png`* / `add_image`*	On-brand media.
`get_usage` / `list_templates`	Plan, credits, send quota, and templates.

* = credit-metered. Out of credits → an INSUFFICIENT_CREDITS error.

Need help?

Our team is ready to support you at every step of your journey with Brew. Choose the option that works best for you:

Self-Service Tools
Talk to Our Team

Search Documentation

Type in the “Ask any question” search bar at the top left to instantly find relevant documentation pages.

ChatGPT/Claude Integration

Click “Open in ChatGPT” at the top right of any page to analyze documentation with ChatGPT or Claude for deeper insights.

Overview

Core concepts

Guides

MCP server

Public API v1

Discovery

Brand Lifecycle

Email

Sending

Audiences & Contacts

Domains

Automations & Triggers

Analytics

Brand, Media & Account

Need help?

Search Documentation

ChatGPT/Claude Integration

Schedule a Call

Call Us Directly

Slack Channel

Email Support

​Discovery

​Brand Lifecycle

​Email

​Sending

​Audiences & Contacts

​Domains

​Automations & Triggers

​Analytics

​Brand, Media & Account

​Need help?

Search Documentation

ChatGPT/Claude Integration

Schedule a Call

Call Us Directly

Slack Channel

Email Support

Discovery

Brand Lifecycle

Email

Sending

Audiences & Contacts

Domains

Automations & Triggers

Analytics

Brand, Media & Account

Need help?