# x402-mcp storefront

> Pay-per-call HTTP APIs over x402: USDC on Base, no API key, no signup.
> A 402 response IS the price quote — read the PAYMENT-REQUIRED header,
> sign an EIP-3009 USDC transfer authorization, retry with
> PAYMENT-SIGNATURE. Settlement is gasless for the buyer.

## Paid endpoints

### Base tx decision — $0.01 USDC per call
`GET https://x402-mcp.onrender.com/base/tx-decision`

Submit this Base tx now or wait, max fee + priority fee (EIP-1559 gwei), estimated USD cost. Call before every send.
- `gas`: eth|usdc|erc20|x402 or integer gas units (default usdc)
- `urgency`: now|soon|flexible (default flexible)

### Base Network Pulse (free preview) — free
`GET https://x402-mcp.onrender.com/pulse`

Full market briefing: fees, congestion, trend, settlement costs, settle-now-or-wait verdict. The paid composite listing of the same intelligence is under /swarm/products.

### Minneapolis rental compliance (free sample) — free
`GET https://x402-mcp.onrender.com/mn/property-check/sample`

Free fixed-address sample of the paid MN join: live compliance_verdict + license / violation / condemned fields for 1700 Penn Ave N. Any other address requires payment at https://x402-mcp.onrender.com/mn/property-check.

### Minneapolis rental compliance — $0.01 USDC per call
`GET https://x402-mcp.onrender.com/mn/property-check`

One-call compliance_verdict (licensed_clean | licensed_with_violations | unlicensed | condemned_or_boarded) plus rental license status, violation history, and condemned/boarded flag for a Minneapolis street address, from city open data. Free sample (fixed address): https://x402-mcp.onrender.com/mn/property-check/sample.
- `address`: street address string, 1-120 chars (required)

### US City Open-Data Compliance Network (catalog) — free
`GET https://x402-mcp.onrender.com/us/cities`

Free machine catalog of multi-city property compliance endpoints (14 jurisdictions: mn, sea, nyc, chi, den, sf, lax, bos, phi, orl, nola, moco, gain, kc): paid URLs, sample URLs, price, and open-data sources.

### Minneapolis compliance (free sample) — free
`GET https://x402-mcp.onrender.com/us/mn/property-check/sample`

Free fixed-address sample for Minneapolis, MN. Sample address: 1700 Penn Ave N. Paid: https://x402-mcp.onrender.com/us/mn/property-check.

### MN Rental Compliance — $0.01 USDC per call
`GET https://x402-mcp.onrender.com/us/mn/property-check`

City of Minneapolis Open Data — rental licenses, violations, condemned/boarded. $0.01-class USDC on Base. Free sample: https://x402-mcp.onrender.com/us/mn/property-check/sample. Catalog: https://x402-mcp.onrender.com/us/cities.
- `address`: street address string, 1-120 chars (required)

### Seattle compliance (free sample) — free
`GET https://x402-mcp.onrender.com/us/sea/property-check/sample`

Free fixed-address sample for Seattle, WA. Sample address: 1531 BELMONT AVE. Paid: https://x402-mcp.onrender.com/us/sea/property-check.

### Seattle Rental Compliance — $0.01 USDC per call
`GET https://x402-mcp.onrender.com/us/sea/property-check`

City of Seattle Open Data — Rental Property Registration. $0.01-class USDC on Base. Free sample: https://x402-mcp.onrender.com/us/sea/property-check/sample. Catalog: https://x402-mcp.onrender.com/us/cities.
- `address`: street address string, 1-120 chars (required)

### New York City compliance (free sample) — free
`GET https://x402-mcp.onrender.com/us/nyc/property-check/sample`

Free fixed-address sample for New York City, NY. Sample address: 787 EAST 56 STREET BROOKLYN. Paid: https://x402-mcp.onrender.com/us/nyc/property-check.

### NYC HPD Rental Compliance — $0.01 USDC per call
`GET https://x402-mcp.onrender.com/us/nyc/property-check`

NYC Open Data — HPD Multiple Dwelling Registrations + HMC Violations. $0.01-class USDC on Base. Free sample: https://x402-mcp.onrender.com/us/nyc/property-check/sample. Catalog: https://x402-mcp.onrender.com/us/cities.
- `address`: street address string, 1-120 chars (required)

### Chicago compliance (free sample) — free
`GET https://x402-mcp.onrender.com/us/chi/property-check/sample`

Free fixed-address sample for Chicago, IL. Sample address: 7840 S WESTERN AVE. Paid: https://x402-mcp.onrender.com/us/chi/property-check.

### Chicago Building Violations — $0.01 USDC per call
`GET https://x402-mcp.onrender.com/us/chi/property-check`

City of Chicago Open Data — Building Violations. $0.01-class USDC on Base. Free sample: https://x402-mcp.onrender.com/us/chi/property-check/sample. Catalog: https://x402-mcp.onrender.com/us/cities.
- `address`: street address string, 1-120 chars (required)

### Denver compliance (free sample) — free
`GET https://x402-mcp.onrender.com/us/den/property-check/sample`

Free fixed-address sample for Denver, CO. Sample address: 1945 S GILPIN ST. Paid: https://x402-mcp.onrender.com/us/den/property-check.

### Denver STR License Check — $0.01 USDC per call
`GET https://x402-mcp.onrender.com/us/den/property-check`

Colorado Information Marketplace — Denver Short Term Rental Licenses. $0.01-class USDC on Base. Free sample: https://x402-mcp.onrender.com/us/den/property-check/sample. Catalog: https://x402-mcp.onrender.com/us/cities.
- `address`: street address string, 1-120 chars (required)

### San Francisco compliance (free sample) — free
`GET https://x402-mcp.onrender.com/us/sf/property-check/sample`

Free fixed-address sample for San Francisco, CA. Sample address: 2329 Mission St. Paid: https://x402-mcp.onrender.com/us/sf/property-check.

### SF Housing NOV Check — $0.01 USDC per call
`GET https://x402-mcp.onrender.com/us/sf/property-check`

SF Open Data — DBI Notices of Violation. $0.01-class USDC on Base. Free sample: https://x402-mcp.onrender.com/us/sf/property-check/sample. Catalog: https://x402-mcp.onrender.com/us/cities.
- `address`: street address string, 1-120 chars (required)

### Los Angeles compliance (free sample) — free
`GET https://x402-mcp.onrender.com/us/lax/property-check/sample`

Free fixed-address sample for Los Angeles, CA. Sample address: 1015 S LA BREA AVE. Paid: https://x402-mcp.onrender.com/us/lax/property-check.

### LA Code Enforcement Open — $0.01 USDC per call
`GET https://x402-mcp.onrender.com/us/lax/property-check`

LA Open Data — Building & Safety Code Enforcement (Open). $0.01-class USDC on Base. Free sample: https://x402-mcp.onrender.com/us/lax/property-check/sample. Catalog: https://x402-mcp.onrender.com/us/cities.
- `address`: street address string, 1-120 chars (required)

### Boston compliance (free sample) — free
`GET https://x402-mcp.onrender.com/us/bos/property-check/sample`

Free fixed-address sample for Boston, MA. Sample address: 302 Sumner ST East Boston. Paid: https://x402-mcp.onrender.com/us/bos/property-check.

### Boston Property Violations — $0.01 USDC per call
`GET https://x402-mcp.onrender.com/us/bos/property-check`

Analyze Boston — Building and Property Violations. $0.01-class USDC on Base. Free sample: https://x402-mcp.onrender.com/us/bos/property-check/sample. Catalog: https://x402-mcp.onrender.com/us/cities.
- `address`: street address string, 1-120 chars (required)

### Philadelphia compliance (free sample) — free
`GET https://x402-mcp.onrender.com/us/phi/property-check/sample`

Free fixed-address sample for Philadelphia, PA. Sample address: 1234 N LEITHGOW ST. Paid: https://x402-mcp.onrender.com/us/phi/property-check.

### Philly L&I Violations — $0.01 USDC per call
`GET https://x402-mcp.onrender.com/us/phi/property-check`

OpenDataPhilly / Carto — L&I violations. $0.01-class USDC on Base. Free sample: https://x402-mcp.onrender.com/us/phi/property-check/sample. Catalog: https://x402-mcp.onrender.com/us/cities.
- `address`: street address string, 1-120 chars (required)

### Orlando compliance (free sample) — free
`GET https://x402-mcp.onrender.com/us/orl/property-check/sample`

Free fixed-address sample for Orlando, FL. Sample address: 114 N GLENWOOD AVE. Paid: https://x402-mcp.onrender.com/us/orl/property-check.

### Orlando STR License Check — $0.01 USDC per call
`GET https://x402-mcp.onrender.com/us/orl/property-check`

City of Orlando Open Data — Short Term Rental Licenses. $0.01-class USDC on Base. Free sample: https://x402-mcp.onrender.com/us/orl/property-check/sample. Catalog: https://x402-mcp.onrender.com/us/cities.
- `address`: street address string, 1-120 chars (required)

### New Orleans compliance (free sample) — free
`GET https://x402-mcp.onrender.com/us/nola/property-check/sample`

Free fixed-address sample for New Orleans, LA. Sample address: 179 Dunleith Dr. Paid: https://x402-mcp.onrender.com/us/nola/property-check.

### NOLA STR License Check — $0.01 USDC per call
`GET https://x402-mcp.onrender.com/us/nola/property-check`

City of New Orleans Open Data — Active Short-Term Rental Licenses. $0.01-class USDC on Base. Free sample: https://x402-mcp.onrender.com/us/nola/property-check/sample. Catalog: https://x402-mcp.onrender.com/us/cities.
- `address`: street address string, 1-120 chars (required)

### Montgomery County compliance (free sample) — free
`GET https://x402-mcp.onrender.com/us/moco/property-check/sample`

Free fixed-address sample for Montgomery County, MD. Sample address: 19515 FREDERICK RD. Paid: https://x402-mcp.onrender.com/us/moco/property-check.

### MoCo Housing License Check — $0.01 USDC per call
`GET https://x402-mcp.onrender.com/us/moco/property-check`

Montgomery County Open Data — Housing Licensing + Active Code Violations. $0.01-class USDC on Base. Free sample: https://x402-mcp.onrender.com/us/moco/property-check/sample. Catalog: https://x402-mcp.onrender.com/us/cities.
- `address`: street address string, 1-120 chars (required)

### Gainesville compliance (free sample) — free
`GET https://x402-mcp.onrender.com/us/gain/property-check/sample`

Free fixed-address sample for Gainesville, FL. Sample address: 0 W 1ST ST. Paid: https://x402-mcp.onrender.com/us/gain/property-check.

### Gainesville Code Cases — $0.01 USDC per call
`GET https://x402-mcp.onrender.com/us/gain/property-check`

City of Gainesville Open Data — Code Complaints, Violations & Permits. $0.01-class USDC on Base. Free sample: https://x402-mcp.onrender.com/us/gain/property-check/sample. Catalog: https://x402-mcp.onrender.com/us/cities.
- `address`: street address string, 1-120 chars (required)

### Kansas City compliance (free sample) — free
`GET https://x402-mcp.onrender.com/us/kc/property-check/sample`

Free fixed-address sample for Kansas City, MO. Sample address: 12100 E 61st Ter. Paid: https://x402-mcp.onrender.com/us/kc/property-check.

### KC Exterior Building Violations — $0.01 USDC per call
`GET https://x402-mcp.onrender.com/us/kc/property-check`

City of Kansas City Open Data — Open exterior building violations. $0.01-class USDC on Base. Free sample: https://x402-mcp.onrender.com/us/kc/property-check/sample. Catalog: https://x402-mcp.onrender.com/us/cities.
- `address`: street address string, 1-120 chars (required)

### Base transaction finality check — $0.01 USDC per call
`GET https://x402-mcp.onrender.com/base/finality-check`

Classify a Base mainnet tx hash as not_found, pending, unsafe (sequencer-confirmed only), safe (L1-attested), or finalized (L1-finalized) -- read from the node's own safe/finalized block tags, not a modeled probability. Call after submitting a tx, when tx-decision answers the question before.
- `tx`: 0x-prefixed 32-byte transaction hash (required)

## What can go wrong (read this before integrating)

- **Facilitator 502 mid-settle**: the CDP facilitator throws transient
  502s. No funds move on that path and nothing is delivered — retry the
  same request. Do not reconcile; there is nothing to reconcile.
- **402 with `payment_invalid`**: your signature was malformed, expired
  (300s validity window), or bound to a stale challenge. Re-fetch the
  402 and sign the fresh PAYMENT-REQUIRED value.
- **422 before any payment logic**: you omitted or malformed a required
  query parameter. Nothing was charged.
- **Data staleness**: tx-decision responses are computed from a Base RPC
  snapshot at most ~4s old and carry `as_of_block` / `as_of` so you can
  judge freshness yourself. Base blocks land every ~2s; treat any answer
  older than a few blocks as history, not advice.
- **Delivery is settled-gated**: content is served only after on-chain
  settlement succeeds, so a verified-but-unsettled payment gets a 402,
  not the product.
- **finality-check is gated by the x402 SDK's own middleware, not this
  repo's hand-rolled path**: a malformed `tx` still returns 402 (not
  422) if unpaid, since payment gating runs before query validation;
  paid-but-malformed still safely fails closed (no settlement) but as a
  422 after verification, not before it. Its revenue is mirrored into
  this repo's ledger/dashboard on the same terms as every other product
  -- recorded only after settlement actually succeeds.

## Machine surfaces

- x402 manifest: https://x402-mcp.onrender.com/.well-known/x402
- MCP manifest:  https://x402-mcp.onrender.com/.well-known/mcp (16 tools, Streamable HTTP at /mcp/mcp)
- Health: https://x402-mcp.onrender.com/health · Checks: https://x402-mcp.onrender.com/doctor · Ops: https://x402-mcp.onrender.com/dashboard

## Operator

- Repository: https://github.com/kwizzlesurp10-ctrl/x402-mcp
- Seller-only deployment: this host holds no spend key (verify:
  https://x402-mcp.onrender.com/health shows wallet_configured:false).