MCP Server

The VeilMail MCP (Model Context Protocol) server enables AI agents like Claude, GPT, and other LLMs to send emails, manage templates, validate addresses, and more through natural language.

Send emails and manage templates via AI agents
Validate email addresses before sending
Manage audiences and subscribers
View analytics and delivery status
Works with Claude Desktop, Cursor, and any MCP-compatible client
Standalone — no SDK dependency, uses native fetch

Installation

npm install @resonia/veilmail-mcp

Claude Desktop Setup

Add VeilMail to your Claude Desktop configuration file:

claude_desktop_config.json

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

On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

On Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Code Setup

Add VeilMail to your Claude Code MCP settings:

claude mcp add veilmail npx @resonia/veilmail-mcp \
  --env VEILMAIL_API_KEY=veil_live_xxxxx

Cursor Setup

Add VeilMail to your Cursor MCP configuration:

.cursor/mcp.json

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

Available Tools

Tool	Description
`send_email`	Send an email with HTML, templates, or scheduling
`get_email`	Get details of a sent email by ID
`list_emails`	List sent emails with optional status filter
`validate_email`	Validate an email address (syntax, MX, disposable)
`list_templates`	List available email templates
`get_template`	Get a specific template by ID
`list_domains`	List verified sending domains
`list_audiences`	List email audiences/contact lists
`add_subscriber`	Add a subscriber to an audience
`get_analytics`	Get email analytics overview

Example Prompts

Once configured, you can ask your AI agent to perform email operations naturally:

“Send a welcome email to john@example.com from hello@myapp.com”

“Validate these email addresses: user1@gmail.com, test@mailinator.com”

“Show me the email analytics for the last 7 days”

“List my email templates and send the welcome template to new-user@example.com”

“Add jane@company.com to the newsletter audience”

Configuration

Environment Variable	Required	Description
`VEILMAIL_API_KEY`	Yes	Your VeilMail API key
`VEILMAIL_BASE_URL`	No	Custom API base URL (default: https://api.veilmail.xyz)

Security

API keys are passed via environment variables, never in prompts
Use test keys (veil_test_...) during development
Built-in PII scanning protects against accidental data exposure
Scoped API keys let you restrict what the MCP server can do

Install from Source

git clone https://github.com/Resonia-Health/veilmail-mcp.git
cd veilmail-mcp
npm install
npm run build
VEILMAIL_API_KEY=veil_live_xxxxx node dist/index.js