# MPP Public Records Gateway

Paid public-records lookups for business entities and UCC filings, property parcels, and recorder/deed documents.

Two ways in, and which one to use depends on the jurisdiction: instant for indexed jurisdictions, job endpoint for full coverage with results within minutes.

## Instant routes (answer in one request, from three indexes)
/entity/search - Search business entities by state, name, or entity identifier. Indexed: IA, FL, AK, MS.
/entity/ucc - Search Florida UCC lien filings by debtor name. Indexed: FL.
/parcel/search - Resolve one parcel by address or parcel identifier. Indexed: FL, NC, NY, IN.
/parcel/owner - Full-text search for parcels by owner name. Indexed: FL, NC, NY, IN.
/deed/search - Search recorder and deed documents by party name. Indexed: WV.

## Job routes (full coverage, results within minutes)
POST /entity/jobs - Start a full-coverage business entity lookup. Free.
POST /parcel/jobs - Start a full-coverage property records lookup. Free.
POST /deed/jobs - Start a full-coverage deed records lookup. Free.
GET /jobs/{job_id} - Check a job. Free. Reports record_count once it succeeds.
GET /jobs/{job_id}/result - Collect the records. This is the only paid step.

Send X-Client-Id on submit to get your own concurrency allowance. Jobs expire; collect before then.

## Paying
Payment uses MPP over HTTP 402. Two rails are advertised, each as its own WWW-Authenticate header:
- stablecoin (USDC on Tempo) - the primary rail. Pays any quote, including the $0.01 floor.
- card (Stripe Shared Payment Token) - offered only on quotes of $0.50 or more, because cards carry a $0.50 minimum.

Most quotes here are cents, so an agent that can only pay by card will not be able to pay for most calls. Pricing is per-record, and the runtime 402 challenge is the authoritative quote; discovery pricing is advisory. Records are fetched before payment settles, and runs that fail or find nothing are never charged.

OpenAPI discovery: /openapi.json