Revalidata: Contract Deadlines and Critical Dates

Revalidata MCP 服务

此仓库中的 MIT 许可证 仅适用于其文档和示例，不适用于 Revalidata 服务。

Revalidata 会读取合同并列出其中的截止日期：日期、错过期限会发生什么，以及记录该日期时读取的合同原文段落。它可以读取住宅和商业租约、抵押贷款、保险单、HOA 文件、买卖协议、建筑合同、贷款修改协议和供应商协议。日期根据合同自身的规则计算，而非估算。它可能会遗漏日期；遗漏频率会在 revalidata.com/accuracy 衡量并公布。

此仓库介绍如何将 AI Agent 连接到托管的 Revalidata MCP 服务。Revalidata 是 Built AI, Inc. 的产品。

托管端点

URL	https://revalidata.com/mcp
传输方式	MCP Streamable HTTP
身份验证	OAuth 登录，或将 Revalidata API 密钥用作 bearer token
注册表名称	com.revalidata/contracts
Claude 连接器目录	Revalidata Contracts

开始使用无需 API 密钥。客户端首次连接时，会通过 OAuth 登录 Revalidata 账户，然后由你选择 Agent 可以执行哪些操作。

OAuth 详情

• OAuth 2.1 授权码流程，使用 PKCE（S256）；面向公共客户端，无需客户端密钥。
• 支持动态客户端注册，因此 MCP 客户端可以自行注册。
• 权限范围：
  • prism:read：查看已保存的合同、截止日期以及 Revalidata 发现的风险。
  • prism:write：使用你的额度，将合同发送给 Revalidata 读取。
• 受保护资源元数据：https://revalidata.com/.well-known/oauth-protected-resource/mcp
• 授权服务器元数据：https://revalidata.com/.well-known/oauth-authorization-server

不使用 OAuth

登录后，在账单页面创建 API 密钥，并将其作为 bearer token 发送：

Authorization: Bearer YOUR_REVALIDATA_KEY

机器可读的说明

• MCP 服务卡片：https://revalidata.com/.well-known/mcp/server-card.json
• A2A Agent 卡片：https://revalidata.com/.well-known/agent-card.json
• 面向大模型的摘要：https://revalidata.com/llms.txt

连接

Claude（claude.ai 和 Claude Desktop）

在 Claude 的连接器目录中找到 Revalidata Contracts 并连接，或自行添加：

1. 打开设置，然后选择连接器。
2. 选择添加自定义连接器。
3. 粘贴 https://revalidata.com/mcp，并在提示时登录 Revalidata。

请参阅 examples/claude-desktop.md。

Claude Code

claude mcp add --transport http revalidata https://revalidata.com/mcp

请参阅 examples/claude-code.md。

Cursor

添加到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）：

{
  "mcpServers": {
    "revalidata": { "url": "https://revalidata.com/mcp" }
  }
}

请参阅 examples/cursor-mcp.json。

VS Code

添加到工作区中的 .vscode/mcp.json：

{
  "servers": {
    "revalidata": {
      "type": "http",
      "url": "https://revalidata.com/mcp"
    }
  }
}

请参阅 examples/vscode-mcp.json。

Windsurf 和其他 MCP 客户端

任何支持远程 MCP 服务的客户端都需要三个值：

• URL：https://revalidata.com/mcp
• 传输方式：Streamable HTTP
• 身份验证：OAuth（客户端会从服务中自动发现），或使用 Authorization: Bearer YOUR_REVALIDATA_KEY 标头

大多数客户端都接受与 Cursor 示例相同的 mcpServers 结构。请查阅客户端文档，了解远程 URL 对应的确切键名（例如，Windsurf 使用 serverUrl）。

之前已经连接？ 旧地址 https://revalidata.com/api/prism-mcp 和 https://prism.parad1gm.com/api/prism-mcp 仍可使用，因此之前的设置不会失效。新设置应使用 https://revalidata.com/mcp。

工具

工具	功能
prism_review_contract	以 url、text 或 fileBase64（PDF 或照片）中的一种格式发送合同。立即返回 contractId；读取大约需要一分钟。再次发送同一份文档会返回相同的合同。
prism_get_contract	根据 contractId 获取一份合同的状态和结果：摘要、截止日期（类型、日期、距截止日期的天数、错过截止日期会发生什么、来源句子）、风险，以及租约、抵押贷款、保险单、HOA 文档和服务协议的关键条款摘要。已付费合同可查看完整结果，否则只能查看免费预览。不会消耗积分。
prism_unlock_contract	获取已完成读取的合同的完整结果。除非已付费，否则会消耗 1 个积分（$0.50）。调用前请询问用户。
prism_upcoming_deadlines	列出账户中所有合同尚未到期的截止日期，按临近程度从近到远排序，并限定在 withinDays 天内（默认为 90 天）。
prism_list_contracts	列出账户中的所有合同，按添加时间从新到旧排序，并显示状态以及是否已解锁完整结果。支持分页。
prism_get_account	剩余积分、价格、Unlimited 订阅是否涵盖所有内容，以及本月添加的合同数。creditStatus 的取值为 ok、low（剩余 2 个或更少）、empty 或 unlimited。
prism_buy_credits	生成 Stripe 结账链接，供用户购买积分（每个 $0.50，一次购买 20 到 2,000 个）。该工具不能付款：用户需打开链接并在 Stripe 页面上付款。调用前请询问用户。
prism_send_feedback	告知 Revalidata 团队结果有误、不支持某种文档类型、缺少某项功能，或什么价格比较合适。每条消息都会由专人阅读；但不保证回复或修复。如果团队复现了错误结果，账户将获得 10 个免费积分。

完整的输入和输出架构见服务卡片。

典型流程：调用 prism_review_contract，等待大约一分钟，然后调用 prism_get_contract。如果合同尚未付费，征得用户同意后，调用 prism_unlock_contract 消耗 1 个积分以获取完整结果。

积分即将用完。 批量处理前，请检查 prism_get_account 返回的 creditStatus。如果其值为 low 或 empty，或者解锁操作返回 code: "insufficient_credits"，请先询问用户，然后调用 prism_buy_credits 生成结账链接，由用户自行付款。

A2A

Revalidata 也支持 Agent2Agent（A2A）协议的 JSON-RPC 绑定，版本为 1.0 和 0.3。

• Agent 卡片：https://revalidata.com/.well-known/agent-card.json
• 技能：read-contract（通过消息发送合同，然后轮询任务）、unlock-contract（在任务处于 input-required 状态时回复 unlock）和 send-feedback。

A2A 使用与 MCP 服务相同的 OAuth 服务和令牌，Revalidata API 密钥也可用作 bearer 令牌。价格相同。

定价

Agent（MCP 和 A2A）

• 每份合同 $0.50（1 个积分）；首次交付完整结果时一次性收费。
• 每个新账户都会获得 3 个免费积分。
• 预览、重新读取以及 Revalidata 无法读取的文档均免费。同一份文档不会重复收费。
• 积分须每次购买至少 20 个（最低 $10），通过结账链接购买，由用户付款。
• Agent 解锁的合同，与用户自行添加的合同一样，会在每个截止日期前 90 天、30 天和 7 天收到电子邮件提醒。

个人用户（网站）

• 每份合同一次性收费 $1；
• 每月 $9（Unlimited），每月最多处理 50 份合同；或
• 物业管理套餐每月 $49，供 5 人使用，每月最多处理 1,000 份合同。

隐私和数据

• 已连接的 Agent 只能访问你自己的 Revalidata 账户。你可以允许它读取数据，但不发送合同（仅授予 prism:read 权限），也可以随时在 Revalidata 账户的「安全」页面断开连接。
• Revalidata 不会出售你的数据。只有运行服务所需的服务提供商会接触到这些数据：读取你文档的 AI 提供商、发送提醒的电子邮件提供商、负责支付的 Stripe，以及云托管服务商。
• 支付详情由 Stripe 处理。Revalidata 绝不会查看或存储银行卡号。
• 上传文档不会让 Revalidata 获得其所有权。请仅上传你有权分享的文档。
• 只要你的账户保持开启，数据就会保留。请发送电子邮件至 [email protected]，导出数据或删除账户。
• Revalidata 会解释文档，但不提供法律建议，而且可能出错：请对照文档本身核实任何重要信息。

请阅读完整的隐私政策和条款。Revalidata 由 Built AI, Inc. 运营。

支持

请发送电子邮件至 [email protected]。若连接客户端时遇到问题，也可以提交问题。请勿在问题中发布合同内容、个人信息、API 密钥或令牌。

关于此代码库

此代码库包含托管的 Revalidata MCP 服务的文档和客户端配置，以及发布到 MCP Registry、名称为 com.revalidata/contracts 的 server.json。工具名称保留原有的 prism_ 前缀，以确保现有集成继续正常运行。Revalidata 服务本身是闭源的；此处不包含服务端代码。