Retainful MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.2.4更新于 Nov 7, 2026

List contacts and lists; create contacts, add them to lists and record events in Retainful.

发布方自己的服务：Ably MCP by usefulapi

已验证Streamable HTTP可网页运行沟通与协作商业与电商

概览

AI 生成的概览

托管式 Retainful MCP 服务器，让助手读取联系人和列表、创建联系人、将其加入列表并记录事件。

可以做什么
  • 列出并读取联系人，含订阅状态与来源
  • 列出并读取列表和分群及其 id
  • 按邮箱或电话创建或更新联系人，并设置邮件同意状态
  • 一次调用中把联系人加入列表，可能触发自动化
  • 在联系人时间线上记录事件
  • 查看用量、提交功能请求、升级或取消订阅
适用场景
适合在 MCP 客户端中处理 Retainful 营销联系人和列表：查询是否已订阅、把联系人加入列表，或记录可驱动邮件自动化的事件，而无需自行开发 API 集成。
运行要求
远程 streamable HTTP 端点，无需本地安装。通过 OAuth 登录，首次连接时需提供在 Retainful 的 Integrations 中创建的 API 密钥；服务器按用户保存该密钥。客户端配置中不要填写密钥或 Authorization 头。超出免费月度调用额度后需付费方案。
安装前请注意
有三个写入工具：创建或更新联系人、把联系人加入列表、记录事件。加入列表或记录事件可能触发向联系人发送邮件的自动化，执行前应确认。email_opt_in 决定营销同意状态，必须基于真实同意；省略时已有联系人可能被设为 SUBSCRIBED。Retainful API 密钥会交给第三方托管方。付费方案涉及支付链接和扣费，取消后当期不退款。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Retainful MCP by usefulapi，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Fretainful/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "retainful-by-usefulapi": {
      "type": "http",
      "url": "https://retainful.usefulapi.io/mcp"
    }
  }
}

README

Retainful MCP by usefulapi

Use your Retainful account from Claude, Cursor, or any MCP client. Read contacts and lists, add contacts to lists, and record events. Hosted, no local install: connect with your own credentials.

Live endpoint: https://retainful.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://retainful.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http retainful https://retainful.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "retainful": {      "url": "https://retainful.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Retainful credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/retainful/

On first connect you provide your Retainful API key, created in Retainful under Integrations → your app → Create API key. The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
retainful_list_contactsreadList contacts
retainful_get_contactreadGet contact
retainful_list_listsreadList lists and segments
retainful_get_listreadGet list
retainful_upsert_contactwriteCreate or update contact
retainful_add_contact_to_listwriteAdd contact to list
retainful_track_eventwriteTrack event
retainful_usage_statusmetaUsage status (free-tier meter)
retainful_request_featuremetaRequest a missing feature
retainful_upgrademetaUpgrade to Pro or Pro+
retainful_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with retainful_upgrade (it returns a Stripe Checkout link). Cancel any time with retainful_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running retainful_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

来源：servers/retainful/README.md，提交 4046075

工具

7

retainful_list_contacts

List contacts

List contacts (profiles) in the Retainful organization, one page at a time, with consent status and source. Retainful API: GET /customer.

输入参数pagelimit

retainful_get_contact

Get contact

Get one contact (profile) by its Retainful id (contactUUID), with its attributes. Retainful API: GET /customer/{id}.

输入参数contact_id必填

retainful_list_lists

List lists and segments

List the lists and segments in the organization with their ids. Use the id as list_id in retainful_add_contact_to_list. Retainful API: GET /contact-groups.

输入参数pagetypelimit

retainful_get_list

Get list

Get one list or segment by its id. Retainful API: GET /contact-groups/{id}.

输入参数list_id必填

retainful_upsert_contact

Create or update contact

WRITE: create a contact, or update it when the email or phone already exists. Does not add anyone to a list. email_opt_in is required: it sets marketing consent, so send SUBSCRIBED only with real consent. Needs email or phone. Retainful API: POST /customer/create.

输入参数emailphonesourcelast_namefirst_nameexternal_idemail_opt_in必填phone_opt_incustom_properties

retainful_add_contact_to_list

Add contact to list

WRITE: create or update a contact by email and add them to a list in one call. A list can start an automation. email_opt_in is required: an existing contact is set to SUBSCRIBED when it is omitted here. Retainful API: POST /contact-groups/{listId}/contacts.

输入参数email必填phonesourcelist_id必填last_namefirst_nameemail_opt_in必填

retainful_track_event

Track event

WRITE: record one event on a contact's timeline. Automations triggered by the event can email the contact. Reuse the same unique_identifier only for a retry of the same real occurrence (a repeat does not trigger automations again); use a new one for each new occurrence. Event data must be flat: strings, numbers, or booleans. Retainful API: POST /events.

输入参数emailphoneevent_data必填event_name必填contact_uuidunique_identifier必填

版本历史

6
  1. v1.2.4最新Nov 7, 2026
  2. v1.1.3Nov 5, 2026
  3. v1.1.2Nov 5, 2026
  4. v1.1.1Nov 4, 2026
  5. v1.1.0Nov 3, 2026
  6. v1.0.1Nov 3, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成

Ably MCP by usefulapi

io.usefulapi官方发布者

MCP server for Ably — channel history, presence, occupancy, stats, publish, and app management.

Streamable HTTP可网页运行
沟通与协作15 个工具Nov 7, 2026

Woffu MCP by usefulapi

io.usefulapi官方发布者

托管式只读 MCP 服务器，让助手查询 Woffu 公司的用户、劳动合同、部门和办公地点。

Streamable HTTP可网页运行
商业与电商5 个工具Nov 7, 2026

White Label Loyalty MCP by usefulapi

io.usefulapi官方发布者

面向 White Label Loyalty 的托管 MCP 服务器：浏览奖励、查看客户积分钱包与等级进度，并用积分购买奖励。

Streamable HTTP可网页运行
商业与电商5 个工具Nov 7, 2026

Weekdone MCP by usefulapi

io.usefulapi官方发布者

托管的 Weekdone 连接器，让助手读取周报、团队、目标与 KPI，并新增报告条目、评论和 KPI 数值。

Streamable HTTP可网页运行
数据与分析15 个工具Nov 7, 2026

WebinarKit MCP by usefulapi

io.usefulapi官方发布者

托管式只读 MCP 服务器，让助手列出 WebinarKit 的网络研讨会、场次时间、系列、会议以及白标子账户。

Streamable HTTP可网页运行
商业与电商5 个工具Nov 7, 2026