# CityBotMagic

> Local businesses, services and prices — structured for AI agents. City-by-city coverage of US local businesses: categories, contact details, hours, services and published prices — each price with its source URL and the date it was read.

Use the MCP server or JSON API rather than scraping pages. All records carry per-source licenses.

## Interfaces
- [MCP server](https://citybotmagic.com/mcp): Streamable HTTP, tools list_cities, search_businesses, get_business, find_prices
- [Cities index](https://citybotmagic.com/api/v1/cities.json): every covered city with counts and API links
- [Search](https://citybotmagic.com/api/v1/search.json?state=nv&city=reno&q=oil+change): businesses by name, service or product
- [Prices](https://citybotmagic.com/api/v1/prices.json?state=nv&city=reno&q=haircut): published prices for an item or service
- [OpenAPI spec](https://citybotmagic.com/openapi.json)
- [Agent guide](https://citybotmagic.com/agents/)

## Cities
- [Sacramento, CA](https://citybotmagic.com/api/v1/us/ca/sacramento.json): 36,709 businesses, 0 with prices
- [San Francisco, CA](https://citybotmagic.com/api/v1/us/ca/san-francisco.json): 60,691 businesses, 0 with prices
- [Carson City, NV](https://citybotmagic.com/api/v1/us/nv/carson-city.json): 3,713 businesses, 532 with prices
- [Fallon, NV](https://citybotmagic.com/api/v1/us/nv/fallon.json): 956 businesses, 85 with prices
- [Las Vegas, NV](https://citybotmagic.com/api/v1/us/nv/las-vegas.json): 74,919 businesses, 0 with prices
- [Reno, NV](https://citybotmagic.com/api/v1/us/nv/reno.json): 17,908 businesses, 0 with prices
- [Sparks, NV](https://citybotmagic.com/api/v1/us/nv/sparks.json): 4,731 businesses, 79 with prices
- [Yerington, NV](https://citybotmagic.com/api/v1/us/nv/yerington.json): 288 businesses, 18 with prices

## Notes
- City JSON is paginated (`page`, `per_page` up to 500, `group`); each business has a full record at its `api` URL.
- Prices are "as published" by the business on the date shown (field `seen`); confirm before purchase.
- `method: "schema"` = from the business's own structured data; `"llm"` = read by Claude and verified against the quoted page text (`quote`); `"text"` = pattern-matched from page text.
- Data sources and licenses: https://citybotmagic.com/data-sources/