City data pack and public records API for developers and AI agents
Every official source that covers one place, plus a year of records whose licence allows reuse, as JSON or CSV. 3,477 places in the library. Or pay per call: credits at one cent, or USDC with x402 and no account.
What you get
Publisher, original URL, API endpoint, format, update rate, licence and whether we opened and checked it.
Permits, code cases, alerts, quakes, fires and more, from feeds whose licence allows reuse.
Each record carries its publisher's credit line, licence and source URL.
What it costs
| What | Price | Per |
|---|---|---|
| City data pack | $29 | place, JSON or CSV |
| Records past 30 days | 1 credit (1¢) | query |
| More than 100 rows | 1 credit (1¢) | 100 rows past the first 100 |
| Calls past your plan's allowance | 1 credit (1¢) | call |
| Credit packs | $10 / $79 | 1,000 / 10,000 credits |
| Plans | $9 / $49 / $199 | month |
How to connect
https://api.sos.city/mcp
curl https://api.sos.city/v1/store/packs/us-ca-los-angeles \ -H "Authorization: Bearer <key>"
Call a paid URL, answer the 402 with a signed USDC payment on Base, get the data. The payment settles only after the data is ready.
Rules
- Cite the publisher. Show the publisher and the original link with every result.
- Only reusable records are copied. Link-only sources come with their link, not their rows.
- Places, not people. Not a consumer reporting agency: never for tenant, employment, credit or insurance screening, or to locate or profile anyone.
What to do next
Questions people ask
What is a city data pack?
Every source in the SOS.city library that covers one place, with its publisher, links, licence and check status, plus up to a year of records from feeds whose licence allows reuse, as JSON or CSV. $29 per place.
How does an AI agent pay?
Two ways. With x402 it pays per call in USDC on Base, with no account or key. With credits, the agent asks for a checkout link with the buy tool, a person pays once on Stripe, and the agent spends from the key.
What's free?
The library, places, departments, the gap board, requests, city risk profiles for 30 cities, and records from the last 30 days, 100 rows at a time. No key is needed for the free allowance.
Where do I connect?
MCP server at api.sos.city/mcp (Streamable HTTP), REST at api.sos.city/v1 with an OpenAPI 3.1 spec. It is listed in the official MCP Registry as io.github.Proof-Layer/sos-city.
Why are some records left out of a pack?
A pack copies records only from sources whose licence allows reuse. Sources we may only link to are listed with their link, not copied.