Send transactional email, run campaigns, manage contacts and automations, audit deliverability.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
MisarMail API key. Format: Bearer msk_… — create one at https://mail.misar.io/developers
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Add a sending domain and return the DNS records to publish. The domain cannot send until those records are live and verify_domain succeeds.
Domain to add, e.g. example.com
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Add a sending domain and return the DNS records to publish. The domain cannot send until those records are live and verify_domain succeeds.
| Argument | Type | Description |
|---|---|---|
| domain* | string | Domain to add, e.g. example.com |
{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "Domain to add, e.g. example.com"
}
}
}Move an email to the archive folder. Reversible — the message is not deleted.
| Argument | Type | Description |
|---|---|---|
| id* | string | Email ID to archive |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Email ID to archive"
}
}
}Run AI categorisation over a batch of inbox emails to label intent and priority. Consumes AI credits — pass only the emails you actually need triaged.
| Argument | Type | Description |
|---|---|---|
| email_ids* | array | Email IDs to categorise (max 50 per call) |
{
"type": "object",
"required": [
"email_ids"
],
"properties": {
"email_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Email IDs to categorise (max 50 per call)"
}
}
}Check live SPF, DKIM, and DMARC DNS records for a domain and report alignment problems with the exact record to publish. Works for any domain, not only your own.
| Argument | Type | Description |
|---|---|---|
| domain* | string | Domain to check, e.g. example.com |
{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "Domain to check, e.g. example.com"
}
}
}Delete every captured sandbox email. Affects only intercepted test messages, never real sent mail.
No arguments.
{
"type": "object",
"properties": {}
}Configure inbound email routing for a subdomain so replies land in the MisarMail unified inbox. Returns the MX record to publish.
| Argument | Type | Description |
|---|---|---|
| domain* | string | Root domain, e.g. example.com |
| subdomain* | string | Inbound subdomain label, e.g. reply |
| webhook_url* | string | HTTPS URL to POST inbound messages to (required) |
{
"type": "object",
"required": [
"domain",
"subdomain",
"webhook_url"
],
"properties": {
"domain": {
"type": "string",
"description": "Root domain, e.g. example.com"
},
"subdomain": {
"type": "string",
"description": "Inbound subdomain label, e.g. reply"
},
"webhook_url": {
"type": "string",
"description": "HTTPS URL to POST inbound messages to (required)"
}
}
}Create one A/B test variant on a campaign. The real API stores a single variant per call, so build a test by calling this once per variant (e.g. twice for a plain A/B split) using the same campaign_id and distinct `variant` labels. Each variant gets send_percent of the audience; auto_select_winner (with winner_wait_hours) can pick and send the winner automatically, or use select_ab_test_winner to do it manually.
| Argument | Type | Description |
|---|---|---|
| subject | string | Subject line for subject tests |
| variant* | string | Variant label, e.g. 'A' or 'B' (max 5 chars) |
| body_html | string | Body HTML for content tests |
| from_name | string | Sender name for from_name tests |
| preheader | string | Preheader text for preheader tests |
| test_type | string | What this variant differs on (default: content) |
| campaign_id* | string | Campaign to test (UUID) |
| send_time_a | string | ISO timestamp for this variant's send_time slot A |
| send_time_b |
Create an automation workflow from a trigger, saved as a paused draft. The API's create endpoint only accepts a name and trigger — it has no fields for workflow steps or starting active; configure the step sequence in the MisarMail dashboard's visual builder, and use toggle_automation to activate once reviewed.
| Argument | Type | Description |
|---|---|---|
| name* | string | Automation name |
| trigger* | string | Event that starts the workflow |
| trigger_config | object | Trigger parameters, e.g. { "tag": "trial" } for tag_added |
{
"type": "object",
"required": [
"name",
"trigger"
],
"properties": {
"name": {
"type": "string",
"description": "Automation name"
},
"trigger": {
"enum": [
"contact_created",
"tag_added",
"campaign_opened",
"link_clicked",
"date_based"
],
"type": "string",
"description": "Event that starts the workflow"
},
"trigger_config": {
"type": "object",
"description": "Trigger parameters, e.g. { \"tag\": \"trial\" } for tag_added"
}
}
}Create a new email marketing campaign as a draft. Creating never sends or schedules anything — once the content and audience are confirmed, call send_campaign to send it now or schedule it for later.
| Argument | Type | Description |
|---|---|---|
| html | string | HTML body content |
| name* | string | Internal campaign name (not shown to recipients) |
| text | string | Plain text body content |
| subject* | string | Subject line recipients will see |
| reply_to | string | Reply-to address |
| from_name* | string | Sender display name (required) |
| from_email* | string | Verified sender address |
| segment_id | string | Audience segment to send to |
| template_id | string | Use a saved template instead of inline HTML |
Add a single contact. Adding a contact records consent to email them — only add addresses that opted in, or the send will damage sender reputation and may breach CAN-SPAM/GDPR.
| Argument | Type | Description |
|---|---|---|
| tags | array | Segmentation tags |
| email* | string | Contact email address |
| source | string | Where this contact came from (max 100 chars) |
| last_name | string | Last name (max 100 chars) |
| first_name | string | First name (max 100 chars) |
| custom_fields | object | Custom key-value attributes |
{
"type": "object",
"required": [
"email"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Segmentation tags"
},
"email": {
"type": "string",
"description": "Contact email address"
},
"source": {
"type": "string",
"description": "Where this contact came from (max 100 chars)"
},
"last_name": {
"type": "string",
"description": "Last name (max 100 chars)"
},
"first_name": {
"type": "string",
"description": "First name (max 100 chars)"
},
"custom_fields": {
"type": "object",
"description": "Custom key-value attributes"
}
}
}Create a hosted landing page with a single hero block (headline, subheadline, CTA). Returns the public URL. The real API stores pages as a page-builder block array with no dedicated headline/CTA fields, so this tool translates your inputs into one 'hero' block — for multi-block pages or a real CTA link, use the landing page editor in the MisarMail dashboard.
| Argument | Type | Description |
|---|---|---|
| name* | string | Page title |
| slug | string | URL slug (auto-generated from name when omitted) |
| cta_text | string | Call-to-action button text |
| headline* | string | Headline shown to visitors |
| subheadline | string | Supporting line under the headline |
{
"type": "object",
"required": [
"name",
"headline"
],
"properties": {
"name": {
"type": "string",
"description": "Page title"
},
"slug": {
"type": "string",
"description": "URL slug (auto-generated from name when omitted)"
},
"cta_text": {
"type": "string",
"description": "Call-to-action button text"
},
"headline": {
"type": "string",
"description": "Headline shown to visitors"
},
"subheadline": {
"type": "string",
"description": "Supporting line under the headline"
}
}
}Create a reusable email template. Use {{variable}} placeholders for personalisation — they are substituted at send time and previewable via render_template.
| Argument | Type | Description |
|---|---|---|
| html* | string | HTML body (supports {{variables}}) |
| name* | string | Template name |
| text | string | Plain text fallback body |
| type | string | Template type (default: marketing) |
| subject* | string | Default subject line (supports {{variables}}) |
| variables | array | Declared variable names used in the template |
{
"type": "object",
"required": [
"name",
"subject",
"html"
],
"properties": {
"html": {
"type": "string",
"description": "HTML body (supports {{variables}})"
},
"name": {
"type": "string",
"description": "Template name"
},
"text": {
"type": "string",
"description": "Plain text fallback body"
},
"type": {
"enum": [
"transactional",
"marketing",
"automation"
],
"type": "string",
"description": "Template type (default: marketing)"
},
"subject": {
"type": "string",
"description": "Default subject line (supports {{variables}})"
},
"variables": {
"type": "array",
"items": {
"type": "string"
},
"description": "Declared variable names used in the template"
}
}
}Generate a structured analytics report over a date range. Report types: campaign_performance, engagement_funnel, cohort_analysis, and send_time_heatmap (best hour/day to send).
| Argument | Type | Description |
|---|---|---|
| date_to | string | End date, ISO 8601 (default: today) |
| date_from | string | Start date, ISO 8601 (default: 30 days ago) |
| report_type* | string | Type of report to generate |
{
"type": "object",
"required": [
"report_type"
],
"properties": {
"date_to": {
"type": "string",
"description": "End date, ISO 8601 (default: today)"
},
"date_from": {
"type": "string",
"description": "Start date, ISO 8601 (default: 30 days ago)"
},
"report_type": {
"enum": [
"campaign_performance",
"engagement_funnel",
"cohort_analysis",
"send_time_heatmap"
],
"type": "string",
"description": "Type of report to generate"
}
}
}Generate AI subject-line variants for a campaign topic, optionally tuned to a tone and audience. Good input for create_ab_test.
| Argument | Type | Description |
|---|---|---|
| tone | string | Desired tone (default professional) |
| count | number | How many variants to generate (default 5, max 10) |
| topic* | string | What the email is about |
| audience | string | Who the email is for |
{
"type": "object",
"required": [
"topic"
],
"properties": {
"tone": {
"enum": [
"professional",
"casual",
"urgent",
"playful",
"informative"
],
"type": "string",
"description": "Desired tone (default professional)"
},
"count": {
"type": "number",
"description": "How many variants to generate (default 5, max 10)"
},
"topic": {
"type": "string",
"description": "What the email is about"
},
"audience": {
"type": "string",
"description": "Who the email is for"
}
}
}Get delivery and engagement analytics — sent, delivered, opened, clicked, bounced, and complained — for the account or one campaign, grouped by day/week/month.
| Argument | Type | Description |
|---|---|---|
| period | string | Shorthand window used when start_date is omitted (default 30d) |
| end_date | string | End date, ISO 8601 |
| group_by | string | Time bucket for the series (default day) |
| start_date | string | Start date, ISO 8601 (e.g. 2026-01-01) |
| campaign_id | string | Limit to one campaign (omit for account-wide) |
{
"type": "object",
"properties": {
"period": {
"enum": [
"today",
"7d",
"30d",
"90d"
],
"type": "string",
"description": "Shorthand window used when start_date is omitted (default 30d)"
},
"end_date": {
"type": "string",
"description": "End date, ISO 8601"
},
"group_by": {
"enum": [
"day",
"week",
"month"
],
"type": "string",
"description": "Time bucket for the series (default day)"
},
"start_date": {
"type": "string",
"description": "Start date, ISO 8601 (e.g. 2026-01-01)"
},
"campaign_id": {
"type": "string",
"description": "Limit to one campaign (omit for account-wide)"
}
}
}Get a day/week/month breakdown of sent, delivered, opened, clicked, bounced, complained, replied, and unsubscribed — across every send medium (campaigns, inbox compose, API, MCP, SDKs, GraphQL, automations). The timeline counterpart to get_analytics's period totals.
| Argument | Type | Description |
|---|---|---|
| period | string | Shorthand window used when start_date is omitted (default 30d) |
| end_date | string | End date, ISO 8601 |
| group_by | string | Time bucket for each row (default day) |
| start_date | string | Start date, ISO 8601 (e.g. 2026-01-01) |
{
"type": "object",
"properties": {
"period": {
"enum": [
"today",
"7d",
"30d",
"90d"
],
"type": "string",
"description": "Shorthand window used when start_date is omitted (default 30d)"
},
"end_date": {
"type": "string",
"description": "End date, ISO 8601"
},
"group_by": {
"enum": [
"day",
"week",
"month"
],
"type": "string",
"description": "Time bucket for each row (default day)"
},
"start_date": {
"type": "string",
"description": "Start date, ISO 8601 (e.g. 2026-01-01)"
}
}
}Get one automation workflow in full: trigger, every step with its delay, and per-step completion stats.
| Argument | Type | Description |
|---|---|---|
| automation_id* | string | Automation ID (UUID) |
{
"type": "object",
"required": [
"automation_id"
],
"properties": {
"automation_id": {
"type": "string",
"description": "Automation ID (UUID)"
}
}
}Get full details for one campaign: content, audience segment, schedule, and delivery statistics (sent, opened, clicked, bounced, complained).
| Argument | Type | Description |
|---|---|---|
| campaign_id* | string | Campaign ID (UUID) |
{
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"description": "Campaign ID (UUID)"
}
}
}Get engagement score, engagement tier, and churn risk for one contact — or the lowest-engagement contacts across the list when contact_id is omitted. Use before a re-engagement campaign.
| Argument | Type | Description |
|---|---|---|
| contact_id | string | Contact ID to score (omit to return the lowest-engagement contacts) |
{
"type": "object",
"properties": {
"contact_id": {
"type": "string",
"description": "Contact ID to score (omit to return the lowest-engagement contacts)"
}
}
}Get the account deliverability score (0–100) and letter grade (A–F) with the factors dragging it down. Start here when asked why emails are landing in spam.
No arguments.
{
"type": "object",
"properties": {}
}Read the full content of a single email by ID, including headers, body, and attachments metadata. Side effect: marks the email as read.
| Argument | Type | Description |
|---|---|---|
| id* | string | Email ID (UUID) |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Email ID (UUID)"
}
}
}Get one signup form including its fields, embed code, and redirect behaviour.
| Argument | Type | Description |
|---|---|---|
| form_id* | string | Form ID (UUID) |
{
"type": "object",
"required": [
"form_id"
],
"properties": {
"form_id": {
"type": "string",
"description": "Form ID (UUID)"
}
}
}List submissions for a signup form, including the submitted field values and timestamps.
| Argument | Type | Description |
|---|---|---|
| page | number | Page number (default 1) |
| limit | number | Results per page (default 20) |
| form_id* | string | Form ID (UUID) |
{
"type": "object",
"required": [
"form_id"
],
"properties": {
"page": {
"type": "number",
"description": "Page number (default 1)"
},
"limit": {
"type": "number",
"description": "Results per page (default 20)"
},
"form_id": {
"type": "string",
"description": "Form ID (UUID)"
}
}
}Get every message in one inbox conversation, oldest first, with sender and timestamps.
| Argument | Type | Description |
|---|---|---|
| conversation_id* | string | Conversation ID (UUID) |
{
"type": "object",
"required": [
"conversation_id"
],
"properties": {
"conversation_id": {
"type": "string",
"description": "Conversation ID (UUID)"
}
}
}Get one integration's configuration, scopes, and last sync result.
| Argument | Type | Description |
|---|---|---|
| integration_id* | string | Integration ID |
{
"type": "object",
"required": [
"integration_id"
],
"properties": {
"integration_id": {
"type": "string",
"description": "Integration ID"
}
}
}Get one marketplace listing with its full preview, author, and install count.
| Argument | Type | Description |
|---|---|---|
| item_id* | string | Marketplace item ID |
{
"type": "object",
"required": [
"item_id"
],
"properties": {
"item_id": {
"type": "string",
"description": "Marketplace item ID"
}
}
}Get newsletter monetization stats: paid subscribers, MRR, churn, and sponsorship revenue for the period.
| Argument | Type | Description |
|---|---|---|
| period | string | Time window (default 30d) |
{
"type": "object",
"properties": {
"period": {
"enum": [
"today",
"7d",
"30d",
"90d"
],
"type": "string",
"description": "Time window (default 30d)"
}
}
}Attribute ecommerce revenue to email — revenue per campaign, per contact, and average order value from tracked conversions.
| Argument | Type | Description |
|---|---|---|
| period | string | Time window (default 30d) |
| campaign_id | string | Limit to one campaign |
{
"type": "object",
"properties": {
"period": {
"enum": [
"today",
"7d",
"30d",
"90d"
],
"type": "string",
"description": "Time window (default 30d)"
},
"campaign_id": {
"type": "string",
"description": "Limit to one campaign"
}
}
}Get IP/domain warm-up progress and today's remaining send capacity. Exceeding warm-up capacity on a new domain is the fastest way to get throttled or blocklisted.
No arguments.
{
"type": "object",
"properties": {}
}Bulk-import up to 5,000 contacts in one call. By default, addresses that already exist are skipped rather than duplicated — pass update_existing: true to update them instead. Returns per-row results so you can see which rows were rejected and why.
| Argument | Type | Description |
|---|---|---|
| contacts* | array | Contacts to import (max 5000) |
| update_existing | boolean | Update contacts that already exist instead of skipping them (default false) |
{
"type": "object",
"required": [
"contacts"
],
"properties": {
"contacts": {
"type": "array",
"items": {
"type": "object",
"required": [
"email"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"email": {
"type": "string"
},
"last_name": {
"type": "string"
},
"first_name": {
"type": "string"
}
}
},
"description": "Contacts to import (max 5000)"
},
"update_existing": {
"type": "boolean",
"description": "Update contacts that already exist instead of skipping them (default false)"
}
}
}List A/B tests with per-variant results and whether a winner has been selected yet.
| Argument | Type | Description |
|---|---|---|
| page | number | Page number (default 1) |
| type | string | Filter by test source: 'campaign' for campaign A/B tests (subject/content/send_time/from_name variants on a campaign), 'subject' for standalone subject-line tests |
| limit | number | Results per page (default 20) |
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Page number (default 1)"
},
"type": {
"enum": [
"campaign",
"subject"
],
"type": "string",
"description": "Filter by test source: 'campaign' for campaign A/B tests (subject/content/send_time/from_name variants on a campaign), 'subject' for standalone subject-line tests"
},
"limit": {
"type": "number",
"description": "Results per page (default 20)"
}
}
}List API keys on the account with their scopes and last-used time. Key secrets are never returned — only metadata.
No arguments.
{
"type": "object",
"properties": {}
}List automation workflows (welcome series, re-engagement, drip sequences) with their trigger type and active state.
| Argument | Type | Description |
|---|---|---|
| page | number | Page number (default 1) |
| limit | number | Results per page (default 20) |
| status | string | Filter by automation status |
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Page number (default 1)"
},
"limit": {
"type": "number",
"description": "Results per page (default 20)"
},
"status": {
"enum": [
"active",
"paused",
"draft"
],
"type": "string",
"description": "Filter by automation status"
}
}
}List email marketing campaigns with their status, audience size, and headline metrics. Filter by status to find drafts ready to send or campaigns still sending.
| Argument | Type | Description |
|---|---|---|
| page | number | Page number (default 1) |
| limit | number | Results per page (default 20, max 100) |
| status | string | Filter by campaign status |
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Page number (default 1)"
},
"limit": {
"type": "number",
"description": "Results per page (default 20, max 100)"
},
"status": {
"enum": [
"draft",
"scheduled",
"sending",
"sent",
"paused",
"failed"
],
"type": "string",
"description": "Filter by campaign status"
}
}
}List contacts with their subscription status and engagement metrics. Filter by status to find unsubscribed or bounced addresses that should be excluded from sends.
| Argument | Type | Description |
|---|---|---|
| page | number | Page number (default 1) |
| limit | number | Results per page (default 20, max 100) |
| search | string | Search across email, name, and company |
| status | string | Filter by subscription status |
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Page number (default 1)"
},
"limit": {
"type": "number",
"description": "Results per page (default 20, max 100)"
},
"search": {
"type": "string",
"description": "Search across email, name, and company"
},
"status": {
"enum": [
"subscribed",
"unsubscribed",
"bounced",
"complained"
],
"type": "string",
"description": "Filter by subscription status"
}
}
}List sending domains with verification status and their DKIM/SPF/DMARC records. Check here first when a send fails with an unverified-sender error.
| Argument | Type | Description |
|---|---|---|
| page | number | Page number (default 1) |
| limit | number | Results per page (default 20) |
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Page number (default 1)"
},
"limit": {
"type": "number",
"description": "Results per page (default 20)"
}
}
}List emails from a mailbox folder with optional full-text search across subject and body. Use this for reading the unified inbox; use list_campaigns for marketing sends.
| Argument | Type | Description |
|---|---|---|
| limit | number | Number of emails to return (default 20, max 50) |
| folder | string | Folder to list (default: inbox) |
| search | string | Search query across subject and body |
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "Number of emails to return (default 20, max 50)"
},
"folder": {
"enum": [
"inbox",
"sent",
"drafts",
"archive",
"spam",
"trash",
"starred"
],
"type": "string",
"description": "Folder to list (default: inbox)"
},
"search": {
"type": "string",
"description": "Search query across subject and body"
}
}
}List signup forms with their embed status and conversion counts.
| Argument | Type | Description |
|---|---|---|
| page | number | Page number (default 1) |
| limit | number | Results per page (default 20) |
| status | string | Filter by form status |
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Page number (default 1)"
},
"limit": {
"type": "number",
"description": "Results per page (default 20)"
},
"status": {
"enum": [
"active",
"inactive"
],
"type": "string",
"description": "Filter by form status"
}
}
}List unified-inbox conversations (threads) with their status and detected intent. Use this for triage; use list_emails for individual messages in a folder.
| Argument | Type | Description |
|---|---|---|
| q | string | Free-text search across the thread |
| limit | number | Results to return (default 20) |
| intent | string | Filter by detected intent, e.g. interested, unsubscribe, question |
| offset | number | Offset for pagination |
| status | string | Filter by conversation status |
| channel | string | Filter by channel, e.g. email |
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Free-text search across the thread"
},
"limit": {
"type": "number",
"description": "Results to return (default 20)"
},
"intent": {
"type": "string",
"description": "Filter by detected intent, e.g. interested, unsubscribe, question"
},
"offset": {
"type": "number",
"description": "Offset for pagination"
},
"status": {
"enum": [
"open",
"pending",
"closed"
],
"type": "string",
"description": "Filter by conversation status"
},
"channel": {
"type": "string",
"description": "Filter by channel, e.g. email"
}
}
}List connected third-party integrations and their sync status.
| Argument | Type | Description |
|---|---|---|
| page | number | Page number (default 1) |
| limit | number | Results per page (default 20) |
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Page number (default 1)"
},
"limit": {
"type": "number",
"description": "Results per page (default 20)"
}
}
}Browse the MisarMail template marketplace for ready-made email and automation templates.
| Argument | Type | Description |
|---|---|---|
| page | number | Page number (default 1) |
| limit | number | Results per page (default 20) |
| search | string | Search marketplace listings |
| category | string | Filter by category, e.g. newsletter, ecommerce |
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Page number (default 1)"
},
"limit": {
"type": "number",
"description": "Results per page (default 20)"
},
"search": {
"type": "string",
"description": "Search marketplace listings"
},
"category": {
"type": "string",
"description": "Filter by category, e.g. newsletter, ecommerce"
}
}
}List emails captured by sandbox mode. Sandbox intercepts sends instead of delivering them — use it to verify templates and automations without emailing anyone.
No arguments.
{
"type": "object",
"properties": {}
}List saved email templates with their variable placeholders, so you can pick one for a campaign or transactional send.
| Argument | Type | Description |
|---|---|---|
| page | number | Page number (default 1) |
| type | string | Filter by template type |
| limit | number | Results per page (default 20) |
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Page number (default 1)"
},
"type": {
"enum": [
"transactional",
"marketing",
"automation"
],
"type": "string",
"description": "Filter by template type"
},
"limit": {
"type": "number",
"description": "Results per page (default 20)"
}
}
}Render a template with sample variables and return the resulting HTML and subject. Use this to preview personalisation before sending anything.
| Argument | Type | Description |
|---|---|---|
| variables | object | Variable values to substitute, e.g. { "first_name": "Ada" } |
| template_id* | string | Template ID to render |
{
"type": "object",
"required": [
"template_id"
],
"properties": {
"variables": {
"type": "object",
"description": "Variable values to substitute, e.g. { \"first_name\": \"Ada\" }"
},
"template_id": {
"type": "string",
"description": "Template ID to render"
}
}
}Reply to an existing email thread. The sender address and threading headers are derived from the original message, so only the body is required.
| Argument | Type | Description |
|---|---|---|
| html | string | HTML reply body |
| text | string | Plain text reply body |
| email_id* | string | ID of the email to reply to |
{
"type": "object",
"required": [
"email_id"
],
"properties": {
"html": {
"type": "string",
"description": "HTML reply body"
},
"text": {
"type": "string",
"description": "Plain text reply body"
},
"email_id": {
"type": "string",
"description": "ID of the email to reply to"
}
}
}Run a full deliverability audit across authentication (SPF/DKIM/DMARC), domain reputation, list hygiene, content signals, and blocklist status. Returns prioritized findings.
No arguments.
{
"type": "object",
"properties": {}
}Select the winning variant and send it to the remaining audience. This triggers a real send to everyone who was held back — it cannot be undone.
| Argument | Type | Description |
|---|---|---|
| metric | string | Metric the decision was based on (default opens) |
| test_id* | string | A/B test ID |
| winner_variant* | string | Label of the winning variant, e.g. B |
{
"type": "object",
"required": [
"test_id",
"winner_variant"
],
"properties": {
"metric": {
"enum": [
"opens",
"clicks",
"revenue",
"conversions"
],
"type": "string",
"description": "Metric the decision was based on (default opens)"
},
"test_id": {
"type": "string",
"description": "A/B test ID"
},
"winner_variant": {
"type": "string",
"description": "Label of the winning variant, e.g. B"
}
}
}Send a campaign now, or schedule it for a future time by passing scheduled_at. This delivers real email to real recipients and cannot be undone once sending starts — confirm the audience with get_campaign first.
| Argument | Type | Description |
|---|---|---|
| campaign_id* | string | Campaign ID (UUID) |
| scheduled_at | string | ISO 8601 timestamp to schedule instead of sending immediately |
{
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"description": "Campaign ID (UUID)"
},
"scheduled_at": {
"type": "string",
"description": "ISO 8601 timestamp to schedule instead of sending immediately"
}
}
}Send a transactional email from a verified MisarMail account. `from.email` must match an email account you have already verified — use list_domains to check which sender domains are available. Returns the message ID and queue status.
| Argument | Type | Description |
|---|---|---|
| cc | array | CC recipients (max 50) |
| to* | array | Recipient list (1–100 addresses) |
| bcc | array | BCC recipients (max 50, hidden from other recipients) |
| from* | object | Sender address (must match a verified MisarMail account) |
| html | string | HTML body (max 500KB, recommended) |
| tags | array | Tags for tracking (max 10, each max 64 chars) |
| text | string | Plain text body (max 500KB, fallback for HTML) |
| subject* | string | Email subject (max 998 chars) |
| alias_id | string | Route via a specific alias SMTP pool |
| metadata |
Activate or pause an automation. Activating starts enrolling contacts and sending on the configured schedule.
| Argument | Type | Description |
|---|---|---|
| active* | boolean | true to activate, false to pause |
| automation_id* | string | Automation ID (UUID) |
{
"type": "object",
"required": [
"automation_id",
"active"
],
"properties": {
"active": {
"type": "boolean",
"description": "true to activate, false to pause"
},
"automation_id": {
"type": "string",
"description": "Automation ID (UUID)"
}
}
}Enable or disable an integration. Disabling stops all syncing but preserves the stored credentials.
| Argument | Type | Description |
|---|---|---|
| enabled* | boolean | true to enable, false to disable |
| integration_id* | string | Integration ID |
{
"type": "object",
"required": [
"integration_id",
"enabled"
],
"properties": {
"enabled": {
"type": "boolean",
"description": "true to enable, false to disable"
},
"integration_id": {
"type": "string",
"description": "Integration ID"
}
}
}Update an existing contact by email address, including changing subscription status. Setting status to unsubscribed immediately excludes them from every future campaign. Does not support tags, phone, company, or job title — the API has no fields for them.
| Argument | Type | Description |
|---|---|---|
| email* | string | Email address identifying the contact |
| status | string | New subscription status |
| last_name | string | Last name |
| first_name | string | First name |
| custom_fields | object | Custom key-value attributes to merge |
{
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Email address identifying the contact"
},
"status": {
"enum": [
"subscribed",
"unsubscribed",
"bounced",
"complained"
],
"type": "string",
"description": "New subscription status"
},
"last_name": {
"type": "string",
"description": "Last name"
},
"first_name": {
"type": "string",
"description": "First name"
},
"custom_fields": {
"type": "object",
"description": "Custom key-value attributes to merge"
}
}
}Show the current MisarMail plan, how much of each quota is left, and what upgrading unlocks, with the link to upgrade. Call it any time — not only after hitting a limit. Reads only: it never changes the plan or takes payment; the user upgrades by following the link. On a local install, open=true also opens that link in the user's browser.
| Argument | Type | Description |
|---|---|---|
| open | boolean | Local installs only: also open the upgrade link in the user's browser. Ignored by the hosted server, which returns the link instead. |
| plan | string | Plan slug to open (e.g. 'pro', 'max'). Defaults to the recommended plan. |
{
"type": "object",
"properties": {
"open": {
"type": "boolean",
"description": "Local installs only: also open the upgrade link in the user's browser. Ignored by the hosted server, which returns the link instead."
},
"plan": {
"type": "string",
"description": "Plan slug to open (e.g. 'pro', 'max'). Defaults to the recommended plan."
}
}
}Validate an email address before sending: syntax, MX records, disposable-domain and role-account detection. Use this to protect sender reputation on imported lists.
| Argument | Type | Description |
|---|---|---|
| email* | string | Email address to validate |
{
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Email address to validate"
}
}
}Re-check a domain's DNS records and mark it verified if they resolve. Safe to retry — DNS propagation can take up to 48 hours.
| Argument | Type | Description |
|---|---|---|
| domain_id* | string | Domain ID returned by add_domain |
{
"type": "object",
"required": [
"domain_id"
],
"properties": {
"domain_id": {
"type": "string",
"description": "Domain ID returned by add_domain"
}
}
}| string |
| ISO timestamp for this variant's send_time slot B |
| send_percent | number | Percent of the audience that receives this variant (1-99, default 50) |
| winner_wait_hours | number | Hours to wait before auto-selecting a winner (1-168, default 4) |
| auto_select_winner | boolean | Automatically select and send the winner after winner_wait_hours (default false) |
{
"type": "object",
"required": [
"campaign_id",
"variant"
],
"properties": {
"subject": {
"type": "string",
"description": "Subject line for subject tests"
},
"variant": {
"type": "string",
"description": "Variant label, e.g. 'A' or 'B' (max 5 chars)"
},
"body_html": {
"type": "string",
"description": "Body HTML for content tests"
},
"from_name": {
"type": "string",
"description": "Sender name for from_name tests"
},
"preheader": {
"type": "string",
"description": "Preheader text for preheader tests"
},
"test_type": {
"enum": [
"content",
"subject",
"send_time",
"from_name",
"preheader"
],
"type": "string",
"description": "What this variant differs on (default: content)"
},
"campaign_id": {
"type": "string",
"description": "Campaign to test (UUID)"
},
"send_time_a": {
"type": "string",
"description": "ISO timestamp for this variant's send_time slot A"
},
"send_time_b": {
"type": "string",
"description": "ISO timestamp for this variant's send_time slot B"
},
"send_percent": {
"type": "number",
"description": "Percent of the audience that receives this variant (1-99, default 50)"
},
"winner_wait_hours": {
"type": "number",
"description": "Hours to wait before auto-selecting a winner (1-168, default 4)"
},
"auto_select_winner": {
"type": "boolean",
"description": "Automatically select and send the winner after winner_wait_hours (default false)"
}
}
}{
"type": "object",
"required": [
"name",
"subject",
"from_email",
"from_name"
],
"properties": {
"html": {
"type": "string",
"description": "HTML body content"
},
"name": {
"type": "string",
"description": "Internal campaign name (not shown to recipients)"
},
"text": {
"type": "string",
"description": "Plain text body content"
},
"subject": {
"type": "string",
"description": "Subject line recipients will see"
},
"reply_to": {
"type": "string",
"description": "Reply-to address"
},
"from_name": {
"type": "string",
"description": "Sender display name (required)"
},
"from_email": {
"type": "string",
"description": "Verified sender address"
},
"segment_id": {
"type": "string",
"description": "Audience segment to send to"
},
"template_id": {
"type": "string",
"description": "Use a saved template instead of inline HTML"
}
}
}| object |
| Custom metadata key-value pairs (max 20 pairs) |
| reply_to | object | Reply-to address |
| idempotency_key | string | Unique key to prevent duplicate sends (max 128 chars) |
{
"type": "object",
"required": [
"from",
"to",
"subject"
],
"properties": {
"cc": {
"type": "array",
"items": {
"type": "object",
"required": [
"email"
],
"properties": {
"name": {
"type": "string",
"description": "Recipient display name"
},
"email": {
"type": "string",
"description": "Recipient email address"
}
}
},
"description": "CC recipients (max 50)"
},
"to": {
"type": "array",
"items": {
"type": "object",
"required": [
"email"
],
"properties": {
"name": {
"type": "string",
"description": "Recipient display name"
},
"email": {
"type": "string",
"description": "Recipient email address"
}
}
},
"description": "Recipient list (1–100 addresses)"
},
"bcc": {
"type": "array",
"items": {
"type": "object",
"required": [
"email"
],
"properties": {
"name": {
"type": "string",
"description": "Recipient display name"
},
"email": {
"type": "string",
"description": "Recipient email address"
}
}
},
"description": "BCC recipients (max 50, hidden from other recipients)"
},
"from": {
"type": "object",
"required": [
"email"
],
"properties": {
"name": {
"type": "string",
"description": "Sender display name shown to recipients"
},
"email": {
"type": "string",
"description": "Sender email address"
}
},
"description": "Sender address (must match a verified MisarMail account)"
},
"html": {
"type": "string",
"description": "HTML body (max 500KB, recommended)"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags for tracking (max 10, each max 64 chars)"
},
"text": {
"type": "string",
"description": "Plain text body (max 500KB, fallback for HTML)"
},
"subject": {
"type": "string",
"description": "Email subject (max 998 chars)"
},
"alias_id": {
"type": "string",
"description": "Route via a specific alias SMTP pool"
},
"metadata": {
"type": "object",
"description": "Custom metadata key-value pairs (max 20 pairs)"
},
"reply_to": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"email": {
"type": "string"
}
},
"description": "Reply-to address"
},
"idempotency_key": {
"type": "string",
"description": "Unique key to prevent duplicate sends (max 128 chars)"
}
}
}