SpiderMail
High-deliverability email infrastructure built natively for LLM agents.
What Is SpiderMail?
SpiderMail is not just another SMTP relay. It handles sender selection, warmup compliance, rendering, sending, and feeds replies back directly into the agent's context window.
Key Features
- 50 sender accounts — Auto-warmed and rotated to maintain deliverability.
- DKIM, SPF, DMARC — Automatic DNS configuration guidance per domain.
- Reply detection — Replies parsed and forwarded to your agent via webhooks.
- Campaign engine — Schedule, A/B test, and track multi-step sequences.
- Liquid templates — Agents populate templates safely without breaking HTML.
- MCP integration — 18 agent-callable tools via
@spideriq/mcp-mail.
Domain Setup
Configure your sending domain for maximum inbox placement.
Step 1 — Add Domain
Navigate to the SpiderMail dashboard → Domains → Add Domain. Enter your sending domain (e.g. outreach.youragency.com).
Step 2 — Configure DNS
| Type | Name | Value | Purpose |
|---|---|---|---|
| TXT | @ | v=spf1 include:spf.spidermail.ai ~all | SPF |
| CNAME | sm._domainkey | dkim.spidermail.ai | DKIM |
| TXT | _dmarc | v=DMARC1; p=none; rua=... | DMARC |
mail.youragency.com for outreach to protect your primary domain's reputation.Sending Email
Send your first email via API or MCP tools.
Via MCP (Recommended)
→ mcp:spidermail.send_email({
from: "Agent <hello@outreach.youragency.com>",
to: "lead@example.com",
subject: "Quick question about your practice",
html: "<p>Hi {{first_name}}, I noticed...</p>"
})Via Node.js SDK
import { SpiderMail } from '@spideriq/mail';
const mail = new SpiderMail(process.env.SPIDERMAIL_KEY);
await mail.send({
from: 'Agent <hello@youragency.com>',
to: 'lead@example.com',
subject: 'Automated Outreach',
html: '<p>Generated by your AI agent.</p>'
});Warmup Engine
Automatic sender warmup to establish and maintain inbox reputation.
Warmup Phases
| Phase | Days | Volume | Activity |
|---|---|---|---|
| Ramp | 1–7 | 5–20/day | Send + receive replies from warmup network |
| Build | 8–14 | 20–50/day | Increase volume, monitor bounce rate |
| Stable | 15–21 | 50–100/day | Full sending capacity reached |
| Maintain | 22+ | Background | Ongoing warmup to keep reputation |
Campaigns
Multi-step email sequences with A/B testing and smart scheduling.
Creating a Campaign
→ mcp:spidermail.draft_campaign({
name: "Dental Austin Q1",
leads: [/* lead IDs from CRM */],
template_id: "tpl_dental_cold_v3",
schedule: "weekdays 9am-5pm CST",
max_per_day: 50
})Multi-Step Sequences
- Step 1: Initial outreach email
- Step 2 (3 days, no reply): Follow-up with different angle
- Step 3 (5 days, no reply): Final "breakup" email
If the recipient replies at any step, the sequence stops automatically.
Templates
Liquid-style templates that agents can safely populate.
Template Syntax
<p>Hi {{first_name}},</p>
<p>{{agent_generated_body}}</p>
<p>Best,<br>{{sender_name}}</p>{{{triple_braces}}} only for raw HTML injection.Webhooks
Real-time event notifications for email activity.
| Event | Trigger |
|---|---|
| email.sent | Email successfully delivered |
| email.opened | Recipient opened the email |
| email.clicked | Recipient clicked a tracked link |
| email.replied | Recipient replied — parsed body included |
| email.bounced | Hard or soft bounce detected |
| email.unsubscribed | Recipient clicked unsubscribe |
MCP Tools
18 agent-callable tools via @spideriq/mcp-mail.
| Tool | Description |
|---|---|
| send_email | Send a single email with auto sender selection |
| send_template | Send using a Liquid template with variables |
| draft_campaign | Create a campaign from leads + template |
| send_campaign | Schedule and execute a campaign |
| warmup_status | Check warmup progress for all senders |
| get_analytics | Open/click/reply/bounce stats |
Installation
// .mcp.json
{
"mcpServers": {
"spidermail": {
"command": "npx",
"args": ["@spideriq/mcp-mail@latest"],
"env": { "SPIDERIQ_TOKEN": "your-pat-token" }
}
}
}