MisarMail MCP
An MCP server for the MisarMail AI email marketing platform that enables agents to send transactional emails, run marketing campaigns, manage contacts, and audit deliverability metrics.
Endpoint and access
OAuth sign-in: the first time you connect, your client opens the vendor's own authorization prompt in a browser.
https://api.misar.io/mail/mcpWhat its tools do
55 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (33)
list_emailsvalidate_emaillist_campaignsget_campaignlist_contactsget_contact_scorelist_templatesrender_templatelist_automationsget_automationlist_ab_testsget_analyticsget_analytics_timelinegenerate_reportget_revenue_attributionget_monetization_statsget_deliverability_scorerun_deliverability_auditget_warmup_statuscheck_dmarclist_domainslist_formsget_formget_form_submissionslist_marketplace_itemsget_marketplace_itemlist_inbox_conversationsget_inbox_conversation_messageslist_api_keyslist_integrationsget_integrationlist_sandbox_sendsupgrade
Can change data (22)
send_emailget_emailreply_to_emailarchive_emailcreate_campaignsend_campaigncreate_contactupdate_contactimport_contactscreate_templatecreate_automationtoggle_automationcreate_ab_testselect_ab_test_winneradd_domainverify_domainconfigure_inbound_domaincreate_landing_pagecategorize_inbox_emailsgenerate_subject_linestoggle_integrationclear_sandbox
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Send transactional emails
- Run marketing campaigns
- Manage contact lists
- Audit email deliverability
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- misarmail 5.1.5
- MCP protocol negotiated in check
- 2025-06-18
- Tools
- 55 advertised
- Resources
- 4 advertised
- Resource templates
- Sign-in required
- Prompts
- 8 advertised
{
"tools": {},
"prompts": {},
"resources": {}
}Tools
55 advertised
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.
{
"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)"
}
}
}{
"title": "Send email",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}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.
{
"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"
}
}
}{
"title": "List emails",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Email ID (UUID)"
}
}
}{
"title": "Read email",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"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"
}
}
}{
"title": "Reply to email",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}archive_email
Move an email to the archive folder. Reversible — the message is not deleted.
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Email ID to archive"
}
}
}{
"title": "Archive email",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Email address to validate"
}
}
}{
"title": "Validate address",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"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"
}
}
}{
"title": "List campaigns",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_campaign
Get full details for one campaign: content, audience segment, schedule, and delivery statistics (sent, opened, clicked, bounced, complained).
{
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"description": "Campaign ID (UUID)"
}
}
}{
"title": "Get campaign",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}create_campaign
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.
{
"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"
}
}
}{
"title": "Create campaign",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}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.
{
"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"
}
}
}{
"title": "Send campaign",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}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.
{
"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"
}
}
}{
"title": "List contacts",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"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"
}
}
}{
"title": "Create contact",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}update_contact
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.
{
"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"
}
}
}{
"title": "Update contact",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}import_contacts
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.
{
"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)"
}
}
}{
"title": "Import contacts",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}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.
{
"type": "object",
"properties": {
"contact_id": {
"type": "string",
"description": "Contact ID to score (omit to return the lowest-engagement contacts)"
}
}
}{
"title": "Contact engagement score",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_templates
List saved email templates with their variable placeholders, so you can pick one for a campaign or transactional send.
{
"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)"
}
}
}{
"title": "List templates",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}create_template
Create a reusable email template. Use {{variable}} placeholders for personalisation — they are substituted at send time and previewable via render_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"
}
}
}{
"title": "Create template",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}render_template
Render a template with sample variables and return the resulting HTML and subject. Use this to preview personalisation before sending anything.
{
"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"
}
}
}{
"title": "Render template",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_automations
List automation workflows (welcome series, re-engagement, drip sequences) with their trigger type and active state.
{
"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"
}
}
}{
"title": "List automations",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_automation
Get one automation workflow in full: trigger, every step with its delay, and per-step completion stats.
{
"type": "object",
"required": [
"automation_id"
],
"properties": {
"automation_id": {
"type": "string",
"description": "Automation ID (UUID)"
}
}
}{
"title": "Get automation",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}create_automation
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.
{
"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"
}
}
}{
"title": "Create automation",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}toggle_automation
Activate or pause an automation. Activating starts enrolling contacts and sending on the configured schedule.
{
"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)"
}
}
}{
"title": "Toggle automation",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}list_ab_tests
List A/B tests with per-variant results and whether a winner has been selected yet.
{
"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)"
}
}
}{
"title": "List A/B tests",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}create_ab_test
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.
{
"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)"
}
}
}{
"title": "Create A/B test",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}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.
{
"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"
}
}
}{
"title": "Select A/B winner",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}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.
{
"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)"
}
}
}{
"title": "Get analytics",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_analytics_timeline
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.
{
"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)"
}
}
}{
"title": "Get analytics timeline",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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).
{
"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"
}
}
}{
"title": "Generate report",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_revenue_attribution
Attribute ecommerce revenue to email — revenue per campaign, per contact, and average order value from tracked conversions.
{
"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"
}
}
}{
"title": "Revenue attribution",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_monetization_stats
Get newsletter monetization stats: paid subscribers, MRR, churn, and sponsorship revenue for the period.
{
"type": "object",
"properties": {
"period": {
"enum": [
"today",
"7d",
"30d",
"90d"
],
"type": "string",
"description": "Time window (default 30d)"
}
}
}{
"title": "Monetization stats",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"properties": {}
}{
"title": "Deliverability score",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"properties": {}
}{
"title": "Deliverability audit",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"properties": {}
}{
"title": "Warm-up status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "Domain to check, e.g. example.com"
}
}
}{
"title": "Check DMARC/SPF/DKIM",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Page number (default 1)"
},
"limit": {
"type": "number",
"description": "Results per page (default 20)"
}
}
}{
"title": "List domains",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "Domain to add, e.g. example.com"
}
}
}{
"title": "Add domain",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}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.
{
"type": "object",
"required": [
"domain_id"
],
"properties": {
"domain_id": {
"type": "string",
"description": "Domain ID returned by add_domain"
}
}
}{
"title": "Verify domain",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}configure_inbound_domain
Configure inbound email routing for a subdomain so replies land in the MisarMail unified inbox. Returns the MX record to publish.
{
"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)"
}
}
}{
"title": "Configure inbound",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}list_forms
List signup forms with their embed status and conversion counts.
{
"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"
}
}
}{
"title": "List forms",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_form
Get one signup form including its fields, embed code, and redirect behaviour.
{
"type": "object",
"required": [
"form_id"
],
"properties": {
"form_id": {
"type": "string",
"description": "Form ID (UUID)"
}
}
}{
"title": "Get form",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_form_submissions
List submissions for a signup form, including the submitted field values and timestamps.
{
"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)"
}
}
}{
"title": "Form submissions",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}create_landing_page
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.
{
"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"
}
}
}{
"title": "Create landing page",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}list_marketplace_items
Browse the MisarMail template marketplace for ready-made email and automation templates.
{
"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"
}
}
}{
"title": "Browse marketplace",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_marketplace_item
Get one marketplace listing with its full preview, author, and install count.
{
"type": "object",
"required": [
"item_id"
],
"properties": {
"item_id": {
"type": "string",
"description": "Marketplace item ID"
}
}
}{
"title": "Get marketplace item",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"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"
}
}
}{
"title": "List conversations",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_inbox_conversation_messages
Get every message in one inbox conversation, oldest first, with sender and timestamps.
{
"type": "object",
"required": [
"conversation_id"
],
"properties": {
"conversation_id": {
"type": "string",
"description": "Conversation ID (UUID)"
}
}
}{
"title": "Conversation messages",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"required": [
"email_ids"
],
"properties": {
"email_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Email IDs to categorise (max 50 per call)"
}
}
}{
"title": "Categorize inbox",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_api_keys
List API keys on the account with their scopes and last-used time. Key secrets are never returned — only metadata.
{
"type": "object",
"properties": {}
}{
"title": "List API keys",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"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"
}
}
}{
"title": "Generate subject lines",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}list_integrations
List connected third-party integrations and their sync status.
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Page number (default 1)"
},
"limit": {
"type": "number",
"description": "Results per page (default 20)"
}
}
}{
"title": "List integrations",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_integration
Get one integration's configuration, scopes, and last sync result.
{
"type": "object",
"required": [
"integration_id"
],
"properties": {
"integration_id": {
"type": "string",
"description": "Integration ID"
}
}
}{
"title": "Get integration",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}toggle_integration
Enable or disable an integration. Disabling stops all syncing but preserves the stored credentials.
{
"type": "object",
"required": [
"integration_id",
"enabled"
],
"properties": {
"enabled": {
"type": "boolean",
"description": "true to enable, false to disable"
},
"integration_id": {
"type": "string",
"description": "Integration ID"
}
}
}{
"title": "Toggle integration",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"properties": {}
}{
"title": "List sandbox sends",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}clear_sandbox
Delete every captured sandbox email. Affects only intercepted test messages, never real sent mail.
{
"type": "object",
"properties": {}
}{
"title": "Clear sandbox",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}upgrade
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.
{
"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."
}
}
}{
"title": "Plan usage and upgrade",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}Prompts
8 advertised
compose_email
Draft a professional email and send it via MisarMail after confirmation.
- purpose
- Purpose (welcome, follow-up, announcement…) (required)
- tone
- professional | friendly | formal | playful
- recipient_name
- Name of the recipient
campaign_performance_report
Analyse campaign performance and produce prioritized improvements.
- period
- today | 7d | 30d | 90d
contact_import_guide
Import and organise contacts safely, with consent and hygiene checks.
- source
- CSV, CRM, spreadsheet…
automation_builder_guide
Design and build an email automation workflow step by step.
- goal
- welcome series, re-engagement, onboarding…
deliverability_improvement_plan
Diagnose deliverability and produce a prioritized weekly action plan.
ab_test_plan
Design a statistically meaningful A/B test for a campaign.
- campaign_id
- Campaign to test
- hypothesis
- What you believe will improve results
list_hygiene_audit
Find and clean the contacts that are hurting sender reputation.
weekly_email_report
Produce a stakeholder-ready weekly email performance summary.
- period
- today | 7d | 30d | 90d
Resources
4 advertised
Verified sending domains
Your sending domains with verification state and DNS records. Read this before composing any send — an unverified sender is the most common send failure.
misarmail://account/domainsDeliverability score
Current account deliverability score (0–100), grade, and contributing factors.
misarmail://account/deliverabilityWarm-up capacity
IP/domain warm-up stage and remaining send capacity for today — the ceiling a bulk send must stay under.
misarmail://account/warmupEmail templates
Saved templates with their declared variables, for reuse in campaigns and sends.
misarmail://templates90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-06: 1 of 1 checks answered
- 2026-11-07: 2 of 2 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 2796 ms
- 95th percentile latency
- 2796 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 2796 ms · metadata changed · refuses unauthenticated resources/templates/list (HTTP 401)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http misar-mcp https://api.misar.io/mail/mcpCodex
codex mcp add misar-mcp --url https://api.misar.io/mail/mcpCursor
{
"mcpServers": {
"misar-mcp": {
"url": "https://api.misar.io/mail/mcp"
}
}
}Cline
{
"mcpServers": {
"misar-mcp": {
"type": "streamableHttp",
"url": "https://api.misar.io/mail/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"misar-mcp": {
"type": "http",
"url": "https://api.misar.io/mail/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http misar-mcp https://api.misar.io/mail/mcpClaude Desktop
https://api.misar.io/mail/mcpWindsurf
{
"mcpServers": {
"misar-mcp": {
"serverUrl": "https://api.misar.io/mail/mcp"
}
}
}Let your agent find its tools
Find servers like MisarMail MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.