MisarMail MCP Server

Delete every email captured in the sandbox. 

The sandbox holds messages intercepted during testing so they are never delivered to real recipients. This DELETES ALL of them and cannot be undone — but itemail. touchesAffects only intercepted test mailmessages, never sent campaigns, real inbox messages, contacts, or templates. 

Takes no parameters and offers no filter: it is all or nothing. Requires an API key. Clearing an already-empty sandbox is harmless. Read anything you still need from the sandbox before calling this.sent mail.

 ⟨17 unchanged words⟩ :"string"},"webhook_url":{"description":"Optional HTTPS URL to POST inbound messages to (required)","type":"string"}},"required":["domain","subdomain","webhook_url"],"type":"object"}

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":false,"title":"Configure inbound"}

Create anone A/B test variant on a campaigncampaign. withThe tworeal orAPI morestores variants.a Asingle samplevariant percentageper iscall, sentso first;build a test by calling this once per variant (e.g. twice for a plain A/B split) using the winnersame goescampaign_id toand distinct `variant` labels. Each variant gets send_percent of the remainderaudience; onceauto_select_winner selected.(with winner_wait_hours) can pick and send the winner automatically, or use select_ab_test_winner to do it manually.

{"properties":{"campaign_idauto_select_winner":{"description":"CampaignAutomatically toselect testand send the winner after winner_wait_hours (default false)","type":"stringboolean"},"sample_percentagebody_html":{"description":"Percent of the audienceBody usedHTML for the test (defaultcontent 20)tests","type":"numberstring"},"typecampaign_id":{"description":"WhatCampaign to test (UUID)","enum

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":falsetrue,"readOnlyHint":false,"title":"Create A/B test"}

Create an automation workflow from a trigger, andsaved anas ordereda listpaused ofdraft. steps.The CreatedAPI's pausedcreate byendpoint defaultonly accepts a name and trigger — callit toggle_automationhas tono activatefields oncefor theworkflow steps areor starting active; configure the step sequence in the MisarMail dashboard's visual builder, and use toggle_automation to activate once reviewed.

{"properties":{"active":{"description":"Start active immediately (default false)","type":"boolean"},"name":{"description":"Automation name","type":"string"},"steps":{"description":"Ordered workflow steps","items":{"properties":{"delay_hours":{"description":"Hours to wait before this step","type":"number"},"subject":{"description":"Subject for send_email steps","type":"string"},"tag":{"description":"Tag for add_tag / remove_tag steps","type":"string"},"template_id":{"description":"Template for send_email steps","type":"string"},"type":{"description":"Step action","enum":["send_email","wait","add_tag","remove_tag","condition"],"type":"string"}},"required":["type"],"type":"object"},"type":"array"},"trigger":{"description":"Event that ⟨29 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":falsetrue,"readOnlyHint":false,"title":"Create automation"}

 ⟨8 unchanged words⟩ ,"from_name":{"description":"Sender display name (required)","type":"string"},"html":{ ⟨53 unchanged words⟩  will see","type":"string"},"tags":{"description":"Contact tags to target","items":{"type":"string"},"type":"array"},"template_id":{"description":"Use a saved template ⟨14 unchanged words⟩ ,"required":["name","subject","from_email","from_name"],"type":"object"}

{"properties":{"company":{"description":"Company name (max 150 chars)","type":"string"},"custom_fields":{"description":"Custom key-value attributes", ⟨14 unchanged words⟩ 100 chars)","type":"string"},"job_title":{"description":"Job title (max 100 chars)","type":"string"},"last_name":{"description":"Last name (max 100 chars)","type":"string"},"phone":{"description":"Phone number (max 50 chars)","type":"string"},"source ⟨24 unchanged words⟩ 

Create a hosted landing page with ana emailsingle capturehero form.block (headline, subheadline, CTA). Returns the public URL;URL. subscribersThe flowreal straightAPI intostores pages as a page-builder block array with no dedicated headline/CTA fields, so this tool translates your contactinputs list.into one 'hero' block — for multi-block pages or a real CTA link, use the landing page editor in the MisarMail dashboard.

 ⟨15 unchanged words⟩ :"string"},"name":{"description":"Internal pagePage nametitle","type":"string"},"slug":{"description":"URL slug (auto-generated from name when omitted)","type":"string"}," ⟨3 unchanged words⟩  line under the headline","type":"string"},"tags":{"description":"Tags applied to contacts who sign up here","items":{"type":"string"},"type":"array"}},"required":["name","headline" ⟨2 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":falsetrue,"readOnlyHint":false,"title":"Create landing page"}

 ⟨27 unchanged words⟩ default professional)","enum":["professional","friendlycasual","urgent","playful","formalinformative"],"type":"string"},"topic": ⟨12 unchanged words⟩ 

Get one automation workflow in full: its trigger, every step with its settings, and current enrolment counts. 

Use it to understand exactly what an automation will do to contacts before activating it — the step list is where sendsdelay, waits and branches become visible. For the list of automations, use list_automations; to start or pause one, toggle_automation. 

Reads only; reading a workflow does not enrol anyone or trigger a step. Requires an API key. An automation can be defined but inactive, so check its state rather than assuming it isper-step running.completion stats.

Get one signup form in full:including its fields, its embed code, and where it redirects after submission. 

Use it when you need the embed snippet to install the form, or need to know which fields it collects before interpreting submissions. For the submitted data itself, use get_form_submissions; for the list of forms, list_forms. 

Reads only; the form is not modified and no submission is created. Requires an API key. The embed code is meant to be pasted into a site, so returning it does not publish anything by itself.redirect behaviour.

List the submissions for a signup form has received, including the values entered in each field. 

Use it to see who signed up and what they told you. This returns PERSONAL DATA — email addresses and whatever else the form collects — so handle it accordingly and do not paste it into shared transcripts. For the form's own definition, use get_form. 

Reads only; submissions aresubmitted notfield deleted,values and nobody is subscribed or emailed as a result. Requires an API key. No submissions is a normal answer, not an error. timestamps.

 ⟨5 unchanged words⟩ inbox conversation, oldest first, with sender and timestamp. 

Use it to read a thread in full before replying or summarising — it is the detail view behind a conversation listing. It covers one conversation, and it does not send, reply, or mark anything as read. 

Reads only. Requires an API key. Message bodies are real customer correspondence, so treat the contents as confidential. Returns the whole thread rather than a page, so long conversations return a lot of text. timestamps.

Get one integration in full: itsintegration's configuration, the scopes it was granted, and the result of its last sync. 

Use it to diagnose an integration that list_integrations shows as unhealthy, or to check which scopes were granted before relying on a capability. Covers a single integration — list_integrations gives the overview. 

Reads only; it does not re-run a sync or change any setting. Requires an API key. The response describes what the integration is permitted to do, which is not the same as what it has successfully done — read the last sync result for that. result.

Get one marketplace listing in full, with its full preview, author, and installation instructions. 

Use it after list_marketplace_items to inspect a template before adopting it — this is the read step, and it does NOT install anything into the account or create a template. Nothing changes until you act on the instructions it returns. 

Reads only. Requires an API key. Marketplace items are authored by third parties, so review the preview before recommending one; the listing describes what the author claims, not something MisarMail has verified. count.

Get newsletter monetization figuresstats: paid subscribers, monthly recurring revenueMRR, churn, and revenue trend. 

Usesponsorship itrevenue for 'how is the paid newsletter doing' questions. These are account-level totals over a trailing window, so they cannot be broken down per campaign — use get_revenue_attribution for that. 

Reads only; no billing state is changed and no subscriber is charged. Requires an API key. Revenue figures are reported in minor currency units unless stated otherwise, so check before presenting them as dollars. Zero paid subscribers is a real answer. period.

Bulk-import up to 5,000 contacts in one call. ExistingBy default, addresses that already exist are updatedskipped rather than duplicated.duplicated — pass update_existing: true to update them instead. Returns per-row results so you can see which ⟨5 unchanged words⟩ 

 ⟨7 unchanged words⟩  5000)","items":{"properties":{"company":{"type":"string"},"email":{"type":"string"},"first_name" ⟨18 unchanged words⟩ {"description":"Update contacts that already exist instead of skipping them (default truefalse)","type":"boolean"}},"required" ⟨3 unchanged words⟩ 

{"destructiveHint":falsetrue,"idempotentHint":false,"openWorldHint":false,"readOnlyHint" ⟨4 unchanged words⟩ 

List A/B tests on the account with each variant'sper-variant results and whether a winner has been picked yet. 

Use it to see which tests are still running and which are waiting on a decision. Reading results here is safe and has no effect on the test — declaring a winner is a separate, irreversible action that sends to the held-back audience. 

Reads only. Requires an API key. A test with no winner selected is still open; treat early results with care, since a lead that looks decisive on a small sample often is not. yet.

 ⟨18 unchanged words⟩ },"type":{"description":"Filter by whattest issource: being'campaign' testedfor campaign A/B tests (subject/content/send_time/from_name variants on a campaign), 'subject' for standalone subject-line tests","enum":["subject","content","send_timecampaign","from_namesubject"],"type":"string"}},"type":"object"}

List the API keys on the account with their scopes and when each was last used. 

Use it to audit access — to spot keys that are unused, over-scoped, or forgotten. It lists key METADATA only:last-used thetime. secretKey valuessecrets are notnever returned by this or any other tool, so a key that has been lost must be rotated rather than recovered. 

Reads only; no key is created, revoked, or rotated. Requires an API key. Scope and last-used data is security-relevant, so treat the listing as sensitive even though it contains no— secrets.only metadata.

List automation workflows on the account — (welcome series, re-engagement, drip sequences —) with their status and enrolment counts. 

Use it to see what is running before adding another workflow that mighttrigger overlap,type and to find an automation id for get_automation or toggle_automation. Listing does not reveal the individual steps; get_automation does that. 

Reads only; nothing is activated, paused, or enrolled. Requires an API key. An automation may exist while inactive, so read the status rather than assuming a listed workflow is sending.active state.

List signup forms on the account with their embed status and conversion counts. 

Use it to find a form id before get_form or get_form_submissions, and to compare how forms are performing against each other. It returns the forms themselves, not the people who filled them in — that is get_form_submissions. 

Reads only; no form is created, published, or unpublished. Requires an API key. A form that exists is not necessarily embedded anywhere, so a zero conversion count may mean it was never installed rather than that it converts badly. 

List every third-party integration connected to the account, with its sync status and when it last ran. 

Start here when a question involves external data — it tells you whichthird-party integrations exist and whether they are actually syncing. For one integration's configuration and scopes, follow up with get_integration; to turn one on or off, use toggle_integration. 

Reads only; nothing is connected, disconnected, or re-synced. Requires an API key. An integration listed as connected can still be failing totheir sync, so check the status rather than assuming. An empty list means nothing is connected yet, which is not an error. status.

Browse the MisarMail template marketplace for ready-made email and automation templates. 

Use it to find a starting point instead of authoring from scratch. This is browse only: it installs nothing, and no template is added to the account by listing it. Inspect a candidate with get_marketplace_item before adopting it. 

Reads only. Requires an API key. Listings are third-party authored, so quality varies. For templates the account already owns, use list_templates instead — these two return different things. 

List the saved email templates on the account, with thetheir variable placeholders each one expects. 

Use it to pick a template before composing a send, and to see which variablesso you must supply — a template rendered with a missing variablecan goespick outone withfor a visible gap. These are the account's own templates; list_marketplace_items covers third-party ones instead. 

Reads only; no template is created, edited,campaign or sent. Requires an API key. An empty list means none have been saved yet, which is not an error.transactional send.

 ⟨3 unchanged words⟩ "Metric the decision was based on (default open_rateopens)","enum":["open_rateopens","click_rateclicks","conversion_raterevenue","conversions"],"type":"string"},"test_id": ⟨22 unchanged words⟩ 

Activate or pause one automation workflow. 

This is consequential in onean direction:automation. ACTIVATINGActivating starts enrolling contacts, which means real emails begin goingand outsending on the workflow's schedule without further confirmation. Pausing stops new enrolments. Read the workflow with get_automation first so you know what activating will actually send. 

Contacts already part-way through a paused workflow are held rather than dropped, so pausing is not a cancellation. Safe to repeat. Requires an API key.configured schedule.

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":false,"title":"Toggle automation"}

Turn one third-party integration onEnable or off. 

This changesdisable livean behaviour:integration. DISABLINGDisabling stops all syncing through that integration, so data quietly stops flowing until it is re-enabled. It does not disconnect the integration or revoke its credentials — the connection and its scopes survive, which is why re-enabling picks up where it left off. 

Safe to repeat: setting an integration to the state it is already in changes nothing. Requires an API key. Call list_integrations first so youbut knowpreserves the current state rather than toggling blind.stored credentials.

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":false,"title":"Toggle integration"}

 ⟨14 unchanged words⟩  unsubscribed immediately excludes them from every future campaign. Does not support tags, phone, company, or job title — the API has no fields for them.

{"properties":{"company":{"description":"Company name","type":"string"},"custom_fields":{"description":"Custom key-value attributes to ⟨14 unchanged words⟩ "First name","type":"string"},"job_title":{"description":"Job title","type":"string"},"last_name":{"description":"Last name","type":"string"},"phone":{"description":"Phone number","type":"string"},"status":{"description":"New subscription status", ⟨3 unchanged words⟩ ,"bounced","complained"],"type":"string"},"tags":{"description":"Replace segmentation tags","items":{"type":"string"},"type":"array"}},"required":["email"],"type":"object"}

{"destructiveHint":falsetrue,"idempotentHint":true,"openWorldHint":false,"readOnlyHint" ⟨4 unchanged words⟩