SENTINEL Washington Real Estate

SENTINEL Washington 房地产 MCP

为软件和兼容的 AI 助手提供带来源日期的 Washington 房产证据和交易计算。一个 REST 和 MCP 服务整合了支持的县级事实、许可和场地背景、REET、卖方计算以及范围受限的研究资料包。它可补充已获许可的 MLS 数据，但不能取代 MLS 数据源。

开发者指南 · 控制台 · OpenAPI · 开发者条款

在 Claude 或 ChatGPT 中使用

适用于 Washington 房地产经纪人。将一个地址粘贴到助手中并登录一次；无需密钥或代码。

• Claude（claude.ai、Desktop 或移动端）：依次点击 Settings、Connectors、Add custom connector。将其命名为 Sentinel，并粘贴 https://app.sentineliq.net/api/v1/mcp。
• ChatGPT（需在设置中启用开发者模式）：创建一个新应用，粘贴相同地址并选择 OAuth。

REET、卖方净收益表和 NWMLS 截止时间计算器无需账户即可立即使用。首次询问房产、许可或市场数据时，助手会显示 Connect 按钮：登录 Sentinel（或创建账户），批准连接后，助手便会继续操作。您可以免费获得 25 次答复；之后，Sentinel Connect 的费用为每月 $29，可随时通过控制台取消，您也可以在控制台中断开助手连接。

试着询问：“King County 一笔 $750,000 的交易要缴多少 REET？”、“查询 Bellingham 的 123 Main St 的许可历史”、“King County 的房价有何变化？”或“按 $725k 和 $750k 的售价、$420k 的待偿贷款，制作一份卖方净收益表。”

无需账户即可试用

curl -s https://app.sentineliq.net/api/v1/public/reet \
  -H 'Content-Type: application/json' \
  -d '{"sale_price":750000,"county":"king"}'

示例：$8,655 州级 REET + $3,750 县级地方 REET + $5 技术费 = 估算总额 $12,410。完整响应包含税率档、适用范围、假设、免责声明和出处。此估算适用于标准住宅转让；请核实地点代码和适用规则。

工具

MCP 名称	/api/v1/agent-api/v1 后的带密钥 REST 路径	访问权限
wa_research_packet	POST /research-packet	密钥
wa_property_changes	POST /property-changes	密钥
wa_local_context	GET /local-context	密钥
wa_site_context	GET /site-context	密钥
wa_reet	POST /reet	公开或密钥
wa_net_sheet	POST /net-sheet	公开或密钥
nwmls_deadlines	POST /deadlines	公开或密钥
wa_property_lookup	GET /property	密钥
wa_permit_history	GET /permit-history	密钥
wa_sale_history	GET /sale-history	密钥
wa_market_trends	GET /market-trends	密钥
wa_market_snapshot	GET /market	密钥（已暂停）
wa_compare_seller_scenarios	POST /seller-scenarios	密钥
wa_compare_offers	POST /offers/compare	密钥
wa_monthly_payment	POST /monthly-payment	密钥
wa_seller_packet	POST /seller-packet	密钥

三个公开 REST 计算器使用 /api/v1/public/。工具不会创建交易、更改 CRM 记录或发送消息。成功的带密钥调用会更新账户的使用情况账本。

REST 字段名称使用 snake_case。MCP 参数使用 camelCase；请检查 tools/list 以查看确切的架构。MCP 输出保留 REST 响应中的字段名称。

连接

公共 URL：https://app.sentineliq.net/api/v1/mcp/public 带密钥的 URL：https://app.sentineliq.net/api/v1/mcp

公共连接提供三个计算工具。带密钥的连接会列出全部 16 个工具，并且无需凭据即可使用这三个计算工具。对于其他工具，连接支持以下任一方式：

• OAuth 登录（Claude、ChatGPT 及其他支持 MCP 授权的客户端）：服务会返回 401，并在 WWW-Authenticate 标头中指向 /.well-known/oauth-protected-resource。Sentinel 的授权服务器支持 PKCE（S256）、动态客户端注册和客户端 ID 元数据文档。每个获批的连接都会在控制台中显示为“Connected app: name”，并可在控制台中撤销。
• API 密钥：在客户端受保护的凭据设置中设置 Authorization: Bearer agk_...。密钥应保存在服务器上或安全的本地配置中，绝不能放在共享的源文件里。

Cursor

使用 .cursor/mcp.json：

{
  "mcpServers": {
    "sentinel": {
      "url": "https://app.sentineliq.net/api/v1/mcp/public"
    }
  }
}

VS Code

使用 .vscode/mcp.json。VS Code 使用 servers 和显式传输类型：

{
  "servers": {
    "sentinel": {
      "type": "http",
      "url": "https://app.sentineliq.net/api/v1/mcp/public"
    }
  }
}

Claude Code

claude mcp add --transport http sentinel https://app.sentineliq.net/api/v1/mcp/public

其他客户端必须支持远程 HTTP MCP 服务。是否可用以及受保护标头的配置方式因客户端和套餐而异。不作普遍兼容性声明。可选的 Claude Desktop 示例使用第三方 stdio 桥接工具；使用前请审查该依赖项。

协议行为

服务版本：1.5.1。支持的协议修订版本为 2026-07-28、2025-06-18 和 2025-03-26。传输方式为无状态 HTTP POST，响应为 JSON；不提供旧版 HTTP+SSE 服务。

当前使用 2026-07-28 的客户端会使用 server/discover。请求包含 MCP-Protocol-Version 和 Mcp-Method 标头；tools/call 还会包含 Mcp-Name。请求正文中的 params._meta 必须携带 io.modelcontextprotocol/protocolVersion 和 io.modelcontextprotocol/clientCapabilities。标头和正文中的值必须一致。

使用旧版 2025-03-26 和 2025-06-18 的客户端会使用 initialize，并在此后发送协商好的 MCP-Protocol-Version 标头。受支持的结构化结果修订版本会在文本内容旁返回 structuredContent 和 outputSchema。请检查协商后的能力，不要假定客户端版本。

Initialize、发现和通知不会消耗成功调用配额。业务失败会通过 result.isError 和文本错误呈现；协议错误则使用 JSON-RPC 错误。联系支持时请保留 X-Request-Id。

通过证据研究一个房产

wa_research_packet 工具会解析一个受支持的华盛顿州房产，并通过单个有界响应返回有来源支持的事实、计算、冲突、未知信息、后续问题和字段级引用。精简版和完整版投影保留相同的声明、限定条件和必需声明。可选的坐标上下文仍是独立的点位观测，绝不会被视为地块匹配的证明。有用的部分数据包计为一次成功调用；无法获取或存在歧义的研究则不计入。

wa_property_changes 会读取 Sentinel 实际捕获的许可证版本。它会区分机构事件日期和 Sentinel 观测时间，并将首次捕获视为基线，而非新观测到的变化。历史记录从首次不可变捕获开始，且可能不完整。

构建卖方资料包

一个不依赖数据的首次请求会比较两个价格，并采用已知的结清金额，且明确不包含卖方抵免：

{
  "county": "king",
  "scenarios": [
    {"label": "Conservative", "sale_price": 725000, "mortgage_balance": 420000, "concessions": 0},
    {"label": "Target", "sale_price": 750000, "mortgage_balance": 420000, "concessions": 0}
  ]
}

使用你的 bearer key，将此请求正文 POST 到 /api/v1/agent-api/v1/seller-packet。 响应包含 report_markdown、结构化情景、各部分状态、数据缺口、 生成时间和来源信息。房产和市场输入均为可选项；在暂停销售价格 快照期间，市场输入会根据 market_trends 字段中的授权市场趋势作答。 该资料包不是估价报告或 CMA，也不会获取可比销售数据。

省略或设为 null 的 mortgage_balance 和 concessions 表示未知。明确设为 0 则表示没有贷款结清金额或卖方抵免。保留每个收益标签及其 mortgage_payoff_known 和 concessions_known 标记。情景差额包含 comparable 和一个可为 null 的金额；差额为 null 并不等于零。响应中的 fully_comparable 标志会告知你每个情景是否都已知结清金额和卖方抵免。

报价比较共用同一个结清金额。当每份报价的抵免都已知时，即使结清金额 未知，仍可比较差额，但 comparison_basis 为 before_mortgage_payoff， 而不是 net_proceeds。抵免未知时，不会显示报价差额和最高收益标签。 不要将未知成本扣除前的收益金额表述为卖方最终到手现金。

Python 和 curl 示例演示了不会发送消息或更改客户记录的调用。运行这些 示例时会发起网络请求。

覆盖范围和数据解读

• 县级房产记录仅覆盖 King、Pierce、Snohomish 和 Whatcom。
• REET 地方税率假设覆盖 11 个县；这不代表房产数据也覆盖这 11 个县。
• 历史缓存的建筑属性可能包含早期补充的数据，且未经逐项独立核实。若 未记录历史来源追踪，interior_provenance_status 为 not_recorded；请将 provenance_note 与这些属性一并保留。县级归属不能证明每项建筑属性的来源。
• 已知的门户网站回填数据会被省略（portal_suppressed）。当前房源覆盖值会替换为 缓存的房产值，这些值同样受历史来源信息的限制。缺失或不可用的信息仍为 null。
• 仅当匹配到已存档的授权房源时，才会包含房源状态、价格及相关字段。null 表示没有已存档的授权房源，并不表示该房产已退出市场。
• 不会返回房源链接、照片和门户网站自动估值。
• 不包含所有者身份、邮寄地址、非自住分类和净资产估算。不提供名单导出、批量 枚举或潜在客户数据源。
• 已记录的销售历史（wa_sale_history）适用于一处 Pierce 或 Snohomish County 地块：最多包含 3 年的县评估员销售日期和价格，并附带有效性代码，不含买方、 卖方或所有者姓名。
• 市场趋势（wa_market_trends）可根据使用条款已记录的来源，查询 Washington ZIP 编码、县、城市（按其 ZIP 编码）或都市区：FHFA 房价指数（涨幅指数，不是 美元价格）；以及在确认使用条款后提供的 Realtor.com 月度房源库存（挂牌 价格，不是已成交销售价格）。每个数据块都会注明发布方、周期、来源文件哈希 和所需声明。没有授权数据的地区可免费查询。
• 销售价格市场快照（wa_market_snapshot）在审核其来源的使用条款期间暂停提供。 调用会返回不可用错误，且不收费。
• 请保留标记为 required 的归属信息，以及所有相关假设和免责声明。 开发者条款 适用于来源数据和 API 使用；示例代码许可证不授予额外的数据再分发权。

访问与限制

公共 REST 计算器：每个公共客户端 IP 每分钟 60 次请求，每天 5,000 次请求。 公共 MCP：每个公共客户端 IP 每分钟 60 次请求，每天 500 次请求。 需密钥的工具：每个密钥每分钟 60 次请求；每个账户每滚动 24 小时最多成功调用 2,000 次，REST 和 MCP 共用。每个账户最多可有 5 个有效密钥。 试用包含 25 次终身成功调用。失败的请求、验证失败、未找到的查询以及 whoami 检查均不计入此额度。 GET /api/v1/agent-api/v1/whoami 是免费的身份／用量检查。

现有付费账户保留其 API 访问权限和已公布的账户额度。 目前的入门选项包括 25 次答复试用、Sentinel Connect 和集成试点。

Sentinel Connect，每月 29 美元，适用于在 Claude 或 ChatGPT 中使用 Sentinel 的 Agent：可使用完整的密钥目录，并享有上述账户额度；按月续订，直至从控制台取消。

可选的 250 美元、30 天集成试点涵盖一项双方商定的工作流、一个最多配有 5 个集成密钥的开发者账户、设置协助和一次成功情况检查。这是一次性付款，不会自动续订。仅在付款设置可用时显示结账选项；否则，请在试点开始前联系创始人。这些是集成密钥，不是用户席位；仍适用已公布的每账户限制。请联系 [email protected]。