Instantly MCP Server

用于Instantly.ai电子邮件活动管理的模型上下文协议（MCP）服务器。

快速开始

安装

npm install
npm run build

配置

export INSTANTLY_API_KEY="your-api-key-here"
npm start

服务器可用地址：http://localhost:3000/mcp

Claude桌面设置（本地）

{
  "mcpServers": {
    "instantly": {
      "command": "node",
      "args": ["/path/to/instantly-mcp/dist/index.js"],
      "env": {
        "INSTANTLY_API_KEY": "your-api-key-here"
      }
    }
  }
}

远程HTTP端点

生产端点

URL: https://mcp.instantly.ai/mcp

认证方法

1. 基于URL的认证

https://mcp.instantly.ai/mcp/YOUR_API_KEY

2. 头部认证

URL: https://mcp.instantly.ai/mcp
Header: Authorization: YOUR_API_KEY

注意：不需要Bearer令牌前缀

使用MCP客户端配置

配置您的MCP客户端以使用远程端点：

{
  "mcpServers": {
    "instantly": {
      "url": "https://mcp.instantly.ai/mcp",
      "headers": {
        "Authorization": "your-api-key-here"
      }
    }
  }
}

可用工具（总计36个）

活动管理（6个工具）

• create_campaign - 创建具有防弹时区验证的电子邮件活动
• list_campaigns - 列出活动并进行过滤
• get_campaign - 获取活动详情
• update_campaign - 更新活动设置
• activate_campaign - 启动活动
• pause_campaign - 暂停活动

分析（4个工具）

• get_campaign_analytics - 活动性能指标
• get_daily_campaign_analytics - 按日期过滤的每日分析
• get_warmup_analytics - 邮件预热分析
• test_account_vitals - 测试账户连接性

领导者管理（8个工具）

• create_lead - 将领导者添加到活动中
• list_leads - 列出领导者并进行过滤
• get_lead - 获取领导者详情
• update_lead - 更新领导者信息
• delete_lead - 删除领导者（⚠️破坏性操作）
• create_lead_list - 创建领导者列表
• list_lead_lists - 列出所有领导者列表
• update_lead_list - 更新领导者列表设置
• get_verification_stats_for_lead_list - 获取领导者列表的邮件验证统计信息
• add_leads_to_campaign_or_list_bulk - 批量添加领导者到活动或列表中
• move_leads_to_campaign_or_list - 在活动或列表之间移动领导者

邮件操作（5个工具）

• list_emails - 列出邮件并进行过滤
• get_email - 获取邮件详情
• reply_to_email - 回复邮件（⚠️发送真实邮件）
• verify_email - 验证邮件可送达性
• count_unread_emails - 统计未读邮件数量

账户管理（11个工具）

• list_accounts - 列出电子邮件账户
• create_account - 创建具有IMAP/SMTP的电子邮件账户
• update_account - 更新账户设置
• get_account_details - 获取详细账户信息
• get_account_info - 获取账户状态
• pause_account - 暂停账户
• resume_account - 恢复账户
• delete_account - 删除账户（⚠️破坏性操作）
• enable_warmup - 启用邮件预热
• disable_warmup - 禁用邮件预热
• test_account_vitals - 测试账户连接性

认证

环境变量

export INSTANTLY_API_KEY="your-key"

URL认证

https://server.com/mcp/your-key

头部认证

Authorization: Bearer your-key

特性

• 流式HTTP传输 - 远程MCP服务器位于https://mcp.instantly.ai/mcp
• 防弹时区系统 - 26个经过验证的工作时区，带有智能回退机制
• 生产就绪 - 包括速率限制、错误处理和分页功能
• Instantly.ai API v2 - 完全兼容最新API
• 双重认证 - 基于URL和头部的API密钥认证
• 双重传输 - 支持STDIO和HTTP流传输

许可证

MIT