MCP

MailAfrica MCP Server

Native email tools for AI agents — send, track, and manage email through Model Context Protocol instead of brittle API glue code.

Get your API key View MCP setup docs

Server name

mailafrica-mcp

Auth

API key scoped per domain, passed via MCP server config — not per tool call.

Rate limits

Enforced server-side. Tool results surface rate_limit_remaining where relevant.

Core tools

Seven tools, one spec

Everything an agent needs to send mail, work with templates, and understand delivery — without manual API wiring.

send_email

Send a transactional email from a verified domain address.

Params: to, from (verified domain address), subject, body (text/html), template_id (optional), variables (optional, for template interpolation)
Returns: message_id, status (queued/sent/failed)

send_templated_email

Trigger a predefined flow (OTP, welcome, invoice) without building HTML.

Params: template_id, to, variables (object for merge fields)
Returns: message_id, status

check_delivery_status

Confirm an email was delivered, opened, or bounced, and react accordingly.

Params: message_id
Returns: status (delivered/bounced/opened/failed), timestamp, bounce_reason (if applicable)

list_templates

Discover what templates exist before sending anything.

Params: none (or domain filter)
Returns: list of template_id, name, required_variables

create_template

Build a new transactional template on the fly.

Params: name, subject, body_html, variables (schema)
Returns: template_id

get_inbox_messages

Pull and process parsed inbound messages from hosted inboxes.

Params: mailbox, since (timestamp), limit
Returns: list of parsed inbound messages (from, subject, body, received_at)

get_domain_status

Check domain verification and deliverability health.

Params: domain
Returns: SPF/DKIM/DMARC verification status, deliverability health

Quick start

Wire it into any MCP client

Add the server to your MCP config and point an agent at real email infrastructure. Works with Claude Desktop, Claude Code, Cursor, and any MCP-compatible client.

For AI agents

{
  "mcpServers": {
    "mailafrica": {
      "command": "npx",
      "args": ["-y", "@mailafrica/mcp-server"],
      "env": { "MAILAFRICA_API_KEY": "your_key_here" }
    }
  }
}