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 分

    请在仓库或注册中心条目中声明许可证。