MCP Server
MisarMail MCP Server
io.github.Misar-AI/misarmail-mcp
What this MCP does
Supports transactional and campaign email, contacts, templates, automations, landing pages, deliverability checks, inbox management, and engagement and revenue analytics.
Capabilities
Tools
54
tools
add_domain
Add a sending domain and return the DNS records to publish. The domain cannot send until those records are live and verify_domain succeeds.
Input schema
{'type': 'object', 'required': ['domain'], 'properties': {'domain': {'type': 'string', 'description': 'Domain to add, e.g. example.com'}}}
archive_email
Move one email out of the inbox and into the archive.
Use it to clear handled mail from the working inbox. This is REVERSIBLE and non-destructive: the message is not deleted, its content is unchanged, and it can be found again through the archive. It does not mark the message read, reply to it, or notify the sender.
Safe to repeat — archiving an already-archived email changes nothing. Requires an API key. Affects exactly one message per call.
Idempotent
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Email ID to archive'}}}
categorize_inbox_emails
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.
Idempotent
Input schema
{'type': 'object', 'required': ['email_ids'], 'properties': {'email_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Email IDs to categorise (max 50 per call)'}}}
check_dmarc
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'required': ['domain'], 'properties': {'domain': {'type': 'string', 'description': 'Domain to check, e.g. example.com'}}}
clear_sandbox
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 it touches only intercepted test mail, 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.
Destructive
Idempotent
Input schema
{'type': 'object', 'properties': {}}
configure_inbound_domain
Configure inbound email routing for a subdomain so replies land in the MisarMail unified inbox. Returns the MX record to publish.
Idempotent
Input schema
{'type': 'object', 'required': ['domain', 'subdomain'], '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': 'Optional HTTPS URL to POST inbound messages to'}}}
create_ab_test
Create an A/B test on a campaign with two or more variants. A sample percentage is sent first; the winner goes to the remainder once selected.
Input schema
{'type': 'object', 'required': ['campaign_id', 'type', 'variants'], 'properties': {'type': {'enum': ['subject', 'content', 'send_time', 'from_name'], 'type': 'string', 'description': 'What to test'}, 'variants': {'type': 'array', 'items': {'type': 'object', 'properties': {'html': {'type': 'string', 'description': 'Body content for content tests'}, 'label': {'type': 'string', 'description': 'Variant label, e.g. A / B'}, 'send_at': {'type': 'string', 'description': 'ISO timestamp for send_time tests'}, 'subject': {'type': 'string', 'description': 'Subject line for subject tests'}, 'from_name': {'type': 'string', 'description': 'Sender name for from_name tests'}}}, 'description': 'Test variants (2–5)'}, 'campaign_id': {'type': 'string', 'description': 'Campaign to test'}, 'winner_metric': {'enum': ['open_rate', 'click_rate', 'conversion_rate'], 'type': 'string', 'description': 'Metric used to pick the winner (default open_rate)'}, 'sample_percentage': {'type': 'number', 'description': 'Percent of the audience used for the test (default 20)'}}}
create_automation
Create an automation workflow from a trigger and an ordered list of steps. Created paused by default — call toggle_automation to activate once the steps are reviewed.
Input schema
{'type': 'object', 'required': ['name', 'trigger'], 'properties': {'name': {'type': 'string', 'description': 'Automation name'}, 'steps': {'type': 'array', 'items': {'type': 'object', 'required': ['type'], 'properties': {'tag': {'type': 'string', 'description': 'Tag for add_tag / remove_tag steps'}, 'type': {'enum': ['send_email', 'wait', 'add_tag', 'remove_tag', 'condition'], 'type': 'string', 'description': 'Step action'}, 'subject': {'type': 'string', 'description': 'Subject for send_email steps'}, 'delay_hours': {'type': 'number', 'description': 'Hours to wait before this step'}, 'template_id': {'type': 'string', 'description': 'Template for send_email steps'}}}, 'description': 'Ordered workflow steps'}, 'active': {'type': 'boolean', 'description': 'Start active immediately (default false)'}, '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_campaign
Create a new email marketing campaign as a draft. Creating never sends — call send_campaign separately once the content and audience are confirmed.
Input schema
{'type': 'object', 'required': ['name', 'subject', 'from_email'], 'properties': {'html': {'type': 'string', 'description': 'HTML body content'}, 'name': {'type': 'string', 'description': 'Internal campaign name (not shown to recipients)'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Contact tags to target'}, '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'}, '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'}, 'scheduled_at': {'type': 'string', 'description': 'ISO 8601 timestamp to schedule the send (omit to keep as draft)'}}}
create_contact
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.
Input schema
{'type': 'object', 'required': ['email'], 'properties': {'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Segmentation tags'}, 'email': {'type': 'string', 'description': 'Contact email address'}, 'phone': {'type': 'string', 'description': 'Phone number (max 50 chars)'}, 'source': {'type': 'string', 'description': 'Where this contact came from (max 100 chars)'}, 'company': {'type': 'string', 'description': 'Company name (max 150 chars)'}, 'job_title': {'type': 'string', 'description': 'Job title (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_landing_page
Create a hosted landing page with an email capture form. Returns the public URL; subscribers flow straight into your contact list.
Input schema
{'type': 'object', 'required': ['name', 'headline'], 'properties': {'name': {'type': 'string', 'description': 'Internal page name'}, 'slug': {'type': 'string', 'description': 'URL slug (auto-generated when omitted)'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Tags applied to contacts who sign up here'}, '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_template
Create a reusable email template. Use {{variable}} placeholders for personalisation — they are substituted at send time and previewable via render_template.
Input schema
{'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_report
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).
Read only
Idempotent
Input schema
{'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_subject_lines
Generate AI subject-line variants for a campaign topic, optionally tuned to a tone and audience. Good input for create_ab_test.
Open world
Input schema
{'type': 'object', 'required': ['topic'], 'properties': {'tone': {'enum': ['professional', 'friendly', 'urgent', 'playful', 'formal'], '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_analytics
Get delivery and engagement analytics — sent, delivered, opened, clicked, bounced, and complained — for the account or one campaign, grouped by day/week/month.
Read only
Idempotent
Input schema
{'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_automation
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 sends, 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 is running.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['automation_id'], 'properties': {'automation_id': {'type': 'string', 'description': 'Automation ID (UUID)'}}}
get_campaign
Get full details for one campaign: content, audience segment, schedule, and delivery statistics (sent, opened, clicked, bounced, complained).
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['campaign_id'], 'properties': {'campaign_id': {'type': 'string', 'description': 'Campaign ID (UUID)'}}}
get_contact_score
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.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'contact_id': {'type': 'string', 'description': 'Contact ID to score (omit to return the lowest-engagement contacts)'}}}
get_deliverability_score
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.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
get_email
Read the full content of a single email by ID, including headers, body, and attachments metadata. Side effect: marks the email as read.
Idempotent
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Email ID (UUID)'}}}
get_form
Get one signup form in full: 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.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['form_id'], 'properties': {'form_id': {'type': 'string', 'description': 'Form ID (UUID)'}}}
get_form_submissions
List the submissions 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 are not deleted, and nobody is subscribed or emailed as a result. Requires an API key. No submissions is a normal answer, not an error.
Read only
Idempotent
Input schema
{'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_inbox_conversation_messages
Get every message in one 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.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['conversation_id'], 'properties': {'conversation_id': {'type': 'string', 'description': 'Conversation ID (UUID)'}}}
get_integration
Get one integration in full: its 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.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['integration_id'], 'properties': {'integration_id': {'type': 'string', 'description': 'Integration ID'}}}
get_marketplace_item
Get one marketplace listing in full, with its 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.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['item_id'], 'properties': {'item_id': {'type': 'string', 'description': 'Marketplace item ID'}}}
get_monetization_stats
Get newsletter monetization figures: paid subscribers, monthly recurring revenue, churn, and revenue trend.
Use it 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.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'period': {'enum': ['today', '7d', '30d', '90d'], 'type': 'string', 'description': 'Time window (default 30d)'}}}
get_revenue_attribution
Attribute ecommerce revenue to email — revenue per campaign, per contact, and average order value from tracked conversions.
Read only
Idempotent
Input schema
{'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_warmup_status
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.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
import_contacts
Bulk-import up to 5,000 contacts in one call. Existing addresses are updated rather than duplicated. Returns per-row results so you can see which rows were rejected and why.
Input schema
{'type': 'object', 'required': ['contacts'], 'properties': {'contacts': {'type': 'array', 'items': {'type': 'object', 'required': ['email'], 'properties': {'tags': {'type': 'array', 'items': {'type': 'string'}}, 'email': {'type': 'string'}, 'company': {'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 (default true)'}}}
list_ab_tests
List A/B tests on the account with each variant's 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.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'page': {'type': 'number', 'description': 'Page number (default 1)'}, 'type': {'enum': ['subject', 'content', 'send_time', 'from_name'], 'type': 'string', 'description': 'Filter by what is being tested'}, 'limit': {'type': 'number', 'description': 'Results per page (default 20)'}}}
list_api_keys
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: the secret values are not 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.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
list_automations
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 might overlap, 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.
Read only
Idempotent
Input schema
{'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_campaigns
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.
Read only
Idempotent
Input schema
{'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
List contacts with their subscription status and engagement metrics. Filter by status to find unsubscribed or bounced addresses that should be excluded from sends.
Read only
Idempotent
Input schema
{'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_domains
List sending domains with verification status and their DKIM/SPF/DMARC records. Check here first when a send fails with an unverified-sender error.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'page': {'type': 'number', 'description': 'Page number (default 1)'}, 'limit': {'type': 'number', 'description': 'Results per page (default 20)'}}}
list_emails
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.
Read only
Idempotent
Input schema
{'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_forms
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.
Read only
Idempotent
Input schema
{'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_inbox_conversations
List unified-inbox conversations (threads) with their status and detected intent. Use this for triage; use list_emails for individual messages in a folder.
Read only
Idempotent
Input schema
{'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_integrations
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 which 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 to sync, so check the status rather than assuming. An empty list means nothing is connected yet, which is not an error.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'page': {'type': 'number', 'description': 'Page number (default 1)'}, 'limit': {'type': 'number', 'description': 'Results per page (default 20)'}}}
list_marketplace_items
Browse the MisarMail 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.
Read only
Idempotent
Input schema
{'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_sandbox_sends
List emails captured by sandbox mode. Sandbox intercepts sends instead of delivering them — use it to verify templates and automations without emailing anyone.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {}}
list_templates
List the saved email templates on the account, with the variable placeholders each one expects.
Use it to pick a template before composing a send, and to see which variables you must supply — a template rendered with a missing variable goes out with 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, or sent. Requires an API key. An empty list means none have been saved yet, which is not an error.
Read only
Idempotent
Input schema
{'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_template
Render a template with sample variables and return the resulting HTML and subject. Use this to preview personalisation before sending anything.
Read only
Idempotent
Input schema
{'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_email
Reply to an existing email thread. The sender address and threading headers are derived from the original message, so only the body is required.
Open world
Input schema
{'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_deliverability_audit
Run a full deliverability audit across authentication (SPF/DKIM/DMARC), domain reputation, list hygiene, content signals, and blocklist status. Returns prioritized findings.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'properties': {}}
select_ab_test_winner
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.
Destructive
Open world
Input schema
{'type': 'object', 'required': ['test_id', 'winner_variant'], 'properties': {'metric': {'enum': ['open_rate', 'click_rate', 'conversion_rate'], 'type': 'string', 'description': 'Metric the decision was based on (default open_rate)'}, 'test_id': {'type': 'string', 'description': 'A/B test ID'}, 'winner_variant': {'type': 'string', 'description': 'Label of the winning variant, e.g. B'}}}
send_campaign
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.
Destructive
Open world
Input schema
{'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_email
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.
Open world
Input schema
{'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)'}}}
toggle_automation
Activate or pause one automation workflow.
This is consequential in one direction: ACTIVATING starts enrolling contacts, which means real emails begin going out 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.
Idempotent
Input schema
{'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)'}}}
toggle_integration
Turn one third-party integration on or off.
This changes live behaviour: DISABLING 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 you know the current state rather than toggling blind.
Idempotent
Input schema
{'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_contact
Update an existing contact by email address, including changing subscription status. Setting status to unsubscribed immediately excludes them from every future campaign.
Idempotent
Input schema
{'type': 'object', 'required': ['email'], 'properties': {'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Replace segmentation tags'}, 'email': {'type': 'string', 'description': 'Email address identifying the contact'}, 'phone': {'type': 'string', 'description': 'Phone number'}, 'status': {'enum': ['subscribed', 'unsubscribed', 'bounced', 'complained'], 'type': 'string', 'description': 'New subscription status'}, 'company': {'type': 'string', 'description': 'Company name'}, 'job_title': {'type': 'string', 'description': 'Job title'}, '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'}}}
upgrade
Show the current MisarMail plan, how much of each quota is left, and what upgrading unlocks. Call it any time — not only after hitting a limit. Set open=true to open the checkout page in the default browser.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'properties': {'open': {'type': 'boolean', 'description': 'Open the upgrade/checkout page in the default browser.'}, 'plan': {'type': 'string', 'description': "Plan slug to open (e.g. 'pro', 'max'). Defaults to the recommended plan."}}}
validate_email
Validate an email address before sending: syntax, MX records, disposable-domain and role-account detection. Use this to protect sender reputation on imported lists.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'required': ['email'], 'properties': {'email': {'type': 'string', 'description': 'Email address to validate'}}}
verify_domain
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.
Open world
Idempotent
Input schema
{'type': 'object', 'required': ['domain_id'], 'properties': {'domain_id': {'type': 'string', 'description': 'Domain ID returned by add_domain'}}}
History
Recent tool changes
Added
upgrade
Sept. 17, 2026, 12:45 p.m.
Added
clear_sandbox
Sept. 17, 2026, 12:45 p.m.
Added
list_sandbox_sends
Sept. 17, 2026, 12:45 p.m.
Added
toggle_integration
Sept. 17, 2026, 12:45 p.m.
Added
get_integration
Sept. 17, 2026, 12:45 p.m.
Added
list_integrations
Sept. 17, 2026, 12:45 p.m.
Added
generate_subject_lines
Sept. 17, 2026, 12:45 p.m.
Added
list_api_keys
Sept. 17, 2026, 12:45 p.m.
Added
categorize_inbox_emails
Sept. 17, 2026, 12:45 p.m.
Added
get_inbox_conversation_messages
Sept. 17, 2026, 12:45 p.m.
Added
list_inbox_conversations
Sept. 17, 2026, 12:45 p.m.
Added
get_marketplace_item
Sept. 17, 2026, 12:45 p.m.
Added
list_marketplace_items
Sept. 17, 2026, 12:45 p.m.
Added
create_landing_page
Sept. 17, 2026, 12:45 p.m.
Added
get_form_submissions
Sept. 17, 2026, 12:45 p.m.
Added
get_form
Sept. 17, 2026, 12:45 p.m.
Added
list_forms
Sept. 17, 2026, 12:45 p.m.
Added
configure_inbound_domain
Sept. 17, 2026, 12:45 p.m.
Added
verify_domain
Sept. 17, 2026, 12:45 p.m.
Added
add_domain
Sept. 17, 2026, 12:45 p.m.
Added
list_domains
Sept. 17, 2026, 12:45 p.m.
Added
check_dmarc
Sept. 17, 2026, 12:45 p.m.
Added
get_warmup_status
Sept. 17, 2026, 12:45 p.m.
Added
run_deliverability_audit
Sept. 17, 2026, 12:45 p.m.
Added
get_deliverability_score
Sept. 17, 2026, 12:45 p.m.
Added
get_monetization_stats
Sept. 17, 2026, 12:45 p.m.
Added
get_revenue_attribution
Sept. 17, 2026, 12:45 p.m.
Added
generate_report
Sept. 17, 2026, 12:45 p.m.
Added
get_analytics
Sept. 17, 2026, 12:45 p.m.
Added
select_ab_test_winner
Sept. 17, 2026, 12:45 p.m.
Discover
Similar MCP servers
neuron
io.github.conquext/neuron
Operates AI chatbots and messaging workflows across WhatsApp and social channels, including contacts, campaigns, conversations, p…
commsharbor
com.commsharbor/commsharbor
Manages permission-based email audiences, contacts, campaigns, transactional sends, billing, consent, and tenant audit trails.
Emailchaser
com.emailchaser/emailchaser
Manages cold-email campaigns, leads, sender mailboxes, sequences, outreach automation, deliverability, prospect sourcing, webhook…
send16-mcp
io.github.spruikco/send16-mcp
Provides email marketing and transactional messaging tools for contacts, audiences, campaigns, templates, automations, analytics,…
Mailrith Email Marketing
com.mailrith/mailrith
Manages email marketing subscribers, templates, broadcasts, automations, scheduling, testing, and campaign analytics.
mcp
ai.sendraven/mcp
Sends email, reads threaded replies, and runs campaigns with per-key limits.
Sendgrid
io.github.pipeworx-io/sendgrid
Accesses SendGrid email delivery data, including sending statistics, bounces, and blocked recipients.
postari
io.github.wilmendezofficial/postari
Manages email campaigns, transactional messages, contacts, forms, landing pages, automations, launches, and delivery metrics.