{"$schema":"https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json","version":"1.0","protocolVersion":"2025-06-18","serverInfo":{"name":"city.sos/library","title":"SOS.city public record","version":"1.5.0"},"description":"The public record for every place, organised: sources for power, water, emergencies, police, fire and EMS, laws, permits and funding, each linked to the publisher's original; natural-hazard risk profiles for the 30 largest U.S. cities (FEMA National Risk Index, disaster declarations, official alert sign-ups); plus records feeds and a data store for agents.","iconUrl":"https://sos.city/icon-512.png","documentationUrl":"https://sos.city/connect","transport":{"type":"streamable-http","endpoint":"https://api.sos.city/mcp"},"capabilities":{"tools":{"listChanged":false}},"authentication":{"required":false,"schemes":["bearer"],"note":"Optional API key (sos_live_…) for higher limits and paid tools."},"instructions":"SOS.city indexes public records by place, shelf (department) and publisher. Start with search_library; pass a place id to include everything that covers it. Always show the publisher and link to the original when you use a result; the original wins if it differs. If nothing fits, check list_gaps, then offer request_record. Some data is paid (full history, bulk records, city data packs): get_store lists prices; buy returns a checkout link for the person who pays. For natural-hazard risk in one of the 30 largest U.S. cities (FEMA National Risk Index by county, disaster declarations, official alert sign-up), use get_city_risk (free). For buildings and facilities that owe a required inspection, filing or fix (SB 721 balconies, LA energy benchmarking, code cases, retrofits, industrial stormwater), use list_compliance, then get_compliance_items (first 10 rows free); get_compliance_changes says what was added, taken off or changed since a day, and watch_compliance sets up a daily or weekly alert (email or signed webhook) with tracked items that close on their own. Never use these tools to locate, profile or screen a person (tenant, employment, credit or insurance decisions): SOS.city is not a consumer reporting agency. Not an emergency service: in an emergency, call 911.","tools":[{"name":"search_library","title":"Search the public record","description":"Find public-records sources (datasets, portals, registers, reports) by question or keywords. Use `place` to include everything covering a place, from the city up to federal and global sources. Returns the publisher, how to get the data (API endpoint or page), update rate, last update, licence and whether we verified it. Not for finding, profiling or screening people.","annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"get_source","title":"Get one source","description":"Full details of one source by id: publisher, original link, API endpoint, formats, update rate, last update, licence, location detail, check status and notes.","annotations":{"readOnlyHint":true}},{"name":"list_places","title":"List places","description":"The atlas: world, countries, states, counties and cities, with their ids. Filter by parent id (e.g. 'us' for US states) or kind.","annotations":{"readOnlyHint":true}},{"name":"list_departments","title":"List shelves","description":"The 15 departments (shelves) every source sits on, with what each covers.","annotations":{"readOnlyHint":true}},{"name":"list_gaps","title":"What's missing","description":"Records people need that the library doesn't hold yet, or that no agency publishes. Check this before telling a user a record doesn't exist.","annotations":{"readOnlyHint":true}},{"name":"search_records","title":"Search the records themselves","description":"The records SOS.city reads from agencies' open data, one row each: building permits, code-enforcement cases, inspections, certificates of occupancy, new business registrations, grants, weather alerts, earthquakes, US wildfires (NIFC), SCE power shutoffs, satellite fire detections (NASA FIRMS), bank branch openings, closings and mergers (FDIC), current drug shortages (openFDA) and county night-light drops that estimate power outages (NASA Black Marble). Filter by place, kind, ZIP or street address. Each row links to the agency's original. History depends on the plan (Free: 30 days, 100 rows). full_history=true (1 credit) and limit over 100 (1 credit per extra 100 rows, up to 1,000) are paid from the API key's credits; see get_store.","annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"request_record","title":"Request a record","description":"Ask SOS.city to find a public record that isn't in the library. It joins the gap board; give an email to hear back. Never for locating or profiling a person.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"get_store","title":"See prices and how to pay","description":"The SOS.city data store: what's free, what costs credits (1 credit = 1 cent), credit packs, city data packs, building records and deep searches, and every way to pay (credits with an API key, x402 USDC, or a Stripe link for a person). Shows the caller's credit balance when an API key is sent.","annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"buy","title":"Buy credits or a city data pack","description":"Starts a one-time purchase and returns a Stripe Checkout link for the person who pays, plus a status_url to poll. product: credits_1k ($10), credits_10k ($79), city_pack ($29, needs place) or compliance_list ($99, one whole compliance list as CSV, needs list). The person must agree to the data-use terms (no screening or profiling people): pass agree_data_use=true only after they have.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"get_city_pack","title":"Get a city data pack","description":"Every source that covers one place (with publisher, original link, licence and reuse terms) plus a year of records whose sources allow reuse. Costs 2900 credits from the API key's balance. Without credits, use buy (product city_pack) or the REST URL with x402.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"check_compliance","title":"Is this address on a compliance list?","description":"Checks one street address against every compliance list at once (SB 721 balcony citations, LA energy benchmarking, open code cases, soft-story and concrete retrofit orders, industrial stormwater permits) and says which lists name it, with the agency's status, dates and a link to its own record. Free. Covers buildings in the City of Los Angeles. Give the ZIP: without it, the same number and street name in another ZIP can match. Not on a list means the agency's data does not name the address today, not that the building has met the law. About buildings, never people.","annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"list_compliance","title":"Compliance lists: who owes an inspection, filing or fix","description":"Buildings and facilities that owe a legally required inspection, filing or fix (SB 721 balcony inspections, LA energy benchmarking, open code cases, soft-story and concrete retrofits, industrial stormwater permits), read from the agency's dataset and refreshed daily. Free: what each law requires, who may sign, how many are on each list, by ZIP and status. For the firms that do this work. Not for finding or profiling people.","annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"get_compliance_items","title":"Get rows of a compliance list","description":"Rows of one compliance list (address, ZIP, dates, status, the agency's id, a link to the original, and other lists the same address is on). The first 10 rows are free; more cost credits per 100 rows (see get_store). Filter by zip, address (q), status, type, since (YYYY-MM-DD) or stacked=true (addresses on more than one list).","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_compliance_changes","title":"What changed on a compliance list","description":"Buildings and facilities added to, taken off, or changed on a compliance list since a day (default the last 7 days), from the agency's own data. Counts are free; the first 10 rows are free, then credits per 100 rows. Off the list means the agency's data no longer lists the item, not proof the work was done.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"watch_compliance","title":"Set up a compliance alert","description":"Save a watch on one compliance list (ZIPs, status, type, stacked) and get what changed daily or weekly by email and/or a signed webhook. Pass track (item keys) to follow items one by one: each closes on its own when the agency's data no longer lists it. Needs an API key. Rows past the first 10 in each delivery cost credits per 100.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"list_compliance_watches","title":"List my compliance alerts","description":"The account's compliance watches: what each covers, how it's delivered, when it last went out and what it did, and its tracked items open and closed.","annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"get_bank_access","title":"Bank access for a ZIP, county or state","description":"Free. How many bank and credit union branches a ZIP, county or state has today, how far the nearest bank branch is, closings and openings in the last 120 days, ZIPs left with one bank or none, and the top lenders already there. From FDIC BankFind, the NCUA call report and Census files, rebuilt daily. Give zip, county (5-digit FIPS), place (a county or state place id) or state; none gives the US.","annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"list_bank_gaps","title":"ZIPs that just lost their bank","description":"ZIPs where a branch closing left no bank, one bank, or a 10+ mile trip to the next branch, with the bank that left and the nearest one still open. Free: the last 30 days, 25 rows. full=true returns the whole 120-day window (100 credits from the API key, or free with a watch for that state).","annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"find_lenders","title":"Who can serve a county","description":"Every bank and credit union with a branch in one county, with branch counts and assets. 25 credits from the API key (free with a watch for that state). Organizations only.","annotations":{"readOnlyHint":true,"openWorldHint":false}},{"name":"order_bank_report","title":"Buy a bank watch or report","description":"Start a checkout for a Bank desert watch (state, regional, national, closing soon, branch sites) or a one-time report (market brief, acquisition screen, merger impact). Returns a Stripe link for the person who pays. See get_store for prices.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},{"name":"get_city_risk","title":"Natural-hazard risk for a U.S. city","description":"Free. FEMA National Risk Index for the county of one of the 30 largest U.S. cities: overall rating and score, every hazard's share of the risk, rating, score and expected annual loss, plus (for verified cities) the federal disaster declarations and the official emergency alert sign-up. Omit city for the list. Every result names its source; FEMA rates counties, not cities.","annotations":{"readOnlyHint":true,"openWorldHint":false}}],"terms":"https://sos.city/legal/data-use","privacy":"https://sos.city/legal/privacy"}