@resonia/veilmail-mcp

A Model Context Protocol (MCP) server that exposes Veil Mail API operations as tools for AI agents. This allows AI assistants like Claude, ChatGPT, Cursor, and other MCP-compatible clients to send emails, manage templates, work with audiences, and retrieve analytics through natural language.

Veil Mail is the only email API with a first-class MCP server. Resend, SendGrid, Mailgun, and Postmark don't offer MCP integrations — connecting them to Claude or Cursor requires hand-building a server. This one ships as npx @resonia/veilmail-mcp and drops straight into Claude Desktop or any MCP client with a single config entry. Ten tools covering emails, domains, templates, audiences, campaigns, and analytics.

Related: Veil Mail Node.js SDK · Full MCP docs · AI assistant integration guides

Installation

npm install @resonia/veilmail-mcp

Or run directly with npx:

npx @resonia/veilmail-mcp

Related MCP server: Email MCP

Configuration

The server requires a Veil Mail API key to authenticate requests. Set it via the VEILMAIL_API_KEY environment variable.

You can obtain an API key from the Veil Mail Dashboard.

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "veilmail": {
      "command": "npx",
      "args": ["@resonia/veilmail-mcp"],
      "env": {
        "VEILMAIL_API_KEY": "veil_live_xxxxx"
      }
    }
  }
}

Restart Claude Desktop after updating the configuration. You should see the Veil Mail tools available in the tools menu.

Usage with Other MCP Clients

Any MCP-compatible client can use this server. Start it as a subprocess communicating over stdio:

VEILMAIL_API_KEY=veil_live_xxxxx npx @resonia/veilmail-mcp

Available Tools

send_email

Send an email via Veil Mail. Supports HTML content, templates, attachments, and scheduling.

get_email

Get details of a sent email by ID.

list_emails

List sent emails with optional filters.

validate_email

Validate an email address. Checks syntax, MX records, disposable domain, and role address.

list_templates

List available email templates.

get_template

Get a specific email template by ID.

list_domains

List verified sending domains. No parameters required.

list_audiences

List email audiences/contact lists. No parameters required.

add_subscriber

Add a subscriber to an audience.

get_analytics

Get email analytics overview including delivery rates, opens, clicks, and bounces.

Example Interactions

Once configured, you can ask your AI assistant things like:

• "Send a welcome email to user@example.com from hello@mydomain.com"

• "List all my email templates"

• "Show me email analytics for the past 7 days"

• "Validate the email address test@example.com"

• "Add john@example.com to my newsletter audience"

• "What's the delivery rate for my recent emails?"

Security Considerations

• Never expose API keys in prompts or conversation history. Always use environment variables.

• Use test mode keys (veil_test_xxxxx) during development to avoid sending real emails.

• Review email content before sending. The AI assistant will use the send_email tool, so verify recipient addresses and content are correct.

• Scope API keys appropriately. Create dedicated API keys for MCP usage with only the permissions needed.

• Rotate keys regularly. If you suspect an API key has been compromised, rotate it immediately in the Veil Mail dashboard.

Development

# Clone the repository
git clone https://github.com/resonia/veil-mail.git
cd veil-mail/packages/mcp-server

# Install dependencies
bun install

# Build
bun run build

# Run locally
VEILMAIL_API_KEY=veil_test_xxxxx node dist/index.js

# Type check
bun run typecheck

# Watch mode
bun run dev

License

MIT