About @deliveriq/mcp
@deliveriq/mcp is an MCP server that gives AI agents access to DeliverIQ email verification and deliverability analysis. Its tools cover address checks, domain and organization intelligence, and email infrastructure diagnostics.
Key features
- 01Verify single and batch email addresses
- 02Check domains against 50 DNSBL zones
- 03Analyze SPF, DKIM, and DMARC
- 04Score spam-trap risk
- 05Find business emails and domain intelligence
- 06Check account credits and jobs
Use cases
- 01Validate contact lists before outreach
- 02Investigate a domain's email reputation
- 03Review authentication and mail infrastructure
- 04Find a business email using a name and domain
MCP support
The server exposes 12 DeliverIQ tools to MCP clients for email verification and deliverability analysis. It requires a DeliverIQ API key.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @deliveriq/mcpDELIVERIQ_API_KEYSecretYour DeliverIQ API key (format: lc_*). Get one free at https://min8t.com/deliveriqLocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
12Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| string | Yes | Email address to verify (e.g. "[email protected]") | |
| skip_smtp | boolean | No | Skip SMTP verification step (faster but less accurate) |
| check_gravatar | boolean | No | Check if email has a Gravatar profile |
| check_hibp | boolean | No | Check if email appears in Have I Been Pwned breach data |
| include_intelligence | boolean | No | Include deep intelligence (DNSBL, spam trap, domain age, infrastructure) |
Details
From the project README@deliveriq/mcp
Official MCP (Model Context Protocol) server for the DeliverIQ email verification API by MiN8T. Provides 12 tools for AI agents in Claude Desktop, Claude Code, Cursor, and any other MCP-compatible client.
Installation
No separate install step needed — npx -y @deliveriq/mcp will fetch and run
the server on demand.
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json
(macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"deliveriq": {
"command": "npx",
"args": ["-y", "@deliveriq/mcp"],
"env": {
"DELIVERIQ_API_KEY": "lc_your_api_key"
}
}
}
}
Restart Claude Desktop. You should see the 12 DeliverIQ tools available.
Claude Code
claude mcp add deliveriq npx -y @deliveriq/mcp \
-e DELIVERIQ_API_KEY=lc_your_api_key
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"deliveriq": {
"command": "npx",
"args": ["-y", "@deliveriq/mcp"],
"env": {
"DELIVERIQ_API_KEY": "lc_your_api_key"
}
}
}
}
Get an API key
Sign up at min8t.com/deliveriq and grab a
key from your dashboard. The free tier covers the demo flow plus ongoing
low-volume use. Keys are issued in the format lc_prefix_secret.
Environment Variables
| Variable | Required | Description |
|---|---|---|
DELIVERIQ_API_KEY | Yes | API key (format: lc_prefix_secret) |
DELIVERIQ_BASE_URL | No | Override API URL (default: https://api.min8t.com/deliverability/v1) |
Tools (12)
Verification
| Tool | Description | Credits |
|---|---|---|
deliveriq_verify_email | Verify a single email for deliverability | 1 |
deliveriq_batch_verify | Submit batch of emails for async verification | 1/email |
deliveriq_batch_status | Check batch job status and progress | Free |
deliveriq_batch_download | Download completed batch results as CSV | Free |
deliveriq_list_jobs | List verification jobs with pagination | Free |
Intelligence
| Tool | Description | Credits |
|---|---|---|
deliveriq_find_email | Find business email by name + domain | 2 |
deliveriq_blacklist_check | Check domain against 50 DNSBL zones | 1 |
deliveriq_infrastructure_check | Analyze SPF/DKIM/DMARC/MTA-STS/BIMI | 1 |
deliveriq_spam_trap_analysis | Evaluate spam trap risk (13 signals) | 1 |
deliveriq_domain_intel | Comprehensive domain trust report | 1 |
deliveriq_org_intel | Query organization email patterns | Free |
Account
| Tool | Description | Credits |
|---|---|---|
deliveriq_check_credits | Check credit balance and usage stats | Free |
Why MCP?
Email deliverability is one of those problems where the right answer needs 6–8 API calls (verify → reputation → DMARC → blocklist → infrastructure → ...). Letting Claude orchestrate these as tools is ~10× more useful than shipping another dashboard — the model can plan, branch on results, and explain the verdict in plain English.
Development
# Clone the monorepo
git clone https://github.com/Davison-Francis/min8t-sdks.git
cd min8t-sdks/deliveriq-mcp
# Install + build
npm install
npm run build
# Watch mode
npm run dev
# Run directly against the published API
DELIVERIQ_API_KEY=lc_your_key node dist/index.js
# Or against a local DeliverIQ service
DELIVERIQ_API_KEY=lc_test \
DELIVERIQ_BASE_URL=http://localhost:3019/api/v1 \
node dist/index.js
Requirements
- Node.js 18+
- DeliverIQ API key
Roadmap
See ../ROADMAP.md for upcoming work, or open an issue to
propose a tool.
License
MIT — see LICENSE.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.