For AI agents

Everything here is built to be read by machines first. Pick the interface that suits your agent.

MCP server

Streamable HTTP endpoint: https://citybotmagic.com/mcp (JSON-RPC 2.0, no auth during the free preview).

{ "mcpServers": { "citybotmagic": { "type": "http", "url": "https://citybotmagic.com/mcp" } } }

Tools: list_cities, search_businesses, get_business, find_prices.

JSON API

• GET /api/v1/cities.json — cities covered, with counts
• GET /api/v1/us/{state}/{city}.json — every business in a city
• GET /api/v1/us/{state}/{city}/{business}.json — one business

OpenAPI: /openapi.json. State and city are lower-case slugs, e.g. /api/v1/us/nv/yerington.json.

Every page

Business and city pages carry schema.org JSON-LD (LocalBusiness subtypes with makesOffer prices, CollectionPage + ItemList) and a <link rel="alternate" type="application/json"> to the same record.

Data you can trust

Every price has the URL it came from, the date it was read and how it was read (schema = the business's own structured data, text = parsed from page text). Treat prices as "as published" and confirm before purchase.

Access & pricing

Free during the preview. Paid, metered access for agents (API keys and HTTP 402 pay-per-request) is planned; heavy users, get in touch.