SavePropTax

SavePropTax MCP 服务

一个用于加州房产税申诉的远程 MCP 服务和开放 HTTP API。

询问房屋是否被高估。如果近期可比房屋的销售价格支持更低的估值，它会准备县政府自己的 Proposition 8 价值下降复核表，并向房主发送签署链接。房主签署并支付固定费用 29 美元。查询免费、无需密钥，而且结果只会降低税单，绝不会提高税单。

无需安装任何内容。服务已托管：

https://saveproptax.com/mcp

Streamable HTTP，无需身份验证，无状态。

添加到客户端

Claude： 依次打开“设置”、“连接器”和“添加自定义连接器”，然后粘贴上方的 URL。

ChatGPT： 依次打开“设置”和“连接器”（或“应用”），然后通过 URL 添加 MCP 服务（前提是你的套餐支持自定义连接器）。

Claude Code：

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

任何 MCP 客户端： 将 Streamable HTTP 传输指向该 URL。无需令牌。

工具

工具	参数	功能
check_property_tax_savings	address（必填）、unit	免费查询一处加州住宅。返回状态、当前评估值、根据近期可比房屋销售情况得出的估值，以及预估年节省金额。符合条件的结果会附带 continueToken。
start_filing	continueToken、ownerName、ownerPhone、ownerEmail	准备县政府表格，并向房主发送签署链接。该链接绝不会返回给客户端。
get_filing_status	docId	仅返回概括性状态：awaiting_signature、awaiting_payment、filed、delivered、unknown。不含个人信息。

一切行为所遵循的规则

Agent 绝不处理签名或资金。 签署链接会发送到房主的收件箱。房主审核县政府自己的表格、签署并付款。匿名调用者最坏的情况也只是进行一次免费查询，并向真正的房主发送一条关于其房产的有效链接。

HTTP API

无需 MCP 即可使用相同功能。无需密钥。

curl -s https://saveproptax.com/api/agent/check \
  -H 'Content-Type: application/json' \
  -d '{"address": "123 Main St, Walnut Creek"}'

符合条件的响应：

{
  "status": "qualifies",
  "message": "This property qualifies: recent comparable sales support a value of $915,000 against the $1,024,000 assessment, an estimated $1,204 per year in tax savings; filing costs a flat $29 and the owner signs and pays.",
  "property": { "address": "123 MAIN ST, WALNUT CREEK CA", "county": "Contra Costa" },
  "estimate": { "assessment": 1024000, "opinion": 915000, "estimatedAnnualSavings": 1204 },
  "filing": { "feeUsd": 29, "deadline": "November 30, 2026" },
  "continueToken": "eyJ...valid 24 hours",
  "cached": false,
  "checkedAt": "2026-08-19T18:00:00.000Z"
}

然后提供令牌和房主信息以准备申请：

curl -s https://saveproptax.com/api/agent/prepare \
  -H 'Content-Type: application/json' \
  -d '{
    "continueToken": "eyJ...",
    "ownerName": "Jane Homeowner",
    "ownerPhone": "925 555 0100",
    "ownerEmail": "[email protected]"
  }'

{ "docId": "d0c1d2...", "status": "awaiting_signature",
  "statusUrl": "https://saveproptax.com/api/agent/status?doc=d0c1d2...",
  "ownerEmailSent": true }

轮询状态端点以查看进度：

curl -s 'https://saveproptax.com/api/agent/status?doc=d0c1d2...'

需要处理的所有状态

status	含义
qualifies	可比房屋销售情况支持有依据地降低估值，年节省金额超过 500 美元，且县政府受理窗口开放。只有此状态会附带 continueToken。
fair_assessment	今年的销售情况不支持将估值降至当前评估值以下。
not_enough_data	近期匹配度较高的销售案例太少，无法有依据地提交申请。
not_residential	县政府的地块记录显示该地块不属于住宅用地。
window_closed	县政府的复核窗口已关闭；filing.reopens 会说明窗口何时重新开放。
county_not_served	暂未覆盖该加州县。
already_filed	今年已为该房产提交复核申请。
address_not_found	重试时附上城市名称。
needs_more_info	消息会说明缺少哪些信息，例如单元号。
busy	负载较高：新查询暂时暂停，但仍会提供缓存的结果。请稍后重试。

每条 message 都是可直接转发给用户的一句话说明。

可选密钥

curl -s https://saveproptax.com/api/agent/register \
  -H 'Content-Type: application/json' \
  -d '{"agentName": "MyAssistant", "contactEmail": "[email protected]"}'

立即返回密钥，无需审批。将密钥作为 x-agent-key 请求头发送，可使新查询额度翻倍，并标明调用方名称。匿名使用也完全没问题；注册用于标识身份，而非授予权限。

速率限制

• 按地址缓存 24 小时。 重复查询即时返回，不产生费用，并标记为 cached: true。缓存结果永远不受速率限制。
• 每小时新查询额度。 新查询需要购买真实记录和销售数据，因此共享每小时额度池。负载较高时，新查询会返回 busy，缓存结果仍会照常提供。处理流程绝不会退化为更廉价的估值方法，只会延迟。
• 申请准备限制。 需要真实查询返回的令牌，并且每个房主收件箱每天最多可发送 3 个签署链接。

覆盖范围

Alameda、Contra Costa、Los Angeles、Marin、Napa、Placer、Riverside、Sacramento、 San Benito、San Bernardino、San Francisco、San Joaquin、San Mateo、Santa Clara、 Santa Cruz、Solano、Sutter 和 Yolo 县。各县的申报窗口按季节开放； 当前截止日期见 https://saveproptax.com/counties.html。

更多信息

• 完整参考资料：https://saveproptax.com/agents
• OpenAPI：https://saveproptax.com/openapi.json
• llms.txt：https://saveproptax.com/llms.txt
• 注册表元数据：server.json
• 合作与大宗业务安排：[email protected]

SavePropTax 根据公共记录和县政府自己的表格准备复核申请；业主负责审核并签署。 我们不是律师事务所，本文内容不构成法律或税务建议。是否减税完全由县评估官决定。

许可证

MIT。请参阅 LICENSE。该许可证适用于本仓库的内容； 托管服务受 https://saveproptax.com/legal.html 上的条款约束。

在本地运行（stdio）

托管服务无需安装。对于仅支持 stdio 的 MCP 客户端，本仓库提供了一个 无依赖桥接程序（Node 18+）：

{
  "mcpServers": {
    "saveproptax": {
      "command": "node",
      "args": ["bridge.js"]
    }
  }
}

也可以使用 Docker：docker build -t saveproptax-mcp . && docker run -i saveproptax-mcp。 信息查询请求由本地处理；工具调用则转发至 saveproptax.com/mcp。