Retainful MCP by usefulapi

usefulapi 提供的 Retainful MCP

通过 Claude、Cursor 或任何 MCP 客户端使用你的 Retainful 账号。读取联系人和列表，将联系人添加到列表，并记录事件。托管服务，无需本地安装：使用你自己的凭据连接。

在线端点： https://retainful.usefulapi.io/mcp · 主页： https://usefulapi.io

连接

• Claude（claude.ai、Desktop）：打开 Customize → Connectors，点击 + Add → Add custom connector，然后粘贴 https://retainful.usefulapi.io/mcp。
• Claude Code： claude mcp add --transport http retainful https://retainful.usefulapi.io/mcp，然后运行 /mcp 登录。
• VS Code： 添加到 VS Code。
• Cursor 和其他客户端： 将 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "retainful": {
      "url": "https://retainful.usefulapi.io/mcp"
    }
  }
}

只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥：服务会通过 OAuth 为你登录，登录页面会要求你提供 Retainful 凭据。

分步设置说明、凭据获取位置及常见问题：https://usefulapi.io/retainful/

首次连接时，你需要提供 Retainful API key，可在 Retainful 的 Integrations → your app → Create API key 下创建。服务会验证该密钥并按用户存储。无需将密钥放入配置文件。

工具

工具	类型	功能
retainful_list_contacts	读取	列出联系人
retainful_get_contact	读取	获取联系人
retainful_list_lists	读取	列出列表和细分群组
retainful_get_list	读取	获取列表
retainful_upsert_contact	写入	创建或更新联系人
retainful_add_contact_to_list	写入	将联系人添加到列表
retainful_track_event	写入	跟踪事件
retainful_usage_status	元数据	使用情况（免费套餐用量）
retainful_request_feature	元数据	申请缺失的功能
retainful_upgrade	元数据	升级到 Pro（无限*）
retainful_cancel_subscription	元数据	取消 Pro 订阅

read 工具仅供读取；write 工具会修改数据（客户端应要求确认）；meta 工具用于报告用量、管理订阅或发送功能申请。

定价

套餐	价格	限额
免费	$0	每月 50 次工具调用
Pro（按用户计费）	$9/mo 或 $90/yr（免费 2 个月）	无限*

*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多，请发送邮件至 [email protected]。

Pro 仅适用于此服务。使用 retainful_upgrade 订阅（它会返回 Stripe Checkout 链接）。可随时使用 retainful_cancel_subscription 取消：Pro 会持续到付费周期结束，当前周期不予退款；在此之前运行 retainful_upgrade 可撤销取消。也可发送邮件至 [email protected]。

许可证

MIT — 参见 LICENSE。仅提供文档；服务由托管平台运行。