Promise

ai.usepromise由 usepromise.ai 發布官方發布者v0.1.0更新於 Oct 24, 2026

Evidence-backed follow-through memory for what you owe, await, and need to remember.

已驗證Streamable HTTP可網頁執行效率與工作流知識與記憶

概覽

AI 產生的概覽

Promise 是託管式 MCP 伺服器，讓助理取得有證據支撐的待辦記憶：欠他人什麼、在等什麼、需要記住什麼，並附回 Promise 的連結。

可以做什麼
  • 查看今日需關注事項，列出或檢視承諾與等待事項
  • 顯示某筆跟進或記憶背後的證據與來源引用
  • 在對話前彙整某人的相關背景，並搜尋衍生記憶
  • 依使用者明確意圖記錄筆記、建立跟進
  • 將事項標記為完成，並草擬跟進訊息供在 Promise 中審閱
  • 回傳註冊連結，方便使用者在需要跟進記憶時連接 Promise
適用情境
適合希望助理跨對話追蹤使用者所欠事項與等待事項、說明某筆跟進為何存在，或在與某人會面前準備背景的情境；敏感操作仍留在 Promise 應用程式內完成。
執行需求
透過 streamable HTTP 連線的遠端 MCP 端點，未宣告本機套件或環境變數。受保護工具需要 Promise 帳號及經 Promise 授權流程取得的受限 Bearer 權杖；沒有權杖時工具會回傳授權連結。
安裝前請注意
工具會讀取並修改使用者的跟進記憶：筆記、跟進與完成狀態會寫入 Promise 平台；mark_resolved 與 draft_follow_up 會跳轉至 Promise 由使用者審閱，而非直接執行。若權限範圍允許，人物背景與證據可能揭露私密欄位。存取依賴 Bearer 權杖，應視為機密。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Promise，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/ai.usepromise%2Fpromise/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "promise": {
      "type": "http",
      "url": "https://mcp.usepromise.ai/mcp"
    }
  }
}

README

Promise MCP

Agent-facing MCP server/tools for Promise. The hosted HTTP endpoint is POST /mcp; GET /healthz is available for runtime checks.

This repository is intentionally separate from the Promise platform. It should compose the platform API into agent-friendly tools, not implement canonical backend business logic.

Boundary

  • Call the Promise platform API for data access and mutations.
  • Do not access Postgres, Redis, queues, provider tokens, or migrations directly.
  • Keep authorization, provenance, retention, provider behavior, and canonical domain rules in the platform.
  • Consume explicit platform contracts instead of duplicating procedure or capability names by hand.

Initial MCP tool surface:

  • connect_promise
  • get_today
  • list_commitments
  • get_commitment
  • get_commitment_evidence
  • get_person_context
  • search_memory
  • capture_note
  • create_follow_up
  • mark_resolved
  • draft_follow_up

connect_promise and unauthenticated tool results are intentionally part of the product. MCP should help users discover and connect Promise when an agent needs follow-up memory that Promise can provide.

Unauthenticated tool results include a scoped authorizationUrl that sends the user to https://app.usepromise.ai/start?source=mcp..., preserves agent attribution, and uses a relative /mcp/authorize callback inside Promise before any return to an agent URL.

Development

bash
npm installnpm run buildnpm run smokenpm run toolsnpm run start

Example MCP call:

bash
curl -sS http://localhost:3000/mcp \  -H 'content-type: application/json' \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Protected tools return a structured promise_auth_required result when no Bearer token is present. After the user authorizes /mcp/authorize, Promise returns a short-lived one-time code to the agent callback. The agent exchanges that code at /api/mcp/token for a scoped opaque pmcp_... bearer token. Bearer tool calls are proxied to the Promise platform API, which enforces the grant's scopes. mark_resolved and draft_follow_up intentionally deep-link to Promise for user review rather than sending or mutating mail directly.

See docs/ACQUISITION.md for signup flow guidance, docs/SECURITY.md for the MCP safety boundary, and docs/DEPLOYMENT.md for container/runtime details.

來源：README.md，提交 83133d0

工具

11

connect_promise

Connect Promise

Return a Promise signup URL for users who want agent access to follow-up memory. Safety: Never collects provider credentials in the agent. Send the user to Promise.

輸入參數stateintentscopesreturnUrlclientName

get_today

Get Today

Return what currently deserves the user's attention. Safety: Return concise items and links back to Promise for sensitive action.

輸入參數horizonDays

list_commitments

List commitments

List what the user owes and what the user is waiting on. Safety: Do not infer more certainty than Promise returns.

輸入參數limitscopecategory

get_commitment

Get commitment

Retrieve a structured Promise commitment or waiting-on item. Safety: Prefer structured status, due dates, people, and source links over raw mail.

輸入參數id必填

get_commitment_evidence

Get commitment evidence

Show why Promise believes a follow-up or memory exists. Safety: Return source summaries and citations permitted by the platform API.

輸入參數id必填

get_person_context

Get person context

Summarize what matters before the user speaks with someone. Safety: Avoid exposing hidden/private fields unless the platform scopes allow them.

輸入參數limitquerycontactId

search_memory

Search memory

Search Promise's derived memory with user authorization. Safety: Search derived Promise memory, not raw provider mailboxes.

輸入參數limitquery必填

capture_note

Capture note

Let a user tell Promise something to remember. Safety: Echo what Promise understood and require review when the platform requests it.

輸入參數kinddueAttitlecontactIdrequestIdpersonNametranscript必填

create_follow_up

Create follow-up

Create a future follow-up from explicit user intent. Safety: Only create follow-ups from explicit user instructions.

輸入參數dueAttitle必填contactIdrequestIdpersonNametranscript

mark_resolved

Mark resolved

Tell Promise that a commitment or waiting-on item is complete. Safety: Confirm destructive or irreversible status changes in the agent UI.

輸入參數id必填

draft_follow_up

Draft follow-up

Draft a follow-up message without sending it. Safety: Do not send email in v1. Return a draft and Promise confirmation link.

輸入參數goalcontextpersonNamecommitmentId

版本歷史

1
  1. v0.1.0最新Sep 22, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。