@mepmail/mcp

@mepmail/mcp

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

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

Quickstart

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

Claude Desktop (claude_desktop_config.json) — and any client with thesame 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

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 forGDPR/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 treatrecipient 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