AI Agents or Partners

An open, keyless API and MCP server for checking whether a California home qualifies for a Proposition 8 decline-in-value property tax reduction, and for starting a filing the owner completes themselves. The check is free, runs the exact pipeline our website runs, and can only ever lower a tax bill, never raise it. Filing is a flat $29, paid by the owner.

The flow

  1. check an address (free, keyless) → status qualifies with a continueToken
  2. prepare with the token and the owner's name, phone, and email → we build the county's own form and email the signing link to the owner
  3. the owner signs the form themselves
  4. the owner pays the flat $29
  5. we file with the County Assessor and report progress until delivery
An AI agent or partner never handles the signature or the money. The signing link goes to the owner's inbox. The owner signs and the owner pays.

POST /api/agent/check

POSThttps://saveproptax.com/api/agent/check · keyless · optional x-agent-key header

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

Add "unit": "Unit 12" for multi-unit buildings. A qualifying response:

{
  "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...signed, valid 24 hours",
  "cached": false,
  "checkedAt": "2026-08-19T18:00:00.000Z"
}

estimate appears when a valuation was computed (qualifies and fair_assessment). filing appears when filing terms are relevant (qualifies and window_closed). continueToken appears only on qualifies. message is always a one-sentence explanation you can relay to your user as is.

Every status your integration must handle

statusmeaning
qualifiesComparable sales support a defensibly lower value, estimated savings exceed $500 a year, and the county's window is open. The only status that carries a continueToken.
fair_assessmentComparable sales do not support a value below the current assessment this year. Includes the estimate so the owner can see why.
not_enough_dataToo few closely matched recent sales for a defensible filing. We decline rather than file on weak evidence.
not_residentialThe parcel's county record is not residential. Our method is comparable home sales, so we only serve homes.
window_closedThe county's review window has closed for this year. filing.reopens says when it returns.
county_not_servedThe property is in a California county we do not serve yet.
already_filedA review request was already filed for this property this year. No document identifiers are returned, to anyone.
address_not_foundThe address could not be located. Retry with the city included, for example "123 Main St, Walnut Creek".
needs_more_infoMore input is needed; the message says what, for example a unit number for a multi-unit building.
busyHeavy load: fresh checks are briefly paused, cached answers still serve. Retry shortly.

POST /api/agent/prepare

POSThttps://saveproptax.com/api/agent/prepare

curl -s https://saveproptax.com/api/agent/prepare \
  -H 'Content-Type: application/json' \
  -d '{
    "continueToken": "eyJ...from a qualifying check",
    "ownerName": "Jane Homeowner",
    "ownerPhone": "925 555 0100",
    "ownerEmail": "jane@example.com"
  }'
{
  "docId": "d0c1d2...",
  "status": "awaiting_signature",
  "statusUrl": "https://saveproptax.com/api/agent/status?doc=d0c1d2...",
  "ownerEmailSent": true
}

We fill the county's own review form, attach the comparables worksheet, create the e-sign document, and email the signing link to ownerEmail. The response never contains the signing link. The owner name goes on the county form exactly as sent, so it should match title. Phone numbers need an area code. Limited to 3 prepares per owner email per day; the token must come from a check less than 24 hours old, and the window and one-filing-per-year guard are re-checked at prepare time.

Errors return { "error": "relayable message" } with 400 (bad input), 401 (bad or expired token), 409 (already filed, or the evidence refreshed and the numbers changed: run a fresh check), 422 (window closed), or 429 (owner email at its daily link limit).

GET /api/agent/status

GEThttps://saveproptax.com/api/agent/status?doc=<docId>

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

{ "status": "filed", "updatedAt": "2026-08-19T18:30:00.000Z",
  "message": "Payment is complete and the filing is on its way to the County Assessor." }

Coarse states only: awaiting_signature → awaiting_payment → filed → delivered. No personal information, no addresses, no amounts, ever. Unknown or invalid ids return { "status": "unknown" }.

POST /api/agent/register (optional)

POSThttps://saveproptax.com/api/agent/register · instant, no approval step

curl -s https://saveproptax.com/api/agent/register \
  -H 'Content-Type: application/json' \
  -d '{"agentName": "MyAssistant", "contactEmail": "dev@example.com"}'

Returns a key immediately. Send it as the x-agent-key header on check and prepare calls. A key buys double the fresh-check headroom under the hourly budget and named attribution in our funnel (useful once you want to talk partnership: your traffic has a name). Anonymous use works fine for trying it out; registration is identity, not permission.

MCP server

A remote MCP server over streamable HTTP, no auth, stateless:

https://saveproptax.com/mcp
  • Claude: Settings → Connectors → Add custom connector → paste the URL.
  • ChatGPT: Settings → Connectors (or Apps) → add an MCP server by URL, where your plan supports custom connectors.
  • Any MCP client: point a streamable-HTTP transport at the URL; no token needed.

Tools, mirroring the endpoints above:

toolarguments
check_property_tax_savingsaddress (required), unit
start_filingcontinueToken, ownerName, ownerPhone, ownerEmail (all required)
get_filing_statusdocId (required)

Same rules as the HTTP API: start_filing emails the owner and never returns the signing link in the tool result.

Rate limits and honesty

  • Per-address cache, 24 hours. Repeat checks of the same address are instant, free to us, and marked cached: true. Cached answers are never rate limited.
  • Hourly fresh-check budget. Fresh checks spend real money on records and sales data, so they share an hourly pool (registered keys get double headroom). Under heavy load fresh checks answer busy while cached answers still serve; the pipeline never degrades to a cheaper method, it only delays. The number an agent sees is the number the website shows is the number that gets filed.
  • Per-IP backstop. Generous, and deliberately secondary: major assistants egress from shared IP pools.
  • Prepare gating. Prepare requires a valid token from a real check and is limited to 3 signing links per owner inbox per day.

Coverage and terms

  • 18 pilot counties: 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. Windows are seasonal per county; see current windows and deadlines.
  • Qualifying floor: we only say qualifies when estimated savings exceed $500 a year; below that, a filing is not worth the owner's effort and we say so.
  • Flat $29, paid by the owner after signing. No percentage of savings, no subscription.
  • The check is free either way: the comparable sales we find are the owner's to use, including filing directly with their county at no charge.

For partners

Building a homeowner product, an assistant with real users, or a brokerage tool? We are open to embeds, volume arrangements, and co-branding. Write to support@saveproptax.com with what you are building; a human founder replies.

Machine-readable: openapi.json · llms.txt · api-catalog · mcp.json · MCP at /mcp
SavePropTax prepares review requests from public records and the county's own forms; owners review and sign themselves. We are not a law firm, and nothing here is legal or tax advice. Reductions are decided solely by the County Assessor.