Sendblue MCP

Sendblue MCP

用于AI代理的SMS/iMessage——安全、基于轮询、无需Webhook。

您的代理需要发送活动消息并检查回复。传统的webhook方法将您的本地计算机暴露在互联网上。Sendblue MCP改用API轮询-零攻击面、零基础设施、零安全风险。

# Send a message
send_sms(number="+15551234567", content="Campaign message here")

# Check for replies (no webhooks needed)
list_messages(is_outbound=False, limit=10)

47条消息后，在会话中，您的代理会记住对话上下文。

关于森蓝

深蓝色 是为该服务器提供动力的SMS/iMessage API。它们处理消息传递、电话号码管理、iMessage检测和传递状态跟踪。这个MCP服务器是一个包装器-它使用轮询而不是webhook将您的AI代理连接到Sendblue的REST API。

您需要一个Sendblue帐户和API凭据才能使用此工具。注册地址： sendblue.co 从那里拿钥匙 仪表盘.

该项目与Sendblue无关。 这是一个独立的开源MCP服务器，建立在他们的公共API上。

端到端：这到底是什么样子

周一——活动启动。 您的代理发送了50条外展消息：

for contact in campaign_list:
    send_sms(number=contact.phone, content=personalized_message)

星期二——检查回复。 不同的会话，不同的代理：

replies = list_messages(is_outbound=False, limit=50)
# Agent sees: 12 replies, 3 interested, 9 opt-outs

没有webhook设置。没有公共终结点。没有ngrok。只需确保API轮询。

为什么投票在竞选活动中比webhooks更受欢迎：

• ✅ 您的计算机上没有暴露的服务
• ✅ 无需维护的基础设施
• ✅ 无论如何，活动响应都不是实时的
• ✅ 创世站零安全风险
• ✅ 随时随地工作（无需静态IP）

适用于所有情况

Windsurf、Claude Desktop、任何兼容MCP的客户端。一个诗意的环境。除了Python 3.11+之外没有运行时依赖关系。

安装

1.克隆并安装：

git clone https://github.com/jackccrawford/sendblue-mcp.git
cd sendblue-mcp
poetry install --no-root

2.配置凭据：

创建 ~/.keys/sendblue.json:

{
  "api_key": "your_sendblue_api_key",
  "secret_key": "your_sendblue_secret_key",
  "from_number": "+15559876543",
  "contacts": {
    "alice": "+15551234567",
    "bob": "+15559998888"
  }
}

从获取您的凭据 Sendblue仪表板.

3.添加到MCP配置：

风帆冲浪(~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "sendblue": {
      "command": "/Users/YOUR_USERNAME/.local/bin/poetry",
      "args": [
        "-C",
        "/Users/YOUR_USERNAME/Dev/sendblue-mcp",
        "run",
        "python",
        "src/server.py"
      ],
      "env": {
        "FASTMCP_BANNER": "0",
        "PYTHONWARNINGS": "ignore"
      }
    }
  }
}

克劳德桌面(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "sendblue": {
      "command": "poetry",
      "args": ["-C", "/path/to/sendblue-mcp", "run", "python", "src/server.py"]
    }
  }
}

4.重新启动MCP客户端 （风帆、克劳德桌面等）

它是什么样子的

发送消息：

send_sms(
    number="+15551234567",
    content="Test from Sendblue MCP! 🚀"
)
# Returns: {"status": "QUEUED", "message_handle": "...", "from_number": "+15559876543"}

检查回复：

list_messages(is_outbound=False, limit=10)
# Returns: [{"content": "Interested!", "from_number": "+15551234567", ...}, ...]

获取您的联系人：

get_contacts()
# Returns: [{"name": "alice", "number": "+15551234567"}, {"name": "bob", "number": "+15559998888"}]

检查号码是否支持iMessage：

evaluate_service_type(number="+15551234567")
# Returns: {"number": "+15551234567", "service": "iMessage"}

运作原理

Sendblue MCP是一个由httpx支持的FastMCP服务器，用于异步API调用。没有webhooks。没有后台服务。没有公共终结点。

Agent → MCP Server (FastMCP) → Sendblue API (HTTPS)

消息通过Sendblue的REST API发送。通过轮询检索回复 /api/v2/messages 当你问。内容将保留在Sendblue的云中，直到您获取它。

安全模型：

• 凭据存储在本地 ~/.keys/sendblue.json （模式0600）
• 没有公开的公共端点
• 没有webhook接收器
• 您的机器上没有攻击面
• API调用是出界的（HTTPS到Sendblue）

工具

send_sms(number, content, send_style=None)

通过Sendblue发送短信或iMessage。

Args：

• number （str）：E.164格式的电话号码（例如。， +15551234567)
• content （str）：要发送的消息文本
• send_style （str，可选）：消息样式- 'invisible', 'gentle', 'loud', 'slam'

退货：

{
  "status": "QUEUED",
  "message_handle": "35d2bd01-5fe0-4ee3-a9fd-a61231e0ddd4",
  "from_number": "+15559876543",
  "to_number": "+15551234567",
  "date_sent": "2026-03-26T22:14:40.696Z"
}

list_messages(limit=10, is_outbound=False, offset=0)

列出最近的邮件（入站或出站）。在不需要webhook的情况下轮询Sendblue API。

Args：

• limit （int）：要检索的消息数（默认值：10，最大值：100）
• is_outbound （Bool）： False 对于接收到的消息， True 用于已发送的消息
• offset （int）：分页偏移量（默认值：0）

退货：

{
  "messages": [
    {
      "content": "Interested in learning more!",
      "from_number": "+15551234567",
      "to_number": "+15559876543",
      "is_outbound": false,
      "status": "RECEIVED",
      "date_sent": "2026-03-26T22:30:15.123Z"
    }
  ]
}

get_contacts()

从凭据文件中获取已保存联系人的列表。

退货：

[
  {"name": "alice", "number": "+15551234567"},
  {"name": "bob", "number": "+15559998888"}
]

check_message_status(account_email, number)

检查邮件的传递状态。

Args：

• account_email （str）：您的Sendblue帐户电子邮件
• number （str）：用于检查状态的电话号码

退货：

{
  "status": "DELIVERED",
  "last_message": "2026-03-26T22:14:40.696Z"
}

evaluate_service_type(number)

检查号码是否可以接收iMessage或SMS。

Args：

• number （str）：E.164格式的电话号码

退货：

{
  "number": "+15551234567",
  "service": "iMessage"
}

安全注意事项

为什么没有webhooks？

传统的webhook方法需要将您的本地计算机暴露于互联网（通过ngrok、Tailscale漏斗等）。这会在您的开发机器上创建一个攻击面，其中存在敏感资产（创世站、凭据、代码）。

投票更安全：

• 没有公共端点
• 没有入站连接
• 没有可利用的webhook接收器代码
• API调用是出界的
• 您可以控制何时获取消息

对于销售活动，民意调查就足够了：

• 回复不是实时的（人们需要数小时/数天才能回复）
• 每隔几分钟检查一次就够快了
• 零基础设施复杂性
• 零安全风险

如果你需要实时webhooks：

• 在隔离服务器（而不是您的Mac）上部署webhook接收器
• 使用没有特权访问的专用液滴
• 将消息转发到队列/数据库
• MCP轮询队列（您的计算机上仍然没有Webhook）

依赖项

• Python 3.11+
• FastMCP 2.0+
• httpx 0.28+
• 媒染剂2.10+

全部通过诗歌进行管理。无系统依赖关系。

许可证

麻省理工学院

关于

专为mVara的销售活动自动化而设计。专为消除了ngrok并需要安全双向消息传递的具有安全意识的团队而设计。

存储库： https://github.com/jackccrawford/sendblue-mcp\ 问题： https://github.com/jackccrawford/sendblue-mcp/issues\ Sendblue API： https://docs.sendblue.com