AI agent email — 23 tools free to read inbox, 28 paid to send. $9.99/mo. Token auto-provisioned.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Add a customer sending domain. Generates DKIM keys and returns the 4 DNS records the customer needs to add. Works like SendGrid domain authentication — self-hosted.
Customer domain (e.g. company.com)
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Add a customer sending domain. Generates DKIM keys and returns the 4 DNS records the customer needs to add. Works like SendGrid domain authentication — self-hosted.
| Argument | Type | Description |
|---|---|---|
| domain* | string | Customer domain (e.g. company.com) |
{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "Customer domain (e.g. company.com)"
}
}
}Check if email providers are configured, guide setup if needed
No arguments.
{
"type": "object",
"properties": {}
}Check the status of a pending WireGuard IP provisioning request
| Argument | Type | Description |
|---|---|---|
| request_id | string | Request ID from request_email_ip (omit to check saved request) |
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"optional": true,
"description": "Request ID from request_email_ip (omit to check saved request)"
}
}
}Configure Mailgun email provider with step-by-step guidance
| Argument | Type | Description |
|---|---|---|
| domain* | string | Mailgun domain (e.g., mg.yourdomain.com) |
| api_key* | string | Mailgun API Key (starts with "key-") |
| from_email* | string | From email address (e.g., [email protected]) |
{
"type": "object",
"required": [
"api_key",
"domain",
"from_email"
],
"properties": {
"domain": {
"type": "string",
"description": "Mailgun domain (e.g., mg.yourdomain.com)"
},
"api_key": {
"type": "string",
"description": "Mailgun API Key (starts with \"key-\")"
},
"from_email": {
"type": "string",
"description": "From email address (e.g., [email protected])"
}
}
}Create an email account with SMTP credentials. Returns SMTP password once — save it. The account can then send/receive via this server.
| Argument | Type | Description |
|---|---|---|
| domain | string | Sending domain (auto-derived from address if omitted) |
| address* | string | Email address (e.g. [email protected]) |
| display_name | string | Display name for the account |
{
"type": "object",
"required": [
"address"
],
"properties": {
"domain": {
"type": "string",
"optional": true,
"description": "Sending domain (auto-derived from address if omitted)"
},
"address": {
"type": "string",
"description": "Email address (e.g. [email protected])"
},
"display_name": {
"type": "string",
"optional": true,
"description": "Display name for the account"
}
}
}Create a rule that triggers actions when incoming emails match conditions. Actions: forward, auto_reply, webhook, flag, move, mcp_tool, log, reject.
| Argument | Type | Description |
|---|---|---|
| name* | string | Rule name (unique) |
| stop | boolean | Stop processing further rules after this one matches (default: false) |
| match* | object | Match conditions (ALL must match). Use from, domain, subject, subject_regex, body_contains, has_attachments, to, header. |
| actions* | array | Actions to execute when rule matches |
| priority | number | Priority (lower = evaluated first, default 100) |
| description | string | What this rule does |
{
"type": "object",
"required": [
"name",
"match",
"actions"
],
"properties": {
"name": {
"type": "string",
"description": "Rule name (unique)"
},
"stop": {
"type": "boolean",
"optional": true,
"description": "Stop processing further rules after this one matches (default: false)"
},
"match": {
"type": "object",
"properties": {
"to": {
"type": "string",
"description": "Recipient address or pattern"
},
"from": {
"type": "string",
"description": "Sender address or pattern (*@domain.com)"
},
"domain": {
"type": "string",
"description": "Sender domain"
},
"subject": {
"type": "string",
"description": "Subject contains text"
},
"body_contains": {
"type": "string",
"description": "Body contains text"
},
"subject_regex": {
"type": "string",
"description": "Subject regex pattern"
},
"has_attachments": {
"type": "boolean",
"description": "Has attachments"
}
},
"description": "Match conditions (ALL must match). Use from, domain, subject, subject_regex, body_contains, has_attachments, to, header."
},
"actions": {
"type": "array",
"items": {
"type": "object",
"required": [
"type"
],
"properties": {
"to": {
"type": "string",
"description": "For forward: recipient address"
},
"url": {
"type": "string",
"description": "For webhook: URL to POST to"
},
"args": {
"type": "object",
"description": "For mcp_tool: arguments to pass",
"additionalProperties": true
},
"body": {
"type": "string",
"description": "For auto_reply: reply body text"
},
"flag": {
"type": "string",
"description": "For flag: flag name (default: important)"
},
"tool": {
"type": "string",
"description": "For mcp_tool: MCP tool name to invoke"
},
"type": {
"enum": [
"forward",
"auto_reply",
"webhook",
"flag",
"move",
"mcp_tool",
"log",
"reject"
],
"type": "string"
},
"folder": {
"type": "string",
"description": "For move: target folder"
},
"reason": {
"type": "string",
"description": "For reject: rejection reason"
},
"subject": {
"type": "string",
"description": "For auto_reply: reply subject"
}
}
},
"description": "Actions to execute when rule matches"
},
"priority": {
"type": "number",
"optional": true,
"description": "Priority (lower = evaluated first, default 100)"
},
"description": {
"type": "string",
"optional": true,
"description": "What this rule does"
}
}
}Create a new local mailbox for receiving email (autonomous mode). Each address gets its own inbox accessible via MCP tools.
| Argument | Type | Description |
|---|---|---|
| address* | string | Email address for the mailbox (e.g. [email protected]) |
| display_name | string | Display name for the mailbox |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "Email address for the mailbox (e.g. [email protected])"
},
"display_name": {
"type": "string",
"optional": true,
"description": "Display name for the mailbox"
}
}
}Delete an email account and revoke its SMTP credentials
| Argument | Type | Description |
|---|---|---|
| address* | string | Email address of the account to delete |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "Email address of the account to delete"
}
}
}Delete an email rule by ID
| Argument | Type | Description |
|---|---|---|
| rule_id* | string | Rule ID to delete |
{
"type": "object",
"required": [
"rule_id"
],
"properties": {
"rule_id": {
"type": "string",
"description": "Rule ID to delete"
}
}
}Delete a local mailbox and all its stored emails (autonomous mode)
| Argument | Type | Description |
|---|---|---|
| address* | string | Email address of the mailbox to delete |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "Email address of the mailbox to delete"
}
}
}Get full conversation context for a specific thread
| Argument | Type | Description |
|---|---|---|
| threadId* | string | Thread ID to get conversation for |
| maxEmails | number | Maximum number of emails to include in context |
{
"type": "object",
"required": [
"threadId"
],
"properties": {
"threadId": {
"type": "string",
"description": "Thread ID to get conversation for"
},
"maxEmails": {
"type": "number",
"default": 10,
"description": "Maximum number of emails to include in context"
}
}
}Get conversation threads with forwarded emails
| Argument | Type | Description |
|---|---|---|
| limit | number | Maximum number of threads to return |
| since | string | Filter threads active since this date (ISO string) |
| subject | string | Filter threads by subject content |
| participant | string | Filter threads by participant email address |
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 20,
"description": "Maximum number of threads to return"
},
"since": {
"type": "string",
"description": "Filter threads active since this date (ISO string)"
},
"subject": {
"type": "string",
"description": "Filter threads by subject content"
},
"participant": {
"type": "string",
"description": "Filter threads by participant email address"
}
}
}Generate all required DNS records (A, MX, SPF, DKIM, DMARC) for autonomous email. Outputs copyable records for your DNS provider.
| Argument | Type | Description |
|---|---|---|
| ipv4* | string | Your dedicated IPv4 address (from WireGuard provisioning) |
| domain* | string | Your email domain (e.g. company.com) |
| dmarc_policy | string | DMARC policy (default: reject) |
| dkim_selector | string | DKIM selector (default: emailmcp) |
| mail_hostname | string | Mail server hostname (default: mail.domain) |
{
"type": "object",
"required": [
"domain",
"ipv4"
],
"properties": {
"ipv4": {
"type": "string",
"description": "Your dedicated IPv4 address (from WireGuard provisioning)"
},
"domain": {
"type": "string",
"description": "Your email domain (e.g. company.com)"
},
"dmarc_policy": {
"enum": [
"none",
"quarantine",
"reject"
],
"type": "string",
"optional": true,
"description": "DMARC policy (default: reject)"
},
"dkim_selector": {
"type": "string",
"optional": true,
"description": "DKIM selector (default: emailmcp)"
},
"mail_hostname": {
"type": "string",
"optional": true,
"description": "Mail server hostname (default: mail.domain)"
}
}
}Get the DNS records a customer needs to add for a sending domain
| Argument | Type | Description |
|---|---|---|
| domain* | string | Customer domain |
{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "Customer domain"
}
}
}List mails received in the verification window for a given domain (e.g. to find Apple's verification code without checking the forward_to mailbox).
| Argument | Type | Description |
|---|---|---|
| domain* | string | Domain to filter on |
{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "Domain to filter on"
}
}
}Show active verification windows, the receiver state, and TTLs.
No arguments.
{
"type": "object",
"properties": {}
}Get email usage statistics — delivery rate, bounce rate, per-domain breakdown, top bounce reasons. Reads from persistent stats.
| Argument | Type | Description |
|---|---|---|
| domain | string | Filter stats by domain |
| period | string | Time period for usage statistics |
| account | string | Filter stats by account address |
{
"type": "object",
"properties": {
"domain": {
"type": "string",
"optional": true,
"description": "Filter stats by domain"
},
"period": {
"enum": [
"hour",
"day",
"week",
"month"
],
"type": "string",
"default": "day",
"description": "Time period for usage statistics"
},
"account": {
"type": "string",
"optional": true,
"description": "Filter stats by account address"
}
}
}Retrieve forwarded emails with optional filtering
| Argument | Type | Description |
|---|---|---|
| limit | number | Maximum number of emails to return |
| since | string | Filter emails since this date (ISO string) |
| threadId | string | Filter by conversation thread ID |
| originalSender | string | Filter by original sender email address |
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 50,
"description": "Maximum number of emails to return"
},
"since": {
"type": "string",
"description": "Filter emails since this date (ISO string)"
},
"threadId": {
"type": "string",
"description": "Filter by conversation thread ID"
},
"originalSender": {
"type": "string",
"description": "Filter by original sender email address"
}
}
}Get current health status of the email server — tunnel, SMTP, DNS, IP blocklist checks
No arguments.
{
"type": "object",
"properties": {}
}Get status of IMAP IDLE watchers — which accounts are being watched, connection status, new email counts
No arguments.
{
"type": "object",
"properties": {}
}Get status information for an email mailbox. If IMAP is configured in .env, no credentials needed. Use "account" to pick a named account.
| Argument | Type | Description |
|---|---|---|
| account | string | Named account (e.g. "work", "personal"). Omit for default. |
| mailbox | string | Mailbox to check |
| imap_config | object |
{
"type": "object",
"properties": {
"account": {
"type": "string",
"optional": true,
"description": "Named account (e.g. \"work\", \"personal\"). Omit for default."
},
"mailbox": {
"type": "string",
"default": "INBOX",
"description": "Mailbox to check"
},
"imap_config": {
"type": "object",
"required": [
"host",
"email",
"password"
],
"properties": {
"host": {
"type": "string"
},
"port": {
"type": "number",
"default": 993
},
"email": {
"type": "string",
"format": "email"
},
"secure": {
"type": "boolean",
"default": true
},
"password": {
"type": "string"
}
}
}
}
}Get the current status of the SMTP forward receiver
No arguments.
{
"type": "object",
"properties": {}
}View all addresses on the bounce suppression list — these addresses will be rejected on send
No arguments.
{
"type": "object",
"properties": {}
}Get all conversation threads involving a specific sender
| Argument | Type | Description |
|---|---|---|
| senderAddress* | string | Email address of the sender |
{
"type": "object",
"required": [
"senderAddress"
],
"properties": {
"senderAddress": {
"type": "string",
"description": "Email address of the sender"
}
}
}List supported cloud providers with pricing, regions, and PTR support info
No arguments.
{
"type": "object",
"properties": {}
}List all configured IMAP email accounts. Shows default and named accounts (work, personal, etc.).
No arguments.
{
"type": "object",
"properties": {}
}List all email accounts with SMTP credentials (optionally filtered by domain)
| Argument | Type | Description |
|---|---|---|
| domain | string | Filter by domain |
{
"type": "object",
"properties": {
"domain": {
"type": "string",
"optional": true,
"description": "Filter by domain"
}
}
}List all email rules with their match conditions, actions, and hit counts
No arguments.
{
"type": "object",
"properties": {}
}List all local mailboxes on this server (autonomous mode)
No arguments.
{
"type": "object",
"properties": {}
}List all available mailboxes for an email account. If IMAP is configured in .env, no credentials needed. Use "account" to pick a named account.
| Argument | Type | Description |
|---|---|---|
| account | string | Named account (e.g. "work", "personal"). Omit for default. |
| imap_config | object |
{
"type": "object",
"properties": {
"account": {
"type": "string",
"optional": true,
"description": "Named account (e.g. \"work\", \"personal\"). Omit for default."
},
"imap_config": {
"type": "object",
"required": [
"host",
"email",
"password"
],
"properties": {
"host": {
"type": "string"
},
"port": {
"type": "number",
"default": 993
},
"email": {
"type": "string",
"format": "email"
},
"secure": {
"type": "boolean",
"default": true
},
"password": {
"type": "string"
}
}
}
}
}List all configured sending domains with their verification status
No arguments.
{
"type": "object",
"properties": {}
}Resume provisioning from where you left off. Automatically detects the current phase and advances: WireGuard connection → DNS setup → TLS → verification. Run this after each user action (connecting WireGuard, adding DNS records).
No arguments.
{
"type": "object",
"properties": {}
}Phase 1: Create a cloud VPS with dedicated IP. Generates WireGuard config. Returns the IP and instructions to connect. Supports DigitalOcean, Vultr, Hetzner, OVH.
| Argument | Type | Description |
|---|---|---|
| region | string | Cloud region (e.g. nyc1, ewr, nbg1, GRA11). Omit for default. |
| cloud_api_key* | string | Cloud provider API key |
| cloud_provider* | string | Cloud provider |
| service_domain* | string | Domain you own for the email service (e.g. emailrelay.xyz). NS will point here. |
{
"type": "object",
"required": [
"cloud_provider",
"cloud_api_key",
"service_domain"
],
"properties": {
"region": {
"type": "string",
"optional": true,
"description": "Cloud region (e.g. nyc1, ewr, nbg1, GRA11). Omit for default."
},
"cloud_api_key": {
"type": "string",
"description": "Cloud provider API key"
},
"cloud_provider": {
"enum": [
"digitalocean",
"vultr",
"hetzner",
"ovh"
],
"type": "string",
"description": "Cloud provider"
},
"service_domain": {
"type": "string",
"description": "Domain you own for the email service (e.g. emailrelay.xyz). NS will point here."
}
}
}Show current provisioning state — which phases are complete, what to do next
No arguments.
{
"type": "object",
"properties": {}
}Read emails from an inbox via IMAP with filtering options. If IMAP is configured in .env, no credentials needed. Use "account" to pick a named account (work, personal, etc.).
| Argument | Type | Description |
|---|---|---|
| filter | object | |
| account | string | Named account to read from (e.g. "work", "personal"). Omit for default account. |
| options | object | |
| imap_config | object | Optional if IMAP is configured in .env (IMAP_HOST, IMAP_EMAIL, IMAP_PASSWORD) |
{
"type": "object",
"properties": {
"filter": {
"type": "object",
"properties": {
"to": {
"type": "string",
"description": "Filter by recipient email address"
},
"from": {
"type": "string",
"description": "Filter by sender email address"
},
"limit": {
"type": "number",
"default": 10,
"maximum": 100,
"minimum": 1,
"description": "Maximum number of emails to read"
},
"since": {
"type": "string",
"format": "date",
"description": "Only emails after this date (YYYY-MM-DD)"
},
"before": {
"type": "string",
"format": "date",
"description": "Only emails before this date (YYYY-MM-DD)"
},
"flagged": {
"type": "boolean",
"description": "Only return flagged emails"
},
"mailbox": {
"type": "string",
"default": "INBOX",
"description": "Mailbox to read from"
},
"unread_only": {
"type": "boolean",
"default": false,
"description": "Only return unread emails"
},
"body_contains": {
"type": "string",
"description": "Filter by text in email body"
},
"subject_contains": {
"type": "string",
"description": "Filter by text in subject line"
}
}
},
"account": {
"type": "string",
"optional": true,
"description": "Named account to read from (e.g. \"work\", \"personal\"). Omit for default account."
},
"options": {
"type": "object",
"properties": {
"include_body": {
"type": "boolean",
"default": true,
"description": "Include email body content"
},
"mark_as_read": {
"type": "boolean",
"default": false,
"description": "Mark emails as read after fetching"
},
"include_attachments": {
"type": "boolean",
"default": false,
"description": "Include attachment information"
}
}
},
"imap_config": {
"type": "object",
"properties": {
"host": {
"type": "string",
"description": "IMAP server hostname (e.g., imap.gmail.com)"
},
"port": {
"type": "number",
"default": 993,
"description": "IMAP server port (default: 993 for SSL)"
},
"email": {
"type": "string",
"description": "Email address for authentication"
},
"secure": {
"type": "boolean",
"default": true,
"description": "Use SSL/TLS connection"
},
"password": {
"type": "string",
"description": "Password or app-specific password"
}
},
"description": "Optional if IMAP is configured in .env (IMAP_HOST, IMAP_EMAIL, IMAP_PASSWORD)"
}
}
}Regenerate the complete DNS zone file for the service domain including all customer subdomains. Use after adding/removing domains.
No arguments.
{
"type": "object",
"properties": {}
}Remove an address from the bounce suppression list (manual override to allow sending again)
| Argument | Type | Description |
|---|---|---|
| address* | string | Email address to unblock |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "Email address to unblock"
}
}
}Remove a sending domain and its DKIM keys
| Argument | Type | Description |
|---|---|---|
| domain* | string | Customer domain to remove |
{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "Customer domain to remove"
}
}
}Request a dedicated WireGuard IP for email sending. Submits to the provisioning queue.
| Argument | Type | Description |
|---|---|---|
| account_id | string | Optional account identifier |
| email_domain* | string | Your email domain (e.g. company.com) |
{
"type": "object",
"required": [
"email_domain"
],
"properties": {
"account_id": {
"type": "string",
"optional": true,
"description": "Optional account identifier"
},
"email_domain": {
"type": "string",
"description": "Your email domain (e.g. company.com)"
}
}
}Reset the SMTP password for an email account. Returns new password once.
| Argument | Type | Description |
|---|---|---|
| address* | string | Email address of the account |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "Email address of the account"
}
}
}Send an email with text or HTML content
| Argument | Type | Description |
|---|---|---|
| cc | array | Array of CC recipient email addresses |
| to* | array | Array of recipient email addresses |
| bcc | array | Array of BCC recipient email addresses |
| from | string | Personal account address to send from. If set and matching account has personal SMTP/IMAP credentials (via set_personal_email_credentials), sends via that account and IMAP-APPENDs a copy to its Sent folder. If exactly one personal account exists and from is omitted, it is used. If multiple personal accounts exist and from is omitted, the call errors and lists choices. |
| html | string | HTML content of the email |
| text* | string | Plain text content of the email |
| subject* | string | Email subject line |
| provider | string | Send via a specific provider instead of the default (e.g. smtp, mailgun, sendgrid, ses, gmail, resend). Requires that provider's credentials in env. |
| bulk_mode |
Send an email using a predefined template
| Argument | Type | Description |
|---|---|---|
| to* | array | Array of recipient email addresses |
| subject | string | Email subject (can override template subject) |
| provider | string | Send via a specific provider instead of the default (e.g. smtp, mailgun, sendgrid, ses, gmail, resend) |
| template* | string | Template name or path |
| bulk_mode | string | Required when sending to multiple recipients. "individual": sends a separate email to each recipient (safest). "bcc": puts first recipient in TO:, rest in BCC. "to": puts all in TO: (exposes addresses — use only when intended). |
| variables | object | Template variables to replace |
{
"type": "object",
"required": [
"to",
"template"
],
"properties": {
"to": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of recipient email addresses"
},
"subject": {
"type": "string",
"optional": true,
"description": "Email subject (can override template subject)"
},
"provider": {
"type": "string",
"optional": true,
"description": "Send via a specific provider instead of the default (e.g. smtp, mailgun, sendgrid, ses, gmail, resend)"
},
"template": {
"type": "string",
"description": "Template name or path"
},
"bulk_mode": {
"enum": [
"individual",
"bcc",
"to"
],
"type": "string",
"optional": true,
"description": "Required when sending to multiple recipients. \"individual\": sends a separate email to each recipient (safest). \"bcc\": puts first recipient in TO:, rest in BCC. \"to\": puts all in TO: (exposes addresses — use only when intended)."
},
"variables": {
"type": "object",
"description": "Template variables to replace",
"additionalProperties": true
}
}
}Attach a personal account's own SMTP + IMAP credentials (iCloud, Gmail app password, Fastmail, Office365, etc.) to an existing account. Once set, send_email with from=<address> sends via that SMTP and IMAP-APPENDs a copy to its Sent folder. Passwords are AES-256-GCM encrypted at rest with EMAILMCP_SECRET.
| Argument | Type | Description |
|---|---|---|
| address* | string | Address of the existing account (must already be created via create_email_account) |
| imap_host* | string | e.g. imap.mail.me.com, imap.gmail.com, imap.fastmail.com |
| imap_port | number | Default 993 |
| imap_user* | string | IMAP username — usually the full email address |
| smtp_host* | string | e.g. smtp.mail.me.com (iCloud), smtp.gmail.com, smtp.fastmail.com |
| smtp_port | number | Default 587 |
| smtp_user* | string | SMTP username — usually the full email address |
| sent_folder | string | Override Sent folder name. Auto-discovered via SPECIAL-USE if omitted. |
Auto-configure DKIM, SPF, and DMARC for autonomous email. Generates DKIM keys, creates DNS records, and outputs everything needed.
| Argument | Type | Description |
|---|---|---|
| ipv4* | string | Your dedicated IPv4 address |
| domain* | string | Your email domain |
| dmarc_policy | string | DMARC policy (default: reject) |
| dkim_selector | string | DKIM selector (default: emailmcp) |
{
"type": "object",
"required": [
"domain",
"ipv4"
],
"properties": {
"ipv4": {
"type": "string",
"description": "Your dedicated IPv4 address"
},
"domain": {
"type": "string",
"description": "Your email domain"
},
"dmarc_policy": {
"enum": [
"none",
"quarantine",
"reject"
],
"type": "string",
"optional": true,
"description": "DMARC policy (default: reject)"
},
"dkim_selector": {
"type": "string",
"optional": true,
"description": "DKIM selector (default: emailmcp)"
}
}
}Begin a domain-verification window: temporarily set the target domain's MX to verify.setip.io, start (or reuse) the EmailMCP SMTP receiver on :25, and forward any inbound mail for *@domain to forward_to so a human can grab a verification code from the provider (Apple/Google/etc). Auto-tears down after ttl_minutes.
| Argument | Type | Description |
|---|---|---|
| domain* | string | Domain whose MX is being temporarily redirected (must be a POC we own in setipio-api) |
| forward_to* | string | Address where verification mails are relayed in real time |
| ttl_minutes | number | Auto-teardown after this many minutes (default 60) |
| real_mx_target | string | Optional. If provided, on teardown the MX is set to this target (e.g. apple.com) instead of restoring the pre-window snapshot. |
{
"type": "object",
"required": [
"domain",
"forward_to"
],
"properties": {
"domain": {
"type": "string",
"description": "Domain whose MX is being temporarily redirected (must be a POC we own in setipio-api)"
},
"forward_to": {
"type": "string",
"description": "Address where verification mails are relayed in real time"
},
"ttl_minutes": {
"type": "number",
"description": "Auto-teardown after this many minutes (default 60)"
},
"real_mx_target": {
"type": "string",
"description": "Optional. If provided, on teardown the MX is set to this target (e.g. apple.com) instead of restoring the pre-window snapshot."
}
}
}Start monitoring the provisioned email server — checks tunnel, SMTP, DNS, and IP reputation every 60 seconds. Auto-restarts on failure.
No arguments.
{
"type": "object",
"properties": {}
}Start real-time IMAP IDLE watching on email accounts. Get push notifications when new emails arrive. Works with Gmail, iCloud, Office365, etc.
| Argument | Type | Description |
|---|---|---|
| account | string | Account name to watch (e.g. "work", "personal"). Omit to watch all configured accounts. |
{
"type": "object",
"properties": {
"account": {
"type": "string",
"optional": true,
"description": "Account name to watch (e.g. \"work\", \"personal\"). Omit to watch all configured accounts."
}
}
}Start the SMTP server to receive forwarded corporate emails
| Argument | Type | Description |
|---|---|---|
| port | number | Port to listen on (default: 2525) |
| enableThreading | boolean | Enable conversation threading |
| receivingDomains | array | Domains to accept emails for (empty = accept all) |
| allowedForwarders | array | IP addresses allowed to forward emails (empty = allow all) |
{
"type": "object",
"properties": {
"port": {
"type": "number",
"default": 2525,
"description": "Port to listen on (default: 2525)"
},
"enableThreading": {
"type": "boolean",
"default": true,
"description": "Enable conversation threading"
},
"receivingDomains": {
"type": "array",
"items": {
"type": "string"
},
"default": [],
"description": "Domains to accept emails for (empty = accept all)"
},
"allowedForwarders": {
"type": "array",
"items": {
"type": "string"
},
"default": [],
"description": "IP addresses allowed to forward emails (empty = allow all)"
}
}
}Tear down an active domain-verification window: restore MX (snapshot or supplied real_mx_target), remove the per-domain forwarder. Stops the receiver if no other windows remain.
| Argument | Type | Description |
|---|---|---|
| domain* | string | Domain to tear down |
| real_mx_target | string | Optional final MX target (e.g. apple.com). Overrides the snapshot restore. |
{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "Domain to tear down"
},
"real_mx_target": {
"type": "string",
"description": "Optional final MX target (e.g. apple.com). Overrides the snapshot restore."
}
}
}Stop IMAP IDLE watching on an account (or all accounts)
| Argument | Type | Description |
|---|---|---|
| account | string | Account to stop watching. Omit to stop all. |
{
"type": "object",
"properties": {
"account": {
"type": "string",
"optional": true,
"description": "Account to stop watching. Omit to stop all."
}
}
}Stop the SMTP forward receiver server
No arguments.
{
"type": "object",
"properties": {}
}Test email configuration by sending a test email
| Argument | Type | Description |
|---|---|---|
| test_email | string | Email address to send test email to (optional, defaults to from_email) |
{
"type": "object",
"properties": {
"test_email": {
"type": "string",
"description": "Email address to send test email to (optional, defaults to from_email)"
}
}
}Update an existing email rule (enable/disable, change match/actions/priority)
| Argument | Type | Description |
|---|---|---|
| stop | boolean | Stop after match |
| match | object | New match conditions |
| actions | array | New actions |
| enabled | boolean | Enable or disable the rule |
| rule_id* | string | Rule ID to update |
| priority | number | New priority |
{
"type": "object",
"required": [
"rule_id"
],
"properties": {
"stop": {
"type": "boolean",
"optional": true,
"description": "Stop after match"
},
"match": {
"type": "object",
"optional": true,
"description": "New match conditions"
},
"actions": {
"type": "array",
"optional": true,
"description": "New actions"
},
"enabled": {
"type": "boolean",
"optional": true,
"description": "Enable or disable the rule"
},
"rule_id": {
"type": "string",
"description": "Rule ID to update"
},
"priority": {
"type": "number",
"optional": true,
"description": "New priority"
}
}
}Validate email addresses and check deliverability
| Argument | Type | Description |
|---|---|---|
| emails* | array | Array of email addresses to validate |
| check_mx | boolean | Check MX records for domain |
| check_smtp | boolean | Perform SMTP validation |
{
"type": "object",
"required": [
"emails"
],
"properties": {
"emails": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of email addresses to validate"
},
"check_mx": {
"type": "boolean",
"default": true,
"description": "Check MX records for domain"
},
"check_smtp": {
"type": "boolean",
"default": false,
"description": "Perform SMTP validation"
}
}
}Verify that autonomous email is properly configured: DNS records, DKIM, SMTP send/receive
| Argument | Type | Description |
|---|---|---|
| domain* | string | Your email domain to verify |
{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "Your email domain to verify"
}
}
}Verify IP whitelisting and email provider configuration
| Argument | Type | Description |
|---|---|---|
| domain | string | Domain to check for DNS records (required if include_dns is true) |
| provider* | string | Email provider to verify, or "all" for all configured providers |
| test_email | string | Optional test email address to verify delivery |
| include_dns | boolean | Include DNS record verification |
{
"type": "object",
"required": [
"provider"
],
"properties": {
"domain": {
"type": "string",
"description": "Domain to check for DNS records (required if include_dns is true)"
},
"provider": {
"enum": [
"sendgrid",
"mailgun",
"ses",
"resend",
"all"
],
"type": "string",
"description": "Email provider to verify, or \"all\" for all configured providers"
},
"test_email": {
"type": "string",
"format": "email",
"description": "Optional test email address to verify delivery"
},
"include_dns": {
"type": "boolean",
"default": false,
"description": "Include DNS record verification"
}
}
}| string |
| Required when sending to multiple recipients. "individual": sends a separate email to each recipient (safest). "bcc": puts first recipient in TO:, rest in BCC. "to": puts all in TO: (exposes addresses — use only when intended, e.g. team threads). |
| attachments | array | Array of file attachments |
{
"type": "object",
"required": [
"to",
"subject",
"text"
],
"properties": {
"cc": {
"type": "array",
"items": {
"type": "string"
},
"optional": true,
"description": "Array of CC recipient email addresses"
},
"to": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of recipient email addresses"
},
"bcc": {
"type": "array",
"items": {
"type": "string"
},
"optional": true,
"description": "Array of BCC recipient email addresses"
},
"from": {
"type": "string",
"optional": true,
"description": "Personal account address to send from. If set and matching account has personal SMTP/IMAP credentials (via set_personal_email_credentials), sends via that account and IMAP-APPENDs a copy to its Sent folder. If exactly one personal account exists and from is omitted, it is used. If multiple personal accounts exist and from is omitted, the call errors and lists choices."
},
"html": {
"type": "string",
"optional": true,
"description": "HTML content of the email"
},
"text": {
"type": "string",
"description": "Plain text content of the email"
},
"subject": {
"type": "string",
"description": "Email subject line"
},
"provider": {
"type": "string",
"optional": true,
"description": "Send via a specific provider instead of the default (e.g. smtp, mailgun, sendgrid, ses, gmail, resend). Requires that provider's credentials in env."
},
"bulk_mode": {
"enum": [
"individual",
"bcc",
"to"
],
"type": "string",
"optional": true,
"description": "Required when sending to multiple recipients. \"individual\": sends a separate email to each recipient (safest). \"bcc\": puts first recipient in TO:, rest in BCC. \"to\": puts all in TO: (exposes addresses — use only when intended, e.g. team threads)."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"content": {
"type": "string"
},
"encoding": {
"type": "string",
"default": "base64"
},
"filename": {
"type": "string"
}
}
},
"optional": true,
"description": "Array of file attachments"
}
}
}| imap_password* | string | IMAP password (often same as SMTP) |
| smtp_password* | string | SMTP password or app-specific password |
{
"type": "object",
"required": [
"address",
"smtp_host",
"smtp_user",
"smtp_password",
"imap_host",
"imap_user",
"imap_password"
],
"properties": {
"address": {
"type": "string",
"description": "Address of the existing account (must already be created via create_email_account)"
},
"imap_host": {
"type": "string",
"description": "e.g. imap.mail.me.com, imap.gmail.com, imap.fastmail.com"
},
"imap_port": {
"type": "number",
"description": "Default 993"
},
"imap_user": {
"type": "string",
"description": "IMAP username — usually the full email address"
},
"smtp_host": {
"type": "string",
"description": "e.g. smtp.mail.me.com (iCloud), smtp.gmail.com, smtp.fastmail.com"
},
"smtp_port": {
"type": "number",
"description": "Default 587"
},
"smtp_user": {
"type": "string",
"description": "SMTP username — usually the full email address"
},
"sent_folder": {
"type": "string",
"optional": true,
"description": "Override Sent folder name. Auto-discovered via SPECIAL-USE if omitted."
},
"imap_password": {
"type": "string",
"description": "IMAP password (often same as SMTP)"
},
"smtp_password": {
"type": "string",
"description": "SMTP password or app-specific password"
}
}
}