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