@mepmail/mcp

@mepmail/mcp

Official MepMail MCP server for local MCP clients — Claude Desktop, Claude Code, Cursor, Codex and anything that speaks stdio. It drives your MepMail instance over the public REST API (Resend-compatible wire) with a team API key.

MepMail also runs a hosted MCP server (OAuth, no install) at https://api-mepmail.je4ndev.com/mcp. This package is for clients that launch local servers from config. Both expose the same tool names.

Quickstart

• Create an API key in the MepMail dashboard (API keys) — a sending-access key scoped to the domain your agent sends from.
• Add the server to your client:

Claude Desktop (claude_desktop_config.json) — and any client with the same config shape (Cursor: mcp.json):

{
  "mcpServers": {
    "mepmail": {
      "command": "npx",
      "args": ["-y", "@mepmail/mcp"],
      "env": {
        "MEPMAIL_API_KEY": "ms_...",
        "MEPMAIL_BASE_URL": "https://api-mepmail.je4ndev.com"
      }
    }
  }
}

Claude Code:

claude mcp add mepmail -e MEPMAIL_API_KEY=ms_... -e MEPMAIL_BASE_URL=https://api-mepmail.je4ndev.com -- npx -y @mepmail/mcp

Environment

Variable	Required	Default	Meaning
MEPMAIL_API_KEY	yes	—	Team API key (ms_...). Sent as Bearer to your instance only.
MEPMAIL_BASE_URL	no	https://api-mepmail.je4ndev.com	Your instance's API URL.

Tools (22)

Send and manage email:

• send_email — send or schedule one transactional email (cc/bcc/reply_to, tags, attachments, topic-scoped sends).
• send_email_batch — up to 100 emails in one call.
• get_email, list_emails — status and timeline (last_event: delivered, bounced, complained, ...).
• update_email, cancel_email — reschedule or cancel a scheduled email.
• get_email_insights — per-email best-practice report and score.
• get_deliverability, get_usage — account standing before bulk work.

Audience and account:

• create_contact, update_contact, delete_contact (with erase=true for GDPR/LGPD scrubbing), get_contact, list_contacts — with segment filters.
• list_domains, get_domain — DNS records and verification state.
• list_broadcasts, get_broadcast.
• list_templates, get_template.
• list_webhooks, list_suppressions.

Every tool result is one JSON block envelope — { notice, untrusted_data } — so agents can tell team-authored strings from tool output and never treat recipient data as instructions.

Agent discovery

• Machine catalog: https://mepmail.je4ndev.com/.well-known/ai-catalog.json
• Auth guide for agents: https://mepmail.je4ndev.com/auth.md
• API + errors + rate limits: https://docs-mepmail.je4ndev.com

License

MIT