@deliveriq/mcp

Official MCP (Model Context Protocol) server for the DeliverIQ email verification API. Provides 12 tools for AI agents in Claude Desktop, Claude Code, Cursor, and other MCP-compatible clients.

Installation

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "deliveriq": {
      "command": "node",
      "args": ["/path/to/packages/deliveriq-mcp-server/dist/index.js"],
      "env": {
        "DELIVERIQ_API_KEY": "lc_your_api_key"
      }
    }
  }
}

Claude Code

claude mcp add deliveriq node /path/to/packages/deliveriq-mcp-server/dist/index.js \
  -e DELIVERIQ_API_KEY=lc_your_api_key

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "deliveriq": {
      "command": "node",
      "args": ["/path/to/packages/deliveriq-mcp-server/dist/index.js"],
      "env": {
        "DELIVERIQ_API_KEY": "lc_your_api_key"
      }
    }
  }
}

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.deliveriq.com/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 |

Development

# Build
npm run build

# Development with auto-reload
npm run dev

# Run directly
DELIVERIQ_API_KEY=lc_your_key node dist/index.js

Local API Testing

Point to 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

License

MIT