---
canonical_url: "https://docs.composio.dev/toolkits/resend_mcp"
markdown_url: "https://docs.composio.dev/toolkits/resend_mcp.md"
product: "platform"
version: null
last_updated: null
---

# Resend MCP

Send and manage transactional email through Resend.

- **Category:** email
- **Auth:** DCR_OAUTH
- **Composio-managed OAuth available?** No
- **Tools:** 103
- **Triggers:** 0
- **Slug:** `RESEND_MCP`
- **Version:** 20260910_00

## Tools

### Add-contact-to-segment

**Slug:** `RESEND_MCP_ADD_CONTACT_TO_SEGMENT`

Add a contact to a segment in Resend (by contact ID or email).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Contact email address |
| `contactId` | string | No | Contact ID |
| `segmentId` | string | Yes | Segment ID to add the contact to |

### Add-suppression

**Slug:** `RESEND_MCP_ADD_SUPPRESSION`

Add an email address to the suppression list in Resend. Suppressed addresses never receive emails from the account, even when included as recipients. Hard bounces and spam complaints are added to the suppression list automatically; use this tool to manually suppress an address when needed, e.g. to honor a do-not-contact request. To suppress many addresses at once, use batch-add-suppressions instead.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to suppress |

### Batch-add-suppressions

**Slug:** `RESEND_MCP_BATCH_ADD_SUPPRESSIONS`

Add multiple email addresses to the suppression list in Resend in a single call. Suppressed addresses never receive emails from the account. Hard bounces and spam complaints are added to the suppression list automatically; use this tool to manually suppress addresses when needed, e.g. to honor do-not-contact requests. For a single address, use add-suppression instead.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emails` | array | Yes | Email addresses to suppress |

### Batch-remove-suppressions

**Slug:** `RESEND_MCP_BATCH_REMOVE_SUPPRESSIONS`

Remove multiple entries from the suppression list in Resend in a single call, by email addresses or by suppression IDs (provide exactly one of the two). The addresses will start receiving emails again. Before using this tool, you MUST double-check with the user that they want to remove these suppressions. Reference the EMAIL ADDRESSES (or IDs) when double-checking, and warn the user that addresses suppressed due to a bounce or complaint may hurt deliverability if emailed again. You may only use this tool if the user explicitly confirms they want to remove the suppressions after you double-check.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ids` | array | No | Suppression IDs to remove from the suppression list. Cannot be used with "emails". |
| `emails` | array | No | Email addresses to remove from the suppression list. Cannot be used with "ids". |

### Cancel-broadcast

**Slug:** `RESEND_MCP_CANCEL_BROADCAST`

**Purpose:** Cancel a queued or scheduled broadcast by ID or Resend dashboard URL, without removing it. Cancelling a queued broadcast stops it mid-send (emails already sent are not affected). Cancelling a scheduled broadcast reverts it to draft.

**NOT for:** Removing a broadcast entirely (use remove-broadcast). Draft and sent broadcasts cannot be cancelled — sent broadcasts are immutable, and drafts have nothing to cancel.

**When to use:** User wants to "stop", "cancel", or "pause" a broadcast that is currently sending or scheduled to send.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `broadcastId` | string | Yes | Broadcast ID or Resend dashboard URL (e.g. https://resend.com/broadcasts/<id>) |

### Cancel-email

**Slug:** `RESEND_MCP_CANCEL_EMAIL`

Cancel a scheduled email that has not yet been sent. Only works for emails that were scheduled using the scheduledAt parameter.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The ID of the scheduled email to cancel |

### Compose-broadcast

**Slug:** `RESEND_MCP_COMPOSE_BROADCAST`

**Purpose:** Set the TipTap JSON content of a broadcast, enabling it to be edited visually in the Resend dashboard editor. Automatically connects and disconnects from the editor. Can also update metadata (subject, preview text, name) in the same call.

**This is the recommended way to set email content.** Content set via compose-broadcast can be visually edited by the user in the dashboard. Use this for newsletters and any broadcast where the user may want to refine the content.

**Workflow:** get-tiptap-json-content (with include_schema: true) → compose-broadcast

**When to use:**
- After create-broadcast, to set the email body
- When the user wants to write, edit, or style email content
- When the user wants to collaborate on the email in the dashboard editor

**Important:** Always call get-tiptap-json-content first to retrieve the existing TipTap JSON, then build your changes on top of it. Skipping this will overwrite all existing content.

**Note:** Switching between compose (TipTap) and update (raw HTML) modes is lossy — some content or formatting may be lost. If the broadcast already has HTML content, ask the user before switching to compose mode.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Update the broadcast name (internal label). |
| `content` | object | No | TipTap JSON content. Call get-tiptap-json-content (with include_schema: true) first to get the existing content and the schema reference. |
| `subject` | string | No | Update the email subject line. |
| `broadcastId` | string | Yes | Broadcast ID or Resend dashboard URL (e.g. https://resend.com/broadcasts/<id>) |
| `previewText` | string | No | Update the preview text (shown in inbox before opening the email). |

### Compose-template

**Slug:** `RESEND_MCP_COMPOSE_TEMPLATE`

**Purpose:** Set the TipTap JSON content of a template, enabling it to be edited visually in the Resend dashboard editor. Automatically connects and disconnects from the editor. Can also update metadata (subject, name) in the same call.

**This is the recommended way to set email content.** Content set via compose-template can be visually edited by the user in the dashboard.

**Workflow:** get-tiptap-json-content (with include_schema: true) → compose-template

**When to use:**
- After create-template, to set the email body
- When the user wants to write, edit, or style email content
- When the user wants to collaborate on the email in the dashboard editor

**Important:** Always call get-tiptap-json-content first to retrieve the existing TipTap JSON, then build your changes on top of it. Skipping this will overwrite all existing content.

**Note:** Switching between compose (TipTap) and update (raw HTML) modes is lossy — some content or formatting may be lost. If the template already has HTML content, ask the user before switching to compose mode.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The template ID, alias, or Resend dashboard URL (e.g. https://resend.com/templates/<id>) |
| `name` | string | No | Update the template name. |
| `content` | object | No | TipTap JSON content. Call get-tiptap-json-content (with include_schema: true) first to get the existing content and the schema reference. |
| `subject` | string | No | Update the default email subject. |

### Connect-to-editor

**Slug:** `RESEND_MCP_CONNECT_TO_EDITOR`

**Purpose:** Show agent presence in the Resend dashboard editor. Users will see an agent avatar while connected.

**When to use:**
- To signal to dashboard users that an AI agent is working on the content outside of compose workflows
- **Not needed before compose-broadcast or compose-template** — get-tiptap-json-content connects automatically, and compose tools disconnect when done.

**Returns:** Connection token and room ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `agent_name` | string | No | Display name for the agent avatar |
| `resource_id` | string | Yes | ID of the resource or Resend dashboard URL (e.g. https://resend.com/broadcasts/<id> or https://resend.com/templates/<id>) |
| `resource_type` | string ("broadcast" | "template") | Yes | Type of resource to connect to |

### Create-api-key

**Slug:** `RESEND_MCP_CREATE_API_KEY`

Create a new API key in Resend. The token is only shown once upon creation, so you MUST display it to the user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | API key name |
| `domainId` | string | No | Restrict API key to send emails from a specific domain. Only applicable when permission is "sending_access". |
| `permission` | string ("full_access" | "sending_access") | No | Access level. "full_access" grants complete resource management. "sending_access" restricts to email delivery only. |

### Create-automation

**Slug:** `RESEND_MCP_CREATE_AUTOMATION`

**Purpose:** Create an automation workflow that triggers on events and executes a sequence of steps.

**When to use:**
- User wants to set up automated email sequences (welcome series, drip campaigns, re-engagement)
- User wants to automate actions based on events (update contacts, add to segments)

**Workflow:** manage-events (create event, if needed) → list-templates (to get template IDs) → get-template (to check if template has "from" and "subject" — if not, use list-domains to pick a verified domain for the step config) → create-automation → send-event (to test)

**Returns:** Automation ID and dashboard link.

The workflow is a JSON object with one key: "steps" — an array of step objects.

Each step has: key (unique string), type, config, and either "next" (string|null) or "branches" (for branching steps).
Use keys like: "trigger", "send_email_1", "delay_1", "condition_1", "wait_event_1".

## Step types

### trigger — starts the automation when an event fires (required, exactly one)
config: { "eventName": "<event_name>" }
Uses "next".

### send_email — send an email using a published template
config: { "template": { "id": "<template_id>", "variables": { "<key>": "<value>" } }, "from": "Name <sender@example.com>", "subject": "Email subject", "replyTo": "<address>" }
**"from" and "subject" are resolved from the step config first, then fall back to the template.** If neither provides a "from", the email will silently fail to send. If neither provides a "subject", the run will error. Best practice: always set "from" and "subject" on the step config so the automation is self-contained. Use list-domains to find verified domains for "from". "replyTo" and "variables" are optional. Variables can use { "var": "event.<field>" } or { "var": "contact.<field>" } for dynamic values.
Uses "next".

### delay — pause the workflow
config: { "duration": "<human-readable>" }
Examples: "30 minutes", "1 hour", "2 days", "1 week". Max 30 days.
Uses "next".

### condition — conditional split based on contact or event data
config: A condition rule object:
  Single rule: { "type": "rule", "field": "event.<field>" or "contact.<field>", "operator": "<op>", "value": <value> }
  Compound: { "type": "and"|"or", "rules": [<rule>, ...] }
Operators: eq, neq, gt, gte, lt, lte, contains, starts_with, ends_with, exists, is_empty.
exists/is_empty do not require a value.
Uses "branches": { "condition_met": "<step_key>", "condition_not_met": "<step_key_or_null>" }

### wait_for_event — pause until a specific event arrives or timeout
config: { "eventName": "<event_name>", "timeout": "<human-readable>", "filterRule": <optional condition rule> }
For email lifecycle events use "resend:email.<opened|clicked|bounced|delivered|complained|failed|suppressed>".
Uses "branches": { "event_received": "<step_key>", "timeout": "<step_key_or_null>" }

### contact_update — update contact fields
config: { "firstName": "<value>", "lastName": "<value>", "unsubscribed": true|false, "properties": { "<key>": "<value>" } }
All fields optional. Values can use { "var": "event.<field>" } for dynamic data.
Uses "next".

### contact_delete — remove the contact from the audience
config: {}
Uses "next".

### add_to_segment — add contact to a segment
config: { "segmentId": "<segment_id>" }
Uses "next".

## Rules
1. Every step must be reachable from the trigger via next/branches.
2. Terminal steps have "next": null (or null branch values).
3. The workflow must be tree-shaped — no merging branches back together.

## Example: Linear drip campaign

{
  "steps": [
    { "key": "trigger", "type": "trigger", "config": { "eventName": "user.created" }, "next": "send_email_1" },
    { "key": "send_email_1", "type": "send_email", "config": { "template": { "id": "tmpl_123" }, "from": "Welcome <hello@example.com>", "subject": "Welcome!" }, "next": "delay_1" },
    { "key": "delay_1", "type": "delay", "config": { "duration": "3 days" }, "next": "send_email_2" },
    { "key": "send_email_2", "type": "send_email", "config": { "template": { "id": "tmpl_456" }, "from": "Welcome <hello@example.com>", "subject": "Getting started" }, "next": null }
  ]
}

## Example: Re-engagement with wait_for_event

{
  "steps": [
    { "key": "trigger", "type": "trigger", "config": { "eventName": "user.created" }, "next": "send_email_1" },
    { "key": "send_email_1", "type": "send_email", "config": { "template": { "id": "tmpl_789" }, "from": "Team <team@example.com>", "subject": "Welcome" }, "next": "wait_event_1" },
    { "key": "wait_event_1", "type": "wait_for_event", "config": { "eventName": "resend:email.opened", "timeout": "3 days" }, "branches": { "event_received": null, "timeout": "send_email_2" } },
    { "key": "send_email_2", "type": "send_email", "config": { "template": { "id": "tmpl_abc" }, "from": "Team <team@example.com>", "subject": "Did you miss this?" }, "next": null }
  ]
}

## Example: Condition branch

{
  "steps": [
    { "key": "trigger", "type": "trigger", "config": { "eventName": "trial.ended" }, "next": "condition_1" },
    { "key": "condition_1", "type": "condition", "config": { "type": "rule", "field": "event.converted", "operator": "eq", "value": true }, "branches": { "condition_met": "send_email_1", "condition_not_met": "send_email_2" } },
    { "key": "send_email_1", "type": "send_email", "config": { "template": { "id": "tmpl_thanks" }, "from": "Team <team@example.com>", "subject": "Thanks for upgrading!" }, "next": null },
    { "key": "send_email_2", "type": "send_email", "config": { "template": { "id": "tmpl_win_back" }, "from": "Team <team@example.com>", "subject": "We'd love to have you back" }, "next": null }
  ]
}

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name for the automation (e.g., "Welcome Series") |
| `status` | string ("enabled" | "disabled") | No | Initial status. Default: disabled. Use "enabled" to activate immediately. |
| `workflow` | object | Yes | The workflow definition. See the tool description for the full schema and examples. |

### Create-broadcast

**Slug:** `RESEND_MCP_CREATE_BROADCAST`

**Purpose:** Create a broadcast campaign (one email sent to an entire segment). Defines subject, body, and segment; does NOT send yet. Use send-broadcast to send it.

**NOT for:** Sending a one-off email to specific people (use send-email). Not for adding contacts (use create-contact).

**Returns:** Broadcast ID. Use this ID with send-broadcast to send, or get-broadcast/update-broadcast to manage.

**When to use:**
- User wants to "email my list", "send a newsletter", "broadcast to my segment", "email all contacts in X"
- Newsletter, announcement, or bulk message to one segment
- Supports personalization: {{{FIRST_NAME}}}, {{{LAST_NAME}}}, {{{EMAIL}}}, {{{RESEND_UNSUBSCRIBE_URL}}}

**"All contacts" note:** Broadcasts require a segment. There is no "all contacts" option in the API. If the user wants to send to all contacts, check list-segments for an existing segment that covers everyone. If none exists, suggest creating one with create-segment.

**Workflow:** list-segments (if needed) → create-broadcast → get-tiptap-json-content (with include_schema: true) → compose-broadcast → send-broadcast.

**Content options after creating:**
- **compose-broadcast** (recommended): Sets TipTap content that the user can visually edit in the Resend dashboard. Use this when the user wants to collaborate on or refine the email in the editor.
- **update-broadcast with html/text**: Sets static HTML/text content. Use this only when the user explicitly wants to set raw HTML. Switching between compose and html/text modes is lossy — some content or formatting may be lost. Ask the user before switching.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `from` | string | Yes | From email address (e.g. "onboarding@resend.com" or "Resend <onboarding@resend.com>") |
| `html` | string | No | HTML version of the email content. Placeholders: {{{FIRST_NAME&#124;fallback}}}, {{{LAST_NAME&#124;fallback}}}, {{{EMAIL}}}, {{{RESEND_UNSUBSCRIBE_URL}}}.  Email HTML requirements — follow all of these without exception:  STRUCTURE - Always include <!DOCTYPE html>, <html>, <head>, <body> - Layout must be table-based: <table>, <tr>, <td> — never use <div> for layout - Outer wrapper table at width="100%", inner content table at max 600px wide - Every table must have cellpadding="0" cellspacing="0" border="0"  CSS - All styles must be inline (style="...") — no <style> tag, no external stylesheets - No flexbox, no grid, no CSS variables, no CSS shorthand (use padding-top not padding) - font-family must always include web-safe fallbacks (Arial, Helvetica, Georgia, sans-serif) - Always set font-size, line-height, and color explicitly on every text element  IMAGES - Always set width, height, border="0", display:block on every <img> - Use absolute URLs only — no relative paths - Always include alt text  LINKS & BUTTONS - Never use <button> — use <a> styled as a button inside a <td> - No <video>, <form>, or <input> elements - No JavaScript of any kind  OUTLOOK COMPATIBILITY - Use bgcolor attribute on <td> alongside CSS background-color - No CSS background-image (poor Outlook support) - Add <!--[if mso]> conditionals where needed for Outlook rendering  META (in <head>) - <meta charset="UTF-8"> - <meta name="viewport" content="width=device-width, initial-scale=1.0"> - <meta http-equiv="X-UA-Compatible" content="IE=edge"> |
| `name` | string | Yes | Name for the broadcast. If the user does not provide a name, go ahead and create a descriptive name for them, based on the email subject/content and the context of your conversation. |
| `text` | string | Yes | Plain text version of the email content. The following placeholders may be used to personalize the email content: {{{FIRST_NAME&#124;fallback}}}, {{{LAST_NAME&#124;fallback}}}, {{{EMAIL}}}, {{{RESEND_UNSUBSCRIBE_URL}}} |
| `replyTo` | array | No | Reply-to email address(es) |
| `subject` | string | Yes | Email subject |
| `segmentId` | string | Yes | Segment ID to send to |
| `previewText` | string | No | Preview text for the email |

### Create-contact

**Slug:** `RESEND_MCP_CREATE_CONTACT`

Create a new contact in Resend. Optionally assign to segments and configure topic subscriptions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Contact email address |
| `topics` | array | No | Array of topic subscription configurations |
| `lastName` | string | No | Contact last name |
| `firstName` | string | No | Contact first name |
| `properties` | object | No | Custom property key-value pairs for the contact (e.g. { "company_name": "Acme" }) |
| `segmentIds` | array | No | Array of segment IDs to assign this contact to |
| `unsubscribed` | boolean | No | Whether the contact is unsubscribed from all broadcasts |

### Create-contact-import

**Slug:** `RESEND_MCP_CREATE_CONTACT_IMPORT`

Bulk-import contacts from a CSV file into Resend. The import is processed asynchronously: this returns an import ID immediately, then use get-contact-import to poll its status and counts. Provide the CSV as raw text via `content`. Max file size 100MB.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `topics` | array | No | Topic subscription configurations applied to the imported contacts. |
| `content` | string | Yes | Raw CSV text to upload (e.g. "email,first_name\na@b.com,Ada"). |
| `filename` | string | No | Name for the uploaded file. Defaults to "contacts.csv". |
| `columnMap` | object | No | Maps contact fields to CSV header names. When omitted, headers are matched case-sensitively to "email", "first_name", and "last_name". |
| `onConflict` | string ("upsert" | "skip") | No | How to handle contacts that already exist: "upsert" updates them, "skip" leaves them unchanged. Defaults to "upsert". |
| `segmentIds` | array | No | Array of segment IDs to assign the imported contacts to. |

### Create-contact-property

**Slug:** `RESEND_MCP_CREATE_CONTACT_PROPERTY`

Create a new contact property in Resend. A contact property is a custom attribute (e.g. "company_name", "plan_tier") that can be attached to contacts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `key` | string | Yes | The property key. Max 50 characters, only alphanumeric characters and underscores allowed. |
| `type` | string ("string" | "number") | Yes | The property type: "string" or "number". |
| `fallbackValue` | string | No | Default value when the property is not set for a contact. Must match the specified type. |

### Create-domain

**Slug:** `RESEND_MCP_CREATE_DOMAIN`

Create a new domain in Resend. Returns DNS records that must be configured with your DNS provider for verification. You MUST display the DNS records to the user so they can set them up.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tls` | string ("opportunistic" | "enforced") | No | TLS mode. "opportunistic" attempts secure connection with fallback. "enforced" requires TLS or fails. Defaults to "opportunistic". |
| `name` | string | Yes | The domain name (e.g., example.com) |
| `region` | string ("us-east-1" | "eu-west-1" | "sa-east-1" | "ap-northeast-1") | No | Deployment region. Defaults to "us-east-1". |
| `capabilities` | object | No | Domain capabilities configuration. |
| `openTracking` | boolean | No | Enable email open rate tracking. |
| `clickTracking` | boolean | No | Enable click tracking in HTML emails. |
| `customReturnPath` | string | No | Subdomain for the Return-Path address. Defaults to "send". |
| `trackingSubdomain` | string | No | Custom subdomain for tracking links (e.g., "track" for track.example.com). When set, click and open tracking URLs will use this subdomain instead of the default. |

### Create-domain-claim

**Slug:** `RESEND_MCP_CREATE_DOMAIN_CLAIM`

Start a claim for a domain another Resend account has already verified. The domain is recreated under your account with brand-new DKIM keys, so the previous account's DNS records cannot be reused. Returns a TXT record that MUST be added to your DNS to prove ownership. You MUST display the TXT record to the user. After they add it, use verify-domain-claim, then poll get-domain-claim until status is "completed".

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The domain name to claim (e.g., example.com) |
| `region` | string ("us-east-1" | "eu-west-1" | "sa-east-1" | "ap-northeast-1") | No | Deployment region. Defaults to "us-east-1". |
| `openTracking` | boolean | No | Enable email open rate tracking. |
| `clickTracking` | boolean | No | Enable click tracking in HTML emails. |
| `customReturnPath` | string | No | Subdomain for the Return-Path address. Defaults to "send". |
| `trackingSubdomain` | string | No | Custom subdomain for tracking links (e.g., "track" for track.example.com). |

### Create-segment

**Slug:** `RESEND_MCP_CREATE_SEGMENT`

Create a new segment in Resend. A segment is a group of contacts that can be used to target specific broadcasts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name for the new segment |

### Create-template

**Slug:** `RESEND_MCP_CREATE_TEMPLATE`

Create a new email template in Resend. Templates are created in draft status. Use publish-template to make them available for sending. Variables use triple-brace syntax in HTML: {{{VAR_NAME}}}.

**Workflow:** create-template → get-tiptap-json-content (with include_schema: true) → compose-template → publish-template.

**Content options after creating:**
- **compose-template** (recommended): Sets TipTap content that the user can visually edit in the Resend dashboard. Use this when the user wants to collaborate on or refine the template in the editor.
- **update-template with html/text**: Sets static HTML/text content. Use this only when the user explicitly wants to set raw HTML. Switching between compose and html/text modes is lossy — some content or formatting may be lost. Ask the user before switching.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `from` | string | No | Sender email address (e.g., "Your Name <sender@example.com>"). Can be overridden when sending. |
| `html` | string | Yes | The HTML content of the template. Use triple-brace syntax for variables: {{{VARIABLE_NAME}}}.  Email HTML requirements — follow all of these without exception:  STRUCTURE - Always include <!DOCTYPE html>, <html>, <head>, <body> - Layout must be table-based: <table>, <tr>, <td> — never use <div> for layout - Outer wrapper table at width="100%", inner content table at max 600px wide - Every table must have cellpadding="0" cellspacing="0" border="0"  CSS - All styles must be inline (style="...") — no <style> tag, no external stylesheets - No flexbox, no grid, no CSS variables, no CSS shorthand (use padding-top not padding) - font-family must always include web-safe fallbacks (Arial, Helvetica, Georgia, sans-serif) - Always set font-size, line-height, and color explicitly on every text element  IMAGES - Always set width, height, border="0", display:block on every <img> - Use absolute URLs only — no relative paths - Always include alt text  LINKS & BUTTONS - Never use <button> — use <a> styled as a button inside a <td> - No <video>, <form>, or <input> elements - No JavaScript of any kind  OUTLOOK COMPATIBILITY - Use bgcolor attribute on <td> alongside CSS background-color - No CSS background-image (poor Outlook support) - Add <!--[if mso]> conditionals where needed for Outlook rendering  META (in <head>) - <meta charset="UTF-8"> - <meta name="viewport" content="width=device-width, initial-scale=1.0"> - <meta http-equiv="X-UA-Compatible" content="IE=edge"> |
| `name` | string | Yes | The name of the template. |
| `text` | string | No | Plain text version of the message. If omitted, HTML will be used to generate it. Pass an empty string to disable automatic text generation. |
| `alias` | string | No | An alias for the template. Can be used instead of the ID to reference the template. |
| `replyTo` | string | No | Default Reply-to email address(es). Can be overridden when sending. |
| `subject` | string | No | Default email subject. Can be overridden when sending. |
| `variables` | array | No | Array of template variables (up to 50 per template). |

### Create-topic

**Slug:** `RESEND_MCP_CREATE_TOPIC`

Create a new topic in Resend. Topics allow contacts to manage their subscription preferences for different types of emails.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Topic name (max 50 characters) |
| `description` | string | No | Topic description (max 200 characters) |
| `defaultSubscription` | string ("opt_in" | "opt_out") | Yes | Default subscription preference for new contacts. Cannot be modified after creation. |

### Create-webhook

**Slug:** `RESEND_MCP_CREATE_WEBHOOK`

Create a new webhook in Resend. A webhook allows you to receive notifications at a specified URL when certain events occur (e.g. email.sent, email.delivered, email.bounced).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `events` | array | Yes | Array of event types to subscribe to |
| `endpoint` | string | Yes | The URL where webhook events will be sent |

### Disconnect-from-editor

**Slug:** `RESEND_MCP_DISCONNECT_FROM_EDITOR`

Remove agent presence from the Resend dashboard editor. Call this when done editing.

### Duplicate-automation

**Slug:** `RESEND_MCP_DUPLICATE_AUTOMATION`

Duplicate an existing automation by ID or Resend dashboard URL. Creates a copy with its own ID, including the steps and connections of the original. Use this when the user wants a new automation based on one they already have, instead of rebuilding the workflow from scratch. Use update-automation on the new ID to rename it or change its workflow.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Automation ID or Resend dashboard URL (e.g. https://resend.com/automations/<id>) of the automation to duplicate |

### Duplicate-template

**Slug:** `RESEND_MCP_DUPLICATE_TEMPLATE`

Duplicate an existing email template in Resend. Creates a new draft copy of the template with a new ID. Accepts a template ID, alias, or Resend dashboard URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The ID, alias, or Resend dashboard URL (e.g. https://resend.com/templates/<id>) of the template to duplicate. |

### Get-automation

**Slug:** `RESEND_MCP_GET_AUTOMATION`

**Purpose:** Get details of a specific automation (with its workflow) or list all automations.

**Modes:**
- With `id`: Returns full automation details including the workflow definition.
- Without `id`: Lists all automations with optional status filter and pagination.

**When to use:**
- User asks "show me my automations" or "what automations do I have?"
- User wants to inspect a specific automation's workflow
- Before update-automation, to see the current workflow

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Automation ID or Resend dashboard URL (e.g. https://resend.com/automations/<id>). If omitted, lists all automations. |
| `after` | string | No | Cursor for forward pagination (for list mode). |
| `limit` | number | No | Number of automations to retrieve (for list mode). |
| `before` | string | No | Cursor for backward pagination (for list mode). |
| `status` | string ("enabled" | "disabled") | No | Filter by status (for list mode only). |

### Get-automation-runs

**Slug:** `RESEND_MCP_GET_AUTOMATION_RUNS`

**Purpose:** List runs for an automation, or get details of a specific run.

**Modes:**
- With `runId`: Returns detailed run info with step-by-step execution status, outputs, and errors.
- Without `runId`: Lists runs for the automation with optional status filter.

**When to use:**
- User wants to see if an automation is working
- User wants to debug a failed automation run
- User asks "why did this automation fail?" or "show me recent runs"

**Run statuses:** running, completed, failed, cancelled
**Step statuses:** pending, running, completed, failed, skipped, waiting

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Cursor for forward pagination (for list mode). |
| `limit` | number | No | Number of runs to retrieve (for list mode). |
| `runId` | string | No | Specific run ID to get details for. If omitted, lists all runs. |
| `before` | string | No | Cursor for backward pagination (for list mode). |
| `status` | string ("running" | "completed" | "failed" | "cancelled") | No | Filter runs by status (for list mode only). |
| `automationId` | string | Yes | The automation ID or Resend dashboard URL (e.g. https://resend.com/automations/<id>) |

### Get-broadcast

**Slug:** `RESEND_MCP_GET_BROADCAST`

Retrieve full details of a specific broadcast by ID or Resend dashboard URL (e.g. https://resend.com/broadcasts/<id>), including HTML and plain text content.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `broadcastId` | string | Yes | Broadcast ID or Resend dashboard URL (e.g. https://resend.com/broadcasts/<id>) |

### Get-contact

**Slug:** `RESEND_MCP_GET_CONTACT`

Get a contact by ID or email from Resend.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Contact ID |
| `email` | string | No | Contact email address |

### Get-contact-import

**Slug:** `RESEND_MCP_GET_CONTACT_IMPORT`

Get the status and counts of a contact import by ID. Use after create-contact-import to track progress (queued, in_progress, completed, failed).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Contact import ID |

### Get-contact-property

**Slug:** `RESEND_MCP_GET_CONTACT_PROPERTY`

Get a contact property by ID from Resend.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contactPropertyId` | string | Yes | Contact property ID |

### Get-domain

**Slug:** `RESEND_MCP_GET_DOMAIN`

Get a domain by ID from Resend. Returns full domain details including DNS records needed for verification.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Domain ID |

### Get-domain-claim

**Slug:** `RESEND_MCP_GET_DOMAIN_CLAIM`

Retrieve the latest claim for a domain by its placeholder Domain ID (the domain_id from create-domain-claim). Returns claim status and the TXT record needed to prove ownership. Poll until status is "completed".

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The placeholder Domain ID created by the claim |

### Get-email

**Slug:** `RESEND_MCP_GET_EMAIL`

Retrieve full details of a specific sent transactional email by ID, including message_id, HTML and plain text content.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The email ID to retrieve |

### Get-email-metrics

**Slug:** `RESEND_MCP_GET_EMAIL_METRICS`

Retrieve account-level email delivery and engagement metrics (sent, delivered, bounced, opened, clicked, etc.) for a date range, optionally broken down by period, domain, email, or broadcast.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emailId` | array | No | Restrict the response to these email IDs (max 100). Cannot be combined with the "broadcast" dimension or broadcastId. |
| `endDate` | string | No | End of the date range, as an ISO 8601 date or datetime. Defaults to now. |
| `metrics` | array | No | Metrics to include in the response. Defaults to all metrics. |
| `domainId` | array | No | Restrict the response to these sending domain IDs (max 100). |
| `timezone` | string | No | IANA timezone (e.g. "America/New_York") used to bucket periods when "period" is in dimensions. Defaults to UTC. |
| `startDate` | string | No | Start of the date range, as an ISO 8601 date or datetime. Defaults to 6 days before endDate. |
| `dimensions` | array | No | Dimensions to break the response down by. "email" and "broadcast" cannot be combined. Defaults to none, which returns totals only. |
| `broadcastId` | array | No | Restrict the response to these broadcast IDs (max 100). Cannot be combined with the "email" dimension or emailId. |
| `granularity` | string ("hourly" | "daily" | "weekly" | "monthly") | No | Bucket size used when "period" is in dimensions. Defaults to "daily". |

### Get-log

**Slug:** `RESEND_MCP_GET_LOG`

**Purpose:** Get detailed information about a specific API request log, including the full request and response bodies.

**Returns:** Log details: id, created_at, endpoint, method, response_status, user_agent, request_body, response_body.

**When to use:**
- User wants to inspect a specific API request
- Debugging a particular API call
- User says "show me that log", "what was in that request?"

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `logId` | string | Yes | The Log ID to retrieve |

### Get-received-email

**Slug:** `RESEND_MCP_GET_RECEIVED_EMAIL`

Retrieve full details of a specific received email by ID, including HTML and plain text content, headers, and raw email download URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The received email ID to retrieve |

### Get-received-email-attachment

**Slug:** `RESEND_MCP_GET_RECEIVED_EMAIL_ATTACHMENT`

Retrieve details of a specific attachment from a received email, including a time-limited download URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The attachment ID |
| `emailId` | string | Yes | The received email ID |

### Get-segment

**Slug:** `RESEND_MCP_GET_SEGMENT`

Get a segment by ID from Resend.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Segment ID |

### Get-sent-email-attachment

**Slug:** `RESEND_MCP_GET_SENT_EMAIL_ATTACHMENT`

Retrieve details of a specific attachment from a sent email, including a time-limited download URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The attachment ID |
| `emailId` | string | Yes | The sent email ID |

### Get-suppression

**Slug:** `RESEND_MCP_GET_SUPPRESSION`

Get a suppression list entry by ID or email address from Resend. Use this to check whether a specific address is suppressed and why (origin: bounce, complaint, or manual).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `idOrEmail` | string | Yes | Suppression ID or email address |

### Get-template

**Slug:** `RESEND_MCP_GET_TEMPLATE`

Get an email template by ID, alias, or Resend dashboard URL (e.g. https://resend.com/templates/<id>) from Resend. Returns full template details including HTML content, variables, and publish status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The template ID, alias, or Resend dashboard URL (e.g. https://resend.com/templates/<id>) |

### Get-tiptap-json-content

**Slug:** `RESEND_MCP_GET_TIPTAP_JSON_CONTENT`

**Purpose:** Retrieve the existing TipTap JSON content of a broadcast or template, optionally bundled with the TipTap schema reference. Also connects the agent to the editor so the avatar is visible while content is being generated.

**When to use:**
- **Always call this before compose-broadcast or compose-template** to fetch the current document state — even if you expect it to be empty, the resource may have content set via the dashboard
- When the user asks to edit, tweak, or modify existing email content
- To inspect the current TipTap structure of a resource

**Returns:** The TipTap JSON content object for the resource, and optionally the TipTap schema. Use the content as the base for modifications, then pass the updated JSON to compose-broadcast or compose-template.

**Note:** This tool automatically connects the agent to the editor. The subsequent compose-broadcast or compose-template call will disconnect when done.

**Tip:** Set include_schema to true to get both the existing content and the schema in one call.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `resource_id` | string | Yes | The broadcast ID (UUID), template identifier (UUID or alias), or Resend dashboard URL (e.g. https://resend.com/broadcasts/<id> or https://resend.com/templates/<id>) |
| `resource_type` | string ("broadcast" | "template") | Yes | Type of resource to fetch content for |
| `include_schema` | boolean | No | Returns the TipTap schema reference alongside the content. Required for producing valid TipTap JSON. Set to false only if you already have the schema. |

### Get-topic

**Slug:** `RESEND_MCP_GET_TOPIC`

Get a topic by ID from Resend.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Topic ID |

### Get-webhook

**Slug:** `RESEND_MCP_GET_WEBHOOK`

Get a webhook by ID from Resend.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhookId` | string | Yes | Webhook ID |

### Get-webhook-event

**Slug:** `RESEND_MCP_GET_WEBHOOK_EVENT`

**Purpose:** Get one event delivered to a webhook, including the exact payload Resend sent to the endpoint.

**Returns:** id, type, created_at, status, next_attempt_at (when the next retry is scheduled — null once the event reaches success or failed), and payload (the JSON body sent to the endpoint).

**When to use:** User wants to see what Resend actually sent for a specific event, or when the next retry is due. Get the event ID from list-webhook-events first.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `eventId` | string | Yes | Webhook event ID |
| `webhookId` | string | Yes | Webhook ID |

### List-api-keys

**Slug:** `RESEND_MCP_LIST_API_KEYS`

List all API keys from Resend. Returns API key names, IDs, and creation dates. Don't bother telling the user the IDs or creation dates unless they ask for them.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | API key ID after which to retrieve more (for forward pagination). Cannot be used with "before". |
| `limit` | number | No | Number of API keys to retrieve. Max: 100, Min: 1 |
| `before` | string | No | API key ID before which to retrieve more (for backward pagination). Cannot be used with "after". |

### List-broadcast-clicked-links

**Slug:** `RESEND_MCP_LIST_BROADCAST_CLICKED_LINKS`

**Purpose:** List the links clicked in a broadcast, ranked by total clicks.

**Returns:** For each link: id (opaque pagination cursor for that row, not an entity id), url, clicks (total), unique_clicks. Use pagination (limit, after/before) for large lists.

**When to use:**
- User asks "what links were clicked in this broadcast?", "top clicked links", "click breakdown for this campaign"
- Use get-broadcast for overall broadcast details; use this for per-link click data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Cursor after which to retrieve more (for forward pagination). Cannot be used with "before". |
| `limit` | number | No | Number of links to retrieve. Default: 20, Max: 100, Min: 1 |
| `before` | string | No | Cursor before which to retrieve more (for backward pagination). Cannot be used with "after". |
| `broadcastId` | string | Yes | Broadcast ID or Resend dashboard URL (e.g. https://resend.com/broadcasts/<id>) |

### List-broadcast-recipients

**Slug:** `RESEND_MCP_LIST_BROADCAST_RECIPIENTS`

**Purpose:** List the individual recipients of a broadcast for a given event type (sent, delivered, opened, clicked, bounced, complained, unsubscribed, suppressed).

**NOT for:** Aggregate broadcast performance (use get-broadcast). Not for listing broadcasts themselves (use list-broadcasts). This tool returns per-recipient rows, one per contact per event type.

**Returns:** For each recipient: email, id (opaque pagination cursor), contact_id (when known). Also includes count for "opened"/"clicked", bounce_type for "bounced", and clicked_links (url + click count) for "clicked". Use pagination (limit, after/before) for large lists.

**When to use:** User asks "who opened this broadcast?", "who bounced?", "who clicked this link?", "who unsubscribed from this campaign?", or wants the list of contacts behind a specific broadcast engagement metric. Use get-broadcast first if you need the broadcast ID from a name.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("sent" | "delivered" | "opened" | "clicked" | "bounced" | "complained" | "unsubscribed" | "suppressed") | Yes | Recipient event type to list recipients for. |
| `after` | string | No | Cursor to fetch the page after this recipient (for forward pagination). Cannot be used with "before". |
| `email` | string | No | Filter recipients by a substring of their email address. |
| `limit` | integer | No | Number of recipients to retrieve. Default: 20, Max: 100, Min: 1 |
| `before` | string | No | Cursor to fetch the page before this recipient (for backward pagination). Cannot be used with "after". |
| `bounceType` | string ("permanent" | "transient" | "undetermined") | No | Filter by bounce type. Only meaningful when "type" is "bounced". |
| `broadcastId` | string | Yes | Broadcast ID or Resend dashboard URL (e.g. https://resend.com/broadcasts/<id>) |

### List-broadcasts

**Slug:** `RESEND_MCP_LIST_BROADCASTS`

**Purpose:** List all broadcast campaigns (newsletters/bulk emails to audiences) with ID, name, audience, status, timestamps.

**NOT for:** Listing transactional emails (use list-emails). Not for listing segments or contacts (use list-segments, list-contacts).

**Returns:** For each broadcast: id, name, segment_id, status, created_at, scheduled_at, sent_at.

**When to use:** User asks "show my broadcasts", "what newsletters did I send?", "list campaigns". Use get-broadcast for full details of one.

### List-contact-imports

**Slug:** `RESEND_MCP_LIST_CONTACT_IMPORTS`

List contact imports from Resend. Optionally filter by status. Use to discover import IDs or review past imports.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Contact import ID after which to retrieve more (for forward pagination). Cannot be used with "before". |
| `limit` | number | No | Number of contact imports to retrieve. Default: 10, Max: 100, Min: 1 |
| `before` | string | No | Contact import ID before which to retrieve more (for backward pagination). Cannot be used with "after". |
| `status` | string ("queued" | "in_progress" | "completed" | "failed") | No | Filter imports by status. |

### List-contact-properties

**Slug:** `RESEND_MCP_LIST_CONTACT_PROPERTIES`

List all contact properties from Resend. This tool is useful for getting property IDs and seeing which custom attributes are configured. If you need a contact property ID, you MUST use this tool to get all available properties and then ask the user to select the one they want. Don't bother telling the user the IDs or creation dates unless they ask for them.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Contact property ID after which to retrieve more (for forward pagination). Cannot be used with "before". |
| `limit` | number | No | Number of contact properties to retrieve. Default: 20, Max: 100, Min: 1 |
| `before` | string | No | Contact property ID before which to retrieve more (for backward pagination). Cannot be used with "after". |

### List-contacts

**Slug:** `RESEND_MCP_LIST_CONTACTS`

**Purpose:** List contacts from Resend. Optionally filter by segment. Use to discover contact IDs or emails.

**NOT for:** Listing segments (use list-segments). Not for listing sent emails (use list-emails) or broadcasts (use list-broadcasts).

**Returns:** For each contact: id, email, first_name, last_name, unsubscribed, created_at.

**When to use:** User asks "who's in this list?", "show contacts", "who did I add?" Don't bother telling the user the IDs, unsubscribe statuses, or creation dates unless they ask for them.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Contact ID after which to retrieve more (for forward pagination). Cannot be used with "before". |
| `limit` | number | No | Number of contacts to retrieve. Default: 20, Max: 100, Min: 1 |
| `before` | string | No | Contact ID before which to retrieve more (for backward pagination). Cannot be used with "after". |
| `segmentId` | string | No | Segment ID to filter by. If provided, only contacts in this segment will be returned. |

### List-contact-segments

**Slug:** `RESEND_MCP_LIST_CONTACT_SEGMENTS`

List all segments a contact belongs to in Resend (by contact ID or email). Don't bother telling the user the IDs or creation dates unless they ask for them.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Segment ID after which to retrieve more (for forward pagination). Cannot be used with "before". |
| `email` | string | No | Contact email address |
| `limit` | number | No | Number of segments to retrieve. Max: 100, Min: 1. If omitted, all segments are returned. |
| `before` | string | No | Segment ID before which to retrieve more (for backward pagination). Cannot be used with "after". |
| `contactId` | string | No | Contact ID |

### List-contact-topics

**Slug:** `RESEND_MCP_LIST_CONTACT_TOPICS`

List all topic subscriptions for a contact in Resend (by contact ID or email). Don't bother telling the user the IDs unless they ask for them.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Contact ID |
| `after` | string | No | Topic ID after which to retrieve more (for forward pagination). Cannot be used with "before". |
| `email` | string | No | Contact email address |
| `limit` | number | No | Number of topics to retrieve. Default: 20, Max: 100, Min: 1 |
| `before` | string | No | Topic ID before which to retrieve more (for backward pagination). Cannot be used with "after". |

### List-domains

**Slug:** `RESEND_MCP_LIST_DOMAINS`

List all domains from Resend. Returns domain names, statuses, regions, and capabilities. Don't bother telling the user the IDs unless they ask for them.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Domain ID after which to retrieve more (for forward pagination). Cannot be used with "before". |
| `limit` | number | No | Number of domains to retrieve. Default: 20, Max: 100, Min: 1 |
| `before` | string | No | Domain ID before which to retrieve more (for backward pagination). Cannot be used with "after". |

### List-emails

**Slug:** `RESEND_MCP_LIST_EMAILS`

**Purpose:** List recently sent emails (transactional emails sent via send-email) with metadata: recipient, subject, status, timestamps.

**NOT for:** Listing broadcast campaigns (use list-broadcasts). Not for composing or sending.

**Returns:** Paginated list with to, subject, status, created_at, message_id, and ID per email.

**When to use:**
- User asks "what emails were sent?", "show recent emails", "did my email go out?"
- Checking delivery status of sent messages
- Finding an email ID to fetch full content (then use get-email)

**Workflow:** list-emails → get-email( id ) when user needs full body or details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Email ID after which to retrieve more emails (for forward pagination). Cannot be used with "before". |
| `limit` | number | No | Number of emails to retrieve. Default: 20, Max: 100, Min: 1 |
| `before` | string | No | Email ID before which to retrieve more emails (for backward pagination). Cannot be used with "after". |

### List-logs

**Slug:** `RESEND_MCP_LIST_LOGS`

**Purpose:** List API request logs for the account. Use to review recent API activity, debug issues, or audit API usage.

**Returns:** For each log: id, created_at, endpoint, method, response_status, user_agent. Use pagination (limit, after/before) for large lists.

**When to use:**
- User wants to see recent API activity
- Debugging API issues or checking request history
- User says "show my logs", "what API calls were made?", "check recent requests"

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Log ID after which to retrieve more (for forward pagination). Cannot be used with "before". |
| `limit` | number | No | Number of logs to retrieve. Default: 20, Max: 100, Min: 1 |
| `before` | string | No | Log ID before which to retrieve more (for backward pagination). Cannot be used with "after". |

### List-oauth-grants

**Slug:** `RESEND_MCP_LIST_OAUTH_GRANTS`

List OAuth grants for the team — the apps authorized to act on the team's behalf. Returns every grant, active and revoked; a grant with a non-null revoked_at is no longer active. Each grant includes the client (app) name, scopes, and creation date. Don't bother telling the user the IDs unless they ask for them.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | OAuth grant ID after which to retrieve more (for forward pagination). Cannot be used with "before". |
| `limit` | number | No | Number of OAuth grants to retrieve. Max: 100, Min: 1 |
| `before` | string | No | OAuth grant ID before which to retrieve more (for backward pagination). Cannot be used with "after". |

### List-received-email-attachments

**Slug:** `RESEND_MCP_LIST_RECEIVED_EMAIL_ATTACHMENTS`

List all attachments from a specific received (inbox) email. Returns attachment metadata including filename, size, content type, and a time-limited download URL. Use for emails listed by list-received-emails.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Attachment ID after which to retrieve more (for forward pagination). Cannot be used with "before". |
| `limit` | number | No | Number of attachments to retrieve. Default: 20, Max: 100, Min: 1 |
| `before` | string | No | Attachment ID before which to retrieve more (for backward pagination). Cannot be used with "after". |
| `emailId` | string | Yes | The received email ID |

### List-received-emails

**Slug:** `RESEND_MCP_LIST_RECEIVED_EMAILS`

**Purpose:** List emails received (inbox) by your Resend receiving address. Use for "show my inbox", "what emails did I get?", "list incoming mail".

**NOT for:** Listing emails you sent (use list-emails). Not for listing broadcasts (use list-broadcasts).

**Returns:** Paginated metadata: from, to, subject, message_id, received time. Use get-received-email with an ID for full content.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Email ID after which to retrieve more emails (for forward pagination). Cannot be used with "before". |
| `limit` | number | No | Number of emails to retrieve. Default: 20, Max: 100, Min: 1 |
| `before` | string | No | Email ID before which to retrieve more emails (for backward pagination). Cannot be used with "after". |

### List-segments

**Slug:** `RESEND_MCP_LIST_SEGMENTS`

**Purpose:** List all segments in the account. Use to get segment IDs required by create-contact, create-broadcast, list-contacts.

**NOT for:** Listing contacts inside a segment (use list-contacts with segmentId). Not for listing broadcasts (use list-broadcasts).

**Returns:** For each segment: name, id, created_at. Use pagination (limit, after/before) for large lists.

**When to use:** User says "show my segments", "what lists do I have?", or before create-contact/create-broadcast when segmentId is unknown.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Segment ID after which to retrieve more (for forward pagination). Cannot be used with "before". |
| `limit` | number | No | Number of segments to retrieve. Default: 20, Max: 100, Min: 1 |
| `before` | string | No | Segment ID before which to retrieve more (for backward pagination). Cannot be used with "after". |

### List-sent-email-attachments

**Slug:** `RESEND_MCP_LIST_SENT_EMAIL_ATTACHMENTS`

List all attachments from a specific sent email (from send-email or list-emails). Returns attachment metadata including filename, size, content type, and a time-limited download URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Attachment ID after which to retrieve more (for forward pagination). Cannot be used with "before". |
| `limit` | number | No | Number of attachments to retrieve. Default: 20, Max: 100, Min: 1 |
| `before` | string | No | Attachment ID before which to retrieve more (for backward pagination). Cannot be used with "after". |
| `emailId` | string | Yes | The sent email ID |

### List-suppressions

**Slug:** `RESEND_MCP_LIST_SUPPRESSIONS`

**Purpose:** List email addresses on the suppression list. Suppressed addresses never receive emails from the account. Optionally filter by origin: "bounce" (added automatically after a hard bounce), "complaint" (added automatically after a spam complaint), or "manual" (added via the API or dashboard).

**NOT for:** Checking a single address (use get-suppression). Not for listing contacts (use list-contacts).

**Returns:** For each suppression: email, id, origin, source_id (when present), created_at. Use pagination (limit, after/before) for large lists.

**When to use:** User says "show my suppression list", "who is suppressed?", or "why isn't this person receiving emails?" combined with a broad look at suppressed addresses.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Suppression ID after which to retrieve more (for forward pagination). Cannot be used with "before". |
| `limit` | number | No | Number of suppressions to retrieve. Default: 20, Max: 100, Min: 1 |
| `before` | string | No | Suppression ID before which to retrieve more (for backward pagination). Cannot be used with "after". |
| `origin` | string ("bounce" | "complaint" | "manual") | No | Only return suppressions with this origin: "bounce", "complaint", or "manual". |

### List-templates

**Slug:** `RESEND_MCP_LIST_TEMPLATES`

List all email templates from Resend. Returns template names, statuses, and aliases. Don't bother telling the user the IDs unless they ask for them.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Template ID after which to retrieve more (for forward pagination). Cannot be used with "before". |
| `limit` | number | No | Number of templates to retrieve. Default: 20, Max: 100, Min: 1 |
| `before` | string | No | Template ID before which to retrieve more (for backward pagination). Cannot be used with "after". |

### List-topics

**Slug:** `RESEND_MCP_LIST_TOPICS`

List all topics from Resend. This tool is useful for getting topic IDs to use with other tools like send-email.

### List-webhook-event-attempts

**Slug:** `RESEND_MCP_LIST_WEBHOOK_EVENT_ATTEMPTS`

**Purpose:** List the delivery attempts Resend made for one webhook event, most recent first, with what the endpoint returned each time.

**Returns:** For each attempt: id, http_status_code, response (the body the endpoint returned), and sent_at.

**When to use:** An event is in the failed or attempting status and the user wants to know why. This is the tool that shows the endpoint's own error response. Get the event ID from list-webhook-events first.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Attempt ID to fetch the page after (forward pagination). This endpoint has no "before" cursor. |
| `limit` | integer | No | Number of attempts to retrieve. Default: 20, Max: 100, Min: 1 |
| `eventId` | string | Yes | Webhook event ID |
| `webhookId` | string | Yes | Webhook ID |

### List-webhook-events

**Slug:** `RESEND_MCP_LIST_WEBHOOK_EVENTS`

**Purpose:** List the events Resend delivered to one webhook, most recent first, with the delivery status of each.

**NOT for:** Listing the event types a webhook subscribes to (use get-webhook). Not for listing emails (use list-emails) or the Events product (use list-events).

**Returns:** For each event: id, type (e.g. email.sent), created_at, and status — one of pending, attempting, success, or failed.

**When to use:** User asks "did my webhook receive this?", "why is my endpoint missing events?", or wants the delivery history of a webhook. Use get-webhook-event next for the payload, and list-webhook-event-attempts for what their endpoint returned.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | string | No | Event ID to fetch the page after (forward pagination). This endpoint has no "before" cursor. |
| `limit` | integer | No | Number of events to retrieve. Default: 20, Max: 100, Min: 1 |
| `webhookId` | string | Yes | Webhook ID |

### List-webhooks

**Slug:** `RESEND_MCP_LIST_WEBHOOKS`

List all webhooks from Resend. Use to get webhook IDs and see which endpoints and events are configured. Not for listing emails, segments, or broadcasts.

### Manage-events

**Slug:** `RESEND_MCP_MANAGE_EVENTS`

**Purpose:** Create, list, get, update, or remove event definitions in Resend.

Events define named triggers that your application sends to start automations. Each event can have an optional schema that validates payload data.

**Actions:**
- `create`: Define a new event with a name and optional schema.
- `list`: List all event definitions (paginated).
- `get`: Get event details by ID or name.
- `update`: Update an event's schema.
- `remove`: Delete an event. You MUST confirm with the user before removing.

**Workflow:** manage-events (create) → create-automation → send-event

**Schema types:** string, number, boolean, date

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Event name (for create). Use dot notation like "user.created". Cannot start with "resend:". |
| `after` | string | No | Cursor for forward pagination (for list). |
| `limit` | number | No | Number of events to retrieve (for list). Default: 20. |
| `action` | string ("create" | "list" | "get" | "update" | "remove") | Yes | The operation to perform. |
| `before` | string | No | Cursor for backward pagination (for list). |
| `schema` | string | No | Event payload schema (for create, update). Maps field names to types. Pass null to remove the schema. |
| `identifier` | string | No | Event ID or name (for get, update, remove). |

### Publish-template

**Slug:** `RESEND_MCP_PUBLISH_TEMPLATE`

Publish an email template in Resend. Templates must be published before they can be used for sending emails. Re-publishing a previously published template makes the latest changes live. Accepts a template ID, alias, or Resend dashboard URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The template ID, alias, or Resend dashboard URL (e.g. https://resend.com/templates/<id>) |

### Remove-api-key

**Slug:** `RESEND_MCP_REMOVE_API_KEY`

Remove an API key by ID from Resend. Before using this tool, you MUST double-check with the user that they want to remove this API key. Reference the NAME of the API key when double-checking, and warn the user that removing an API key is irreversible and any services using it will lose access. You may only use this tool if the user explicitly confirms they want to remove the API key after you double-check.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | API key ID |

### Remove-automation

**Slug:** `RESEND_MCP_REMOVE_AUTOMATION`

Remove an automation by ID or Resend dashboard URL. Before using this tool, you MUST double-check with the user that they want to remove this automation. Reference the NAME of the automation when confirming, and warn the user that removal is irreversible and will stop all future runs. You may only use this tool if the user explicitly confirms.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Automation ID or Resend dashboard URL (e.g. https://resend.com/automations/<id>) |

### Remove-broadcast

**Slug:** `RESEND_MCP_REMOVE_BROADCAST`

Remove a broadcast by ID or Resend dashboard URL. Before using this tool, you MUST double-check with the user that they want to remove this broadcast. Reference the NAME of the broadcast when double-checking, and warn the user that removing a broadcast is irreversible. You may only use this tool if the user explicitly confirms they want to remove the broadcast after you double-check.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `broadcastId` | string | Yes | Broadcast ID or Resend dashboard URL (e.g. https://resend.com/broadcasts/<id>) |

### Remove-contact

**Slug:** `RESEND_MCP_REMOVE_CONTACT`

Remove a contact from Resend (by ID or email). Before using this tool, you MUST double-check with the user that they want to remove this contact. Reference the contact's name (if present) and email address when double-checking, and warn the user that removing a contact is irreversible. You may only use this tool if the user explicitly confirms they want to remove the contact after you double-check.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Contact ID |
| `email` | string | No | Contact email address |

### Remove-contact-from-segment

**Slug:** `RESEND_MCP_REMOVE_CONTACT_FROM_SEGMENT`

Remove a contact from a segment in Resend (by contact ID or email). Before using this tool, you MUST double-check with the user that they want to remove the contact from the segment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Contact email address |
| `contactId` | string | No | Contact ID |
| `segmentId` | string | Yes | Segment ID to remove the contact from |

### Remove-contact-property

**Slug:** `RESEND_MCP_REMOVE_CONTACT_PROPERTY`

Remove a contact property by ID from Resend. Before using this tool, you MUST double-check with the user that they want to remove this contact property. Reference the KEY of the property when double-checking, and warn the user that removing a contact property is irreversible and will remove the property from all contacts. You may only use this tool if the user explicitly confirms they want to remove the contact property after you double-check.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contactPropertyId` | string | Yes | Contact property ID |

### Remove-domain

**Slug:** `RESEND_MCP_REMOVE_DOMAIN`

Remove a domain by ID from Resend. Before using this tool, you MUST double-check with the user that they want to remove this domain. Reference the NAME of the domain when double-checking, and warn the user that removing a domain is irreversible and will stop all email sending/receiving for that domain. You may only use this tool if the user explicitly confirms they want to remove the domain after you double-check.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Domain ID |

### Remove-segment

**Slug:** `RESEND_MCP_REMOVE_SEGMENT`

Remove a segment by ID from Resend. Before using this tool, you MUST double-check with the user that they want to remove this segment. Reference the NAME of the segment when double-checking, and warn the user that removing a segment is irreversible. You may only use this tool if the user explicitly confirms they want to remove the segment after you double-check.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Segment ID |

### Remove-suppression

**Slug:** `RESEND_MCP_REMOVE_SUPPRESSION`

Remove an entry by ID or email address from the suppression list in Resend, allowing the address to receive emails again. Before using this tool, you MUST double-check with the user that they want to remove this suppression. Reference the EMAIL ADDRESS when double-checking, and warn the user that the address will start receiving emails again — if it was suppressed due to a bounce or complaint, sending to it may hurt deliverability. You may only use this tool if the user explicitly confirms they want to remove the suppression after you double-check.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `idOrEmail` | string | Yes | Suppression ID or email address |

### Remove-template

**Slug:** `RESEND_MCP_REMOVE_TEMPLATE`

Remove an email template by ID, alias, or Resend dashboard URL from Resend. Before using this tool, you MUST double-check with the user that they want to remove this template. Reference the NAME of the template when double-checking, and warn the user that removing a template is irreversible. You may only use this tool if the user explicitly confirms they want to remove the template after you double-check.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The template ID, alias, or Resend dashboard URL (e.g. https://resend.com/templates/<id>) |

### Remove-topic

**Slug:** `RESEND_MCP_REMOVE_TOPIC`

Remove a topic by ID from Resend. Before using this tool, you MUST double-check with the user that they want to remove this topic. Reference the NAME of the topic when double-checking, and warn the user that removing a topic is irreversible. You may only use this tool if the user explicitly confirms they want to remove the topic after you double-check.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Topic ID |

### Remove-webhook

**Slug:** `RESEND_MCP_REMOVE_WEBHOOK`

Remove a webhook by ID from Resend. Before using this tool, you MUST double-check with the user that they want to remove this webhook. Reference the ENDPOINT of the webhook when double-checking, and warn the user that removing a webhook is irreversible. You may only use this tool if the user explicitly confirms they want to remove the webhook after you double-check.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhookId` | string | Yes | Webhook ID |

### Replay-webhook-event

**Slug:** `RESEND_MCP_REPLAY_WEBHOOK_EVENT`

**Purpose:** Queue one more delivery of a webhook event to its endpoint — the same action as the dashboard's Replay button.

**NOT for:** Inspecting an event (use get-webhook-event) or its past attempts (use list-webhook-event-attempts). A manual replay does not schedule further automatic retries.

**When to use:** User wants to resend a specific webhook event after fixing their endpoint, or re-trigger a delivery that failed or was missed. The webhook must be enabled — a disabled webhook fails this call. Get the event ID from list-webhook-events first.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `eventId` | string | Yes | Webhook event ID |
| `webhookId` | string | Yes | Webhook ID |

### Revoke-oauth-grant

**Slug:** `RESEND_MCP_REVOKE_OAUTH_GRANT`

Revoke an OAuth grant by ID. Before using this tool, you MUST double-check with the user that they want to revoke this grant. Reference the NAME of the app (client) when double-checking, and warn the user that revocation is immediate and irreversible — every access and refresh token issued under the grant stops working, and the app would need to be re-authorized to regain access. You may only use this tool if the user explicitly confirms they want to revoke the grant after you double-check.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | OAuth grant ID |

### Send-batch-emails

**Slug:** `RESEND_MCP_SEND_BATCH_EMAILS`

**Purpose:** Send up to 100 transactional emails in one API call. Each item has the same fields as send-email (to, subject, text, from, etc.).

**NOT for:** Sending one email (use send-email) or the same content to a segment (use create-broadcast + send-broadcast).

**When to use:** User wants to send many individual emails in bulk (e.g. 50 password resets, 100 receipts). Not for one-to-many broadcasts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emails` | array | Yes | Array of email objects to send (1-100 emails) |
| `idempotencyKey` | string | No | Optional unique key for the whole batch that prevents duplicate batch sends on retries (sent as the Idempotency-Key header). Use the same key when retrying the same batch; use a new key for a different batch. Max 256 characters. |

### Send-broadcast

**Slug:** `RESEND_MCP_SEND_BROADCAST`

**Purpose:** Send (or schedule) an existing broadcast by ID. The broadcast must have been created with create-broadcast first.

**NOT for:** Sending a new one-off email (use send-email). Not for creating the broadcast content (use create-broadcast).

**Returns:** Send confirmation and broadcast ID.

**When to use:**
- User has created a broadcast and says "send it", "go ahead and send", "schedule this for tomorrow"
- After create-broadcast; call send-broadcast with the returned ID to deliver to the audience
- Optional scheduledAt: natural language or ISO 8601 for scheduled send

**Workflow:** create-broadcast → send-broadcast. Use list-broadcasts to find existing draft/sent broadcasts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `broadcastId` | string | Yes | Broadcast ID or Resend dashboard URL (e.g. https://resend.com/broadcasts/<id>) |
| `scheduledAt` | string | No | When to send the broadcast. Value may be in ISO 8601 format (e.g., 2024-08-05T11:52:01.858Z) or in natural language (e.g., "tomorrow at 10am", "in 2 hours", "next day at 9am PST", "Friday at 3pm ET"). If not provided, the broadcast will be sent immediately. |

### Send-email

**Slug:** `RESEND_MCP_SEND_EMAIL`

**Purpose:** Send a single transactional email to one or more recipients immediately (or schedule it). Use for one-off messages, notifications, and direct replies.

**NOT for:** Sending the same email to a whole list/audience (use create-broadcast + send-broadcast). Not for managing contacts or audiences.

**Returns:** Send confirmation and email ID.

**When to use:**
- User wants to "send an email" to specific people (names or addresses)
- One-off messages: password reset, order confirmation, receipt, alert
- User says "email this to X", "notify them", "send a message to..."
- Scheduling a single email for later

**Workflow:** Get recipient(s) and content from user → send-email. Use list-emails or get-email to check delivery status afterward.

**Key trigger phrases:** "Send an email", "Email this to", "Notify", "Send a message", "Reply to them", "Schedule an email"

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cc` | array | No | Optional array of CC email addresses. You MUST ask the user for this parameter. Under no circumstance provide it yourself |
| `to` | array | Yes | Array of recipient email addresses (1-50 recipients) |
| `bcc` | array | No | Optional array of BCC email addresses. You MUST ask the user for this parameter. Under no circumstance provide it yourself |
| `from` | string | Yes | Sender email address (e.g. "onboarding@resend.com" or "Acme <onboarding@resend.com>"). You MUST ask the user for this parameter. Under no circumstance provide it yourself |
| `html` | string | No | HTML email content. When provided, the plain text argument MUST be provided as well. |
| `tags` | array | No | Array of custom tags for tracking/analytics. Each tag has a name and value. |
| `text` | string | Yes | Plain text email content |
| `headers` | object | No | Optional custom email headers as key/value pairs (e.g. {"List-Unsubscribe": "<https://example.com/unsubscribe>", "X-Entity-Ref-ID": "unique-id"}). Use for one-click unsubscribe, preventing Gmail threading, or other MIME headers Resend accepts. |
| `replyTo` | array | No | Optional email addresses for the email readers to reply to (e.g. "support@example.com" or "Support Team <support@example.com>"). You MUST ask the user for this parameter. Under no circumstance provide it yourself |
| `subject` | string | Yes | Email subject line |
| `topicId` | string | No | Topic ID for subscription-based sending. When set, the email respects contact subscription preferences for this topic. |
| `attachments` | array | No | Array of file attachments. Each needs filename plus one of: url or content. Max 40MB total. |
| `scheduledAt` | string | No | Optional parameter to schedule the email. This uses natural language. Examples would be 'tomorrow at 10am' or 'in 2 hours' or 'next day at 9am PST' or 'Friday at 3pm ET'. |
| `idempotencyKey` | string | No | Optional unique key that prevents duplicate sends on retries (sent as the Idempotency-Key header). Use the same key when retrying the same logical email; use a new key for a different email. Max 256 characters. |

### Send-event

**Slug:** `RESEND_MCP_SEND_EVENT`

**Purpose:** Fire an event to trigger automations for a specific contact.

**When to use:**
- User wants to trigger an automation workflow for a contact
- Testing an automation by sending a test event

**Workflow:** create-event (if needed) → create-automation (if needed) → send-event

**Important:**
- The event name must match the trigger event name in an automation for it to fire.
- Identify the contact by either contactId OR email, not both.
- The payload is optional and can contain any key-value data that the automation steps can reference via event.* variables.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | The contact email to associate with the event. Use either contactId or email, not both. |
| `event` | string | Yes | The event name (e.g., "user.created", "payment.failed") |
| `payload` | object | No | Optional key-value data passed to the automation. Accessible in steps via event.* variables. |
| `contactId` | string | No | The contact ID to associate with the event. Use either contactId or email, not both. |

### Share-email

**Slug:** `RESEND_MCP_SHARE_EMAIL`

Create a shareable link for a sent or received email, so anyone with the link can view it without Resend dashboard access. Works for any email ID, sent or received.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The ID of the sent or received email to share |
| `expiresIn` | string | No | How long the share link stays valid, as a human-readable duration (e.g. "10m", "2 hours", "1 day", "1h 30m"). Defaults to 48 hours; capped at 48 hours. |

### Update-api-key

**Slug:** `RESEND_MCP_UPDATE_API_KEY`

Rename an existing API key in Resend. Only the name can be changed — permission and domain restrictions are fixed at creation and cannot be updated.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | API key ID |
| `name` | string | Yes | New API key name |

### Update-automation

**Slug:** `RESEND_MCP_UPDATE_AUTOMATION`

**Purpose:** Update an automation's name, status, or workflow.

**When to use:**
- User wants to rename an automation
- User wants to enable or disable an automation (use status: "disabled" to stop it)
- User wants to modify the workflow steps

**Important:**
- To disable/stop an automation, set status to "disabled". Existing runs will continue to completion.
- When updating the workflow, provide the complete new workflow — it replaces the existing one.
- Use get-automation first to see the current workflow before making changes.

The workflow is a JSON object with one key: "steps" — an array of step objects.

Each step has: key (unique string), type, config, and either "next" (string|null) or "branches" (for branching steps).
Use keys like: "trigger", "send_email_1", "delay_1", "condition_1", "wait_event_1".

## Step types

### trigger — starts the automation when an event fires (required, exactly one)
config: { "eventName": "<event_name>" }
Uses "next".

### send_email — send an email using a published template
config: { "template": { "id": "<template_id>", "variables": { "<key>": "<value>" } }, "from": "Name <sender@example.com>", "subject": "Email subject", "replyTo": "<address>" }
**"from" and "subject" are resolved from the step config first, then fall back to the template.** If neither provides a "from", the email will silently fail to send. If neither provides a "subject", the run will error. Best practice: always set "from" and "subject" on the step config so the automation is self-contained. Use list-domains to find verified domains for "from". "replyTo" and "variables" are optional. Variables can use { "var": "event.<field>" } or { "var": "contact.<field>" } for dynamic values.
Uses "next".

### delay — pause the workflow
config: { "duration": "<human-readable>" }
Examples: "30 minutes", "1 hour", "2 days", "1 week". Max 30 days.
Uses "next".

### condition — conditional split based on contact or event data
config: A condition rule object:
  Single rule: { "type": "rule", "field": "event.<field>" or "contact.<field>", "operator": "<op>", "value": <value> }
  Compound: { "type": "and"|"or", "rules": [<rule>, ...] }
Operators: eq, neq, gt, gte, lt, lte, contains, starts_with, ends_with, exists, is_empty.
exists/is_empty do not require a value.
Uses "branches": { "condition_met": "<step_key>", "condition_not_met": "<step_key_or_null>" }

### wait_for_event — pause until a specific event arrives or timeout
config: { "eventName": "<event_name>", "timeout": "<human-readable>", "filterRule": <optional condition rule> }
For email lifecycle events use "resend:email.<opened|clicked|bounced|delivered|complained|failed|suppressed>".
Uses "branches": { "event_received": "<step_key>", "timeout": "<step_key_or_null>" }

### contact_update — update contact fields
config: { "firstName": "<value>", "lastName": "<value>", "unsubscribed": true|false, "properties": { "<key>": "<value>" } }
All fields optional. Values can use { "var": "event.<field>" } for dynamic data.
Uses "next".

### contact_delete — remove the contact from the audience
config: {}
Uses "next".

### add_to_segment — add contact to a segment
config: { "segmentId": "<segment_id>" }
Uses "next".

## Rules
1. Every step must be reachable from the trigger via next/branches.
2. Terminal steps have "next": null (or null branch values).
3. The workflow must be tree-shaped — no merging branches back together.

## Example: Linear drip campaign

{
  "steps": [
    { "key": "trigger", "type": "trigger", "config": { "eventName": "user.created" }, "next": "send_email_1" },
    { "key": "send_email_1", "type": "send_email", "config": { "template": { "id": "tmpl_123" }, "from": "Welcome <hello@example.com>", "subject": "Welcome!" }, "next": "delay_1" },
    { "key": "delay_1", "type": "delay", "config": { "duration": "3 days" }, "next": "send_email_2" },
    { "key": "send_email_2", "type": "send_email", "config": { "template": { "id": "tmpl_456" }, "from": "Welcome <hello@example.com>", "subject": "Getting started" }, "next": null }
  ]
}

## Example: Re-engagement with wait_for_event

{
  "steps": [
    { "key": "trigger", "type": "trigger", "config": { "eventName": "user.created" }, "next": "send_email_1" },
    { "key": "send_email_1", "type": "send_email", "config": { "template": { "id": "tmpl_789" }, "from": "Team <team@example.com>", "subject": "Welcome" }, "next": "wait_event_1" },
    { "key": "wait_event_1", "type": "wait_for_event", "config": { "eventName": "resend:email.opened", "timeout": "3 days" }, "branches": { "event_received": null, "timeout": "send_email_2" } },
    { "key": "send_email_2", "type": "send_email", "config": { "template": { "id": "tmpl_abc" }, "from": "Team <team@example.com>", "subject": "Did you miss this?" }, "next": null }
  ]
}

## Example: Condition branch

{
  "steps": [
    { "key": "trigger", "type": "trigger", "config": { "eventName": "trial.ended" }, "next": "condition_1" },
    { "key": "condition_1", "type": "condition", "config": { "type": "rule", "field": "event.converted", "operator": "eq", "value": true }, "branches": { "condition_met": "send_email_1", "condition_not_met": "send_email_2" } },
    { "key": "send_email_1", "type": "send_email", "config": { "template": { "id": "tmpl_thanks" }, "from": "Team <team@example.com>", "subject": "Thanks for upgrading!" }, "next": null },
    { "key": "send_email_2", "type": "send_email", "config": { "template": { "id": "tmpl_win_back" }, "from": "Team <team@example.com>", "subject": "We'd love to have you back" }, "next": null }
  ]
}

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Automation ID or Resend dashboard URL (e.g. https://resend.com/automations/<id>) |
| `name` | string | No | New name for the automation. |
| `status` | string ("enabled" | "disabled") | No | New status. Use "disabled" to stop the automation (prevents new runs). |
| `workflow` | object | No | New workflow definition. Replaces the existing workflow entirely. |

### Update-broadcast

**Slug:** `RESEND_MCP_UPDATE_BROADCAST`

Update broadcast metadata by ID or Resend dashboard URL (name, subject, from, html, text, segment, preview text, reply-to). To edit TipTap content, use compose-broadcast instead.

**Important:** The API requires `from` and `segmentId` to be set on the broadcast. If the broadcast was created from the dashboard, these may be empty. Always call get-broadcast first to check, and include `from` and `segmentId` in your update if they are not already set. Use list-domains to find verified domains for the from address, and list-segments to find segment IDs.

**Note on html/text fields:** Setting html or text via this tool replaces any content previously set via compose-broadcast. This switch is lossy — some content or formatting may be lost. Prefer compose-broadcast for content changes. If the broadcast was composed with TipTap content, ask the user before overwriting it with raw HTML.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `from` | string | No | From email address (e.g. "onboarding@resend.com" or "Resend <onboarding@resend.com>") |
| `html` | string | No | HTML content of the email.  Email HTML requirements — follow all of these without exception:  STRUCTURE - Always include <!DOCTYPE html>, <html>, <head>, <body> - Layout must be table-based: <table>, <tr>, <td> — never use <div> for layout - Outer wrapper table at width="100%", inner content table at max 600px wide - Every table must have cellpadding="0" cellspacing="0" border="0"  CSS - All styles must be inline (style="...") — no <style> tag, no external stylesheets - No flexbox, no grid, no CSS variables, no CSS shorthand (use padding-top not padding) - font-family must always include web-safe fallbacks (Arial, Helvetica, Georgia, sans-serif) - Always set font-size, line-height, and color explicitly on every text element  IMAGES - Always set width, height, border="0", display:block on every <img> - Use absolute URLs only — no relative paths - Always include alt text  LINKS & BUTTONS - Never use <button> — use <a> styled as a button inside a <td> - No <video>, <form>, or <input> elements - No JavaScript of any kind  OUTLOOK COMPATIBILITY - Use bgcolor attribute on <td> alongside CSS background-color - No CSS background-image (poor Outlook support) - Add <!--[if mso]> conditionals where needed for Outlook rendering  META (in <head>) - <meta charset="UTF-8"> - <meta name="viewport" content="width=device-width, initial-scale=1.0"> - <meta http-equiv="X-UA-Compatible" content="IE=edge"> |
| `name` | string | No | Name for the broadcast |
| `text` | string | No | Plain text content of the email |
| `replyTo` | array | No | Reply-to email address(es) |
| `subject` | string | No | Email subject |
| `segmentId` | string | No | Segment ID to send to |
| `broadcastId` | string | Yes | Broadcast ID or Resend dashboard URL (e.g. https://resend.com/broadcasts/<id>) |
| `previewText` | string | No | Preview text for the email |

### Update-contact

**Slug:** `RESEND_MCP_UPDATE_CONTACT`

Update a contact in Resend (by ID or email).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Contact ID |
| `email` | string | No | Contact email address |
| `lastName` | string | No | Contact last name. Pass `null` to remove the contact's last name. |
| `firstName` | string | No | Contact first name. Pass `null` to remove the contact's first name. |
| `properties` | object | No | Custom property key-value pairs to update (e.g. { "company_name": "Acme" }) |
| `unsubscribed` | boolean | No | Whether the contact is unsubscribed from all broadcasts |

### Update-contact-property

**Slug:** `RESEND_MCP_UPDATE_CONTACT_PROPERTY`

Update an existing contact property in Resend. Only the fallback value can be changed — the key and type cannot be modified after creation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fallbackValue` | string | Yes | New default value for the property. Pass null to remove the fallback value. Must match the property type. |
| `contactPropertyId` | string | Yes | Contact property ID |

### Update-contact-topics

**Slug:** `RESEND_MCP_UPDATE_CONTACT_TOPICS`

Update topic subscriptions for a contact in Resend (by contact ID or email).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Contact ID |
| `email` | string | No | Contact email address |
| `topics` | array | Yes | Array of topic subscription configurations to update |

### Update-domain

**Slug:** `RESEND_MCP_UPDATE_DOMAIN`

Update an existing domain in Resend. Allows changing tracking settings, TLS mode, and capabilities.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Domain ID |
| `tls` | string ("opportunistic" | "enforced") | No | TLS mode. "opportunistic" attempts secure connection with fallback. "enforced" requires TLS or fails. |
| `capabilities` | object | No | Domain capabilities. At least one capability must remain enabled. |
| `openTracking` | boolean | No | Track the open rate of each email. |
| `clickTracking` | boolean | No | Track clicks within the body of each HTML email. |
| `trackingSubdomain` | string | No | Custom subdomain for tracking links (e.g., "track" for track.example.com). When set, click and open tracking URLs will use this subdomain instead of the default. |

### Update-email

**Slug:** `RESEND_MCP_UPDATE_EMAIL`

Reschedule a scheduled email by updating its scheduled send time. Only works for emails that were scheduled and have not yet been sent.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The ID of the scheduled email to update |
| `scheduledAt` | string | Yes | The new scheduled time in ISO 8601 format (e.g., "2024-08-05T11:52:01.858Z"). |

### Update-segment

**Slug:** `RESEND_MCP_UPDATE_SEGMENT`

Rename an existing segment in Resend.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Segment ID |
| `name` | string | Yes | New name for the segment |

### Update-template

**Slug:** `RESEND_MCP_UPDATE_TEMPLATE`

Update template metadata by ID, alias, or Resend dashboard URL (name, subject, from, html, variables, etc.). After updating a published template, use publish-template again to make the changes live. To edit TipTap content, use compose-template instead.

**Note on html/text fields:** Setting html or text via this tool replaces any content previously set via compose-template. This switch is lossy — some content or formatting may be lost. Prefer compose-template for content changes. If the template was composed with TipTap content, ask the user before overwriting it with raw HTML.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The template ID, alias, or Resend dashboard URL (e.g. https://resend.com/templates/<id>) |
| `from` | string | No | New sender email address. |
| `html` | string | No | New HTML content for the template.  Email HTML requirements — follow all of these without exception:  STRUCTURE - Always include <!DOCTYPE html>, <html>, <head>, <body> - Layout must be table-based: <table>, <tr>, <td> — never use <div> for layout - Outer wrapper table at width="100%", inner content table at max 600px wide - Every table must have cellpadding="0" cellspacing="0" border="0"  CSS - All styles must be inline (style="...") — no <style> tag, no external stylesheets - No flexbox, no grid, no CSS variables, no CSS shorthand (use padding-top not padding) - font-family must always include web-safe fallbacks (Arial, Helvetica, Georgia, sans-serif) - Always set font-size, line-height, and color explicitly on every text element  IMAGES - Always set width, height, border="0", display:block on every <img> - Use absolute URLs only — no relative paths - Always include alt text  LINKS & BUTTONS - Never use <button> — use <a> styled as a button inside a <td> - No <video>, <form>, or <input> elements - No JavaScript of any kind  OUTLOOK COMPATIBILITY - Use bgcolor attribute on <td> alongside CSS background-color - No CSS background-image (poor Outlook support) - Add <!--[if mso]> conditionals where needed for Outlook rendering  META (in <head>) - <meta charset="UTF-8"> - <meta name="viewport" content="width=device-width, initial-scale=1.0"> - <meta http-equiv="X-UA-Compatible" content="IE=edge"> |
| `name` | string | No | New name for the template. |
| `text` | string | No | New plain text version of the message. If omitted while html changes, it is regenerated from the new html. Pass an empty string to keep it empty. |
| `alias` | string | No | New alias for the template. |
| `replyTo` | string | No | New Reply-to email address(es). |
| `subject` | string | No | New default email subject. |
| `variables` | array | No | New array of template variables (replaces existing variables). |

### Update-topic

**Slug:** `RESEND_MCP_UPDATE_TOPIC`

Update an existing topic in Resend. Note: defaultSubscription cannot be modified after creation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Topic ID |
| `name` | string | No | New topic name (max 50 characters) |
| `description` | string | No | New topic description (max 200 characters) |

### Update-webhook

**Slug:** `RESEND_MCP_UPDATE_WEBHOOK`

Update an existing webhook in Resend. You can change the endpoint URL, subscribed events, or enable/disable the webhook.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `events` | array | No | New array of event types to subscribe to |
| `status` | string ("enabled" | "disabled") | No | Webhook status |
| `endpoint` | string | No | New URL where webhook events will be sent |
| `webhookId` | string | Yes | Webhook ID |

### Verify-domain

**Slug:** `RESEND_MCP_VERIFY_DOMAIN`

Trigger domain verification in Resend. This starts an asynchronous verification process that checks if the DNS records are correctly configured. The domain status will temporarily show as "pending" during verification.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Domain ID |

### Verify-domain-claim

**Slug:** `RESEND_MCP_VERIFY_DOMAIN_CLAIM`

Trigger asynchronous DNS verification and ownership transfer for a domain claim, using the placeholder Domain ID. The claim stays "pending" while verification runs; poll get-domain-claim for status. Once "completed", the transferred domain has NEW DKIM records — fetch them with get-domain, add them to DNS, then run verify-domain.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The placeholder Domain ID created by the claim |