mcp server

EmailMCP

AI agent email — 23 tools free to read inbox, 28 paid to send. $9.99/mo. Token auto-provisioned.

Description as published by the maintainer. Source

• version 1.0.1
• slowing

slowing — Registry entry last updated 2026-05-02.

What this server can do

56 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

add_sending_domain(domain)

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. Required: domain.

check_email_config

Check if email providers are configured, guide setup if needed

check_ip_status(request_id)

Check the status of a pending WireGuard IP provisioning request

configure_mailgun(domain, api_key, from_email)

Configure Mailgun email provider with step-by-step guidance Required: api_key, domain, from_email.

create_email_account(domain, address, display_name)

Create an email account with SMTP credentials. Returns SMTP password once — save it. The account can then send/receive via this server. Required: address.

create_email_rule(name, stop, match, actions, priority, description)

Create a rule that triggers actions when incoming emails match conditions. Actions: forward, auto_reply, webhook, flag, move, mcp_tool, log, reject. Required: name, match, actions.

create_mailbox(address, display_name)

Create a new local mailbox for receiving email (autonomous mode). Each address gets its own inbox accessible via MCP tools. Required: address.

delete_email_account(address)

Delete an email account and revoke its SMTP credentials Required: address.

delete_email_rule(rule_id)

Delete an email rule by ID Required: rule_id.

delete_mailbox(address)

Delete a local mailbox and all its stored emails (autonomous mode) Required: address.

get_conversation_context(threadId, maxEmails)

Get full conversation context for a specific thread Required: threadId.

get_conversation_threads(limit, since, subject, participant)

Get conversation threads with forwarded emails

get_dns_records(ipv4, domain, dmarc_policy, dkim_selector, mail_hostname)

Generate all required DNS records (A, MX, SPF, DKIM, DMARC) for autonomous email. Outputs copyable records for your DNS provider. Required: domain, ipv4.

get_domain_dns_records(domain)

Get the DNS records a customer needs to add for a sending domain Required: domain.

get_domain_verification_emails(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). Required: domain.

get_domain_verification_status

Show active verification windows, the receiver state, and TTLs.

get_email_usage(domain, period, account)

Get email usage statistics — delivery rate, bounce rate, per-domain breakdown, top bounce reasons. Reads from persistent stats.

get_forwarded_emails(limit, since, threadId, originalSender)

Retrieve forwarded emails with optional filtering

get_health_status

Get current health status of the email server — tunnel, SMTP, DNS, IP blocklist checks

get_idle_status

Get status of IMAP IDLE watchers — which accounts are being watched, connection status, new email counts

get_mailbox_status(account, mailbox, imap_config)

Get status information for an email mailbox. If IMAP is configured in .env, no credentials needed. Use "account" to pick a named account.

get_smtp_receiver_status

Get the current status of the SMTP forward receiver

get_suppression_list

View all addresses on the bounce suppression list — these addresses will be rejected on send

get_threads_for_sender(senderAddress)

Get all conversation threads involving a specific sender Required: senderAddress.

list_cloud_providers

List supported cloud providers with pricing, regions, and PTR support info

list_email_accounts

List all configured IMAP email accounts. Shows default and named accounts (work, personal, etc.).

list_email_accounts_managed(domain)

List all email accounts with SMTP credentials (optionally filtered by domain)

list_email_rules

List all email rules with their match conditions, actions, and hit counts

list_local_mailboxes

List all local mailboxes on this server (autonomous mode)

list_mailboxes(account, imap_config)

List all available mailboxes for an email account. If IMAP is configured in .env, no credentials needed. Use "account" to pick a named account.

list_sending_domains

List all configured sending domains with their verification status

provision_resume

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).

provision_start(region, cloud_api_key, cloud_provider, service_domain)

Phase 1: Create a cloud VPS with dedicated IP. Generates WireGuard config. Returns the IP and instructions to connect. Supports DigitalOcean, Vultr, Hetzner, OVH. Required: cloud_provider, cloud_api_key, service_domain.

provision_status

Show current provisioning state — which phases are complete, what to do next

read_inbox(filter, account, options, imap_config)

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.).

regenerate_zone_file

Regenerate the complete DNS zone file for the service domain including all customer subdomains. Use after adding/removing domains.

remove_from_suppression(address)

Remove an address from the bounce suppression list (manual override to allow sending again) Required: address.

remove_sending_domain(domain)

Remove a sending domain and its DKIM keys Required: domain.

request_email_ip(account_id, email_domain)

Request a dedicated WireGuard IP for email sending. Submits to the provisioning queue. Required: email_domain.

reset_account_password(address)

Reset the SMTP password for an email account. Returns new password once. Required: address.

send_email(cc, to, bcc, from, html, text, subject, provider, bulk_mode, attachments)

Send an email with text or HTML content Required: to, subject, text.

send_template_email(to, subject, provider, template, bulk_mode, variables)

Send an email using a predefined template Required: to, template.

set_personal_email_credentials(address, imap_host, imap_port, imap_user, smtp_host, smtp_port, smtp_user, sent_folder, imap_password, smtp_password)

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. Required: address, smtp_host, smtp_user, smtp_password, imap_host, imap_user, imap_password.

setup_autonomous_security(ipv4, domain, dmarc_policy, dkim_selector)

Auto-configure DKIM, SPF, and DMARC for autonomous email. Generates DKIM keys, creates DNS records, and outputs everything needed. Required: domain, ipv4.

start_domain_verification(domain, forward_to, ttl_minutes, real_mx_target)

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. Required: domain, forward_to.

start_health_monitor

Start monitoring the provisioned email server — checks tunnel, SMTP, DNS, and IP reputation every 60 seconds. Auto-restarts on failure.

start_idle_watch(account)

Start real-time IMAP IDLE watching on email accounts. Get push notifications when new emails arrive. Works with Gmail, iCloud, Office365, etc.

start_smtp_receiver(port, enableThreading, receivingDomains, allowedForwarders)

Start the SMTP server to receive forwarded corporate emails

stop_domain_verification(domain, real_mx_target)

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. Required: domain.

stop_idle_watch(account)

Stop IMAP IDLE watching on an account (or all accounts)

stop_smtp_receiver

Stop the SMTP forward receiver server

test_email_config(test_email)

Test email configuration by sending a test email

update_email_rule(stop, match, actions, enabled, rule_id, priority)

Update an existing email rule (enable/disable, change match/actions/priority) Required: rule_id.

validate_email(emails, check_mx, check_smtp)

Validate email addresses and check deliverability Required: emails.

verify_autonomous_setup(domain)

Verify that autonomous email is properly configured: DNS records, DKIM, SMTP send/receive Required: domain.

verify_email_setup(domain, provider, test_email, include_dns)

Verify IP whitelisting and email provider configuration Required: provider.

Last successful function declaration observed on 2026-08-13. Source: https://mcp.setip.io/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://mcp.setip.io/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/nfodor/emailmcp
• Remote endpoint (streamable-http) — https://mcp.setip.io/mcp