Prism by Parad1gm: Contract Deadlines and Critical Dates

Prism MCP 服务

本仓库中的 MIT 许可证仅涵盖其文档和示例，不涵盖 Prism 服务。

Prism 会读取合同——住宅和商业租约、抵押贷款、保险保单及 HOA 文件——并列出每个截止日期（续约通知、取消期限、租金审查、选择权日期），同时提供准确日期、错过期限的后果，以及对应的合同原文句子。日期根据合同自身规则计算，而非估算。本仓库介绍如何将 AI Agent 连接到托管的 Prism MCP 服务。

托管端点

URL	https://prism.parad1gm.com/api/prism-mcp
传输方式	MCP Streamable HTTP
身份验证	OAuth 登录，或将 Prism API 密钥用作 bearer token
注册表名称	com.parad1gm/prism

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

OAuth 详情

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

不使用 OAuth

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

Authorization: Bearer YOUR_PRISM_KEY

机器可读描述

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

连接

Claude（claude.ai 和 Claude Desktop）

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

参见 examples/claude-desktop.md。

Claude Code

claude mcp add --transport http prism https://prism.parad1gm.com/api/prism-mcp

参见 examples/claude-code.md。

Cursor

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

{
  "mcpServers": {
    "prism": { "url": "https://prism.parad1gm.com/api/prism-mcp" }
  }
}

参见 examples/cursor-mcp.json。

VS Code

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

{
  "servers": {
    "prism": {
      "type": "http",
      "url": "https://prism.parad1gm.com/api/prism-mcp"
    }
  }
}

参见 examples/vscode-mcp.json。

Windsurf 和其他 MCP 客户端

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

• URL：https://prism.parad1gm.com/api/prism-mcp
• 传输方式：Streamable HTTP
• 身份验证：OAuth（客户端会从服务发现相关信息），或 Authorization: Bearer YOUR_PRISM_KEY 标头

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

工具

工具	功能
prism_review_contract	将租约、抵押贷款、保险单、业主协会（HOA）文件或商业租约作为 url、text 或 fileBase64 中的一种发送（PDF 或照片，最大 25MB）。立即返回 contractId；读取大约需要一分钟。
prism_get_contract	根据 contractId 获取一份合同的状态和结果：如果已付费，则返回全部事实；否则返回免费的 3 条事实预览。不会消耗额度。
prism_unlock_contract	获取一份已完成读取的合同中的所有截止日期和风险。消耗 1 个额度（$0.50），已付费的合同除外。没有额度时，会返回包含 code: "insufficient_credits" 的预览。
prism_upcoming_deadlines	获取账户中所有合同尚未到期的截止日期，按时间从近到远排列，在 withinDays 范围内（默认 90 天）。
prism_list_contracts	获取账户中的所有合同，按添加时间从新到旧排列，并显示状态及是否已解锁完整结果。支持分页。
prism_get_account	获取剩余额度、价格、无限订阅是否涵盖所有内容，以及本月添加的合同数。creditStatus 的值为 ok、low（剩余 2 个或更少）、empty 或 unlimited；purchaseOptions 会说明购买是否需要用户操作（结账链接），还是 Agent 可以自行付款。
prism_buy_credits	获取以每个 $0.50 的价格购买 20–2000 个额度的方式：提供给用户的 Stripe 结账链接，以及在可用时供 Agent 自行付款的 MPP 购买 URL。
prism_send_feedback	告知 Prism 团队结果有误、内容有遗漏，或什么价格合适。每条消息都会由工作人员阅读。免费。如果团队复现了错误结果，账户将获得 10 个免费额度。

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

典型流程：调用 prism_review_contract，等待大约一分钟，然后调用 prism_get_contract。如果合同尚未付费，调用 prism_unlock_contract 消耗一个额度以获取完整结果。再次发送相同的文档会返回同一份合同。

避免额度用尽带来意外。 批量处理前，检查 prism_get_account 返回的 creditStatus。当其值为 low 或 empty 时，或者解锁返回 code: "insufficient_credits" 时，调用 prism_buy_credits。任何已连接的 Agent 都可以自行调用此工具：它会返回供用户使用的结账链接；当 purchaseOptions.agentPayment 为 true 时，还会返回 Agent 可通过机器支付协议（MPP）自行付款的购买 URL。只有结账链接需要人工操作。

A2A

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

• Agent 卡片：https://prism.parad1gm.com/.well-known/agent-card.json
• 技能：read-contract（将合同作为消息发送，然后轮询任务）和 unlock-contract（在处于 input-required 状态的任务上回复 unlock）。

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

定价

Agent（MCP 和 A2A）

• 每份合同 $0.50（1 个额度），仅在首次交付完整结果时收费。
• 每个新账户都会获得 3 个免费额度。
• 预览、重新读取以及 Prism 无法读取的文档均免费。同一份文档不会重复收费。
• 每次至少购买 20 个额度（最低 $10）。Agent 可以提供结账链接，也可以在支持时通过 MPP 钱包自行付款。
• Agent 解锁的合同与用户自行添加的合同一样，会在每个截止日期的 90 天、30 天和 7 天前收到邮件提醒。
• 使用 prism_send_feedback 报告 Prism 的错误结果（提供合同以及你预期的日期或条款）。团队复现问题后，账户将获得 10 个免费额度。

用户（在网站上）

• 每份合同一次性收费 $1；或者
• 每月 $9（无限订阅），每月最多处理 50 份合同。

隐私与数据

• 已连接的 Agent 只能访问你自己的 Prism 账户。你可以允许它只读而不发送合同（仅限 prism:read），也可以随时在 安全设置 中断开连接。
• Prism 不会出售你的数据。文档只会与运行 Prism 所需的服务提供商共享：读取文档的 AI 提供商、发送提醒的电子邮件提供商、负责付款的 Stripe，以及云托管服务商。
• 付款详情由 Stripe 处理。Prism 不会查看或存储银行卡号。
• 上传文档并不意味着 Prism 拥有该文档。请只上传你有权分享的文档。
• 只要你的账户处于开启状态，数据就会保留。发送电子邮件至 [email protected]，即可导出数据或删除账户。
• Prism 会解读文档，但不提供法律建议，也可能出错：重要事项请对照文档本身核实。

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

支持

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

关于此代码库

此代码库包含托管式 Prism MCP 服务的文档和客户端配置，以及发布到 MCP Registry 的 server.json。Prism 服务本身为闭源；此处不包含服务端代码。