@deliveriq/mcp

@deliveriq/mcp

MiN8T DeliverIQ 邮件验证 API 的官方 MCP（Model Context Protocol）服务。 为 Claude Desktop、Claude Code、Cursor 及任何其他兼容 MCP 的客户端提供 12 个工具。

安装

无需单独安装——npx -y @deliveriq/mcp 会按需获取并运行服务。

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "deliveriq": {
      "command": "npx",
      "args": ["-y", "@deliveriq/mcp"],
      "env": {
        "DELIVERIQ_API_KEY": "lc_your_api_key"
      }
    }
  }
}

重启 Claude Desktop。你应该会看到 12 个可用的 DeliverIQ 工具。

Claude Code

claude mcp add deliveriq npx -y @deliveriq/mcp \
  -e DELIVERIQ_API_KEY=lc_your_api_key

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "deliveriq": {
      "command": "npx",
      "args": ["-y", "@deliveriq/mcp"],
      "env": {
        "DELIVERIQ_API_KEY": "lc_your_api_key"
      }
    }
  }
}

获取 API 密钥

在 min8t.com/deliveriq 注册，并从控制面板获取密钥。免费套餐涵盖演示流程以及持续的低频使用。密钥格式为 lc_prefix_secret。

环境变量

变量	必需	描述
DELIVERIQ_API_KEY	是	API 密钥（格式：lc_prefix_secret）
DELIVERIQ_BASE_URL	否	覆盖 API URL（默认值：https://api.min8t.com/deliverability/v1）

工具（12 个）

验证

工具	描述	积分
deliveriq_verify_email	验证单个邮箱的可投递性	1
deliveriq_batch_verify	提交一批邮箱进行异步验证	1/邮箱
deliveriq_batch_status	查看批处理任务状态和进度	免费
deliveriq_batch_download	将已完成的批处理结果下载为 CSV	免费
deliveriq_list_jobs	分页列出验证任务	免费

情报分析

工具	描述	积分
deliveriq_find_email	通过姓名 + 域名查找商务邮箱	2
deliveriq_blacklist_check	检查域名是否被列入 50 个 DNSBL 区域	1
deliveriq_infrastructure_check	分析 SPF/DKIM/DMARC/MTA-STS/BIMI	1
deliveriq_spam_trap_analysis	评估垃圾邮件陷阱风险（13 项信号）	1
deliveriq_domain_intel	全面的域名可信度报告	1
deliveriq_org_intel	查询组织的邮箱模式	免费

账户

工具	描述	积分
deliveriq_check_credits	查看积分余额和使用统计	免费

为什么选择 MCP？

邮件可投递性问题往往需要调用 6–8 次 API 才能得出正确答案（验证 → 信誉 → DMARC → 阻止列表 → 基础设施 → ……）。 让 Claude 将这些步骤编排为工具，比再推出一个仪表板有用约 10 倍——模型可以规划流程、根据结果分支处理，并用通俗易懂的语言解释结论。

开发

# 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

要求

• Node.js 18+
• DeliverIQ API 密钥

路线图

请参阅 ../ROADMAP.md 了解后续工作，或提交 issue 提议新增工具。

许可证

MIT — 请参阅 LICENSE。