Safe Biter MCP connector

Safe Bite serves official restaurant health inspection records for six U.S. cities. The public website is safebiter.com. This page documents the Model Context Protocol (MCP) server only.

Endpoint: https://www.safebiter.com/mcp
Transport: Streamable HTTP (POST JSON-RPC 2.0)
Authentication: None required
Privacy: /privacy

Connect

1. In Claude, Cursor, or MCP Inspector, add a remote MCP server with URL https://www.safebiter.com/mcp.
2. Use POST with Accept: application/json, text/event-stream (hosts that render MCP Apps need the event stream).
3. Call tools/list, then tools/call with the tool names below.

Hosts that support MCP Apps render an inline restaurant card or map. The card lists violation types only; do not quote inspector narratives, temperatures, or long comment text from raw records.

Supported cities

Tool arguments use lowercase slugs: chicago, nyc, minneapolis, milwaukee, austin, denver, or all where noted.

Data refresh

Production data is stored in PostgreSQL and refreshed from the city sources above.

• Schedule: GitHub Actions runs daily at 08:00 UTC (refresh-safe-bite.yml), updating each city with up to 10,000 new rows per run, then redeploying the app.
• Denver: Pulled from Accela ePermits; updates are rate-limited on the city side, so Denver may lag other cities slightly.
• Milwaukee: Combined Health Department / HealthSpace sources; occasional session or scrape retries are normal.
• Latency: A city may publish inspections days or weeks before they appear in open data; Safe Biter cannot see records the city has not published.

Tools

Every tool below returns an MCP App result (restaurant card or map) when the host supports UI resources. Tool metadata lives in tools/list; this section is the human-readable reference.

show_inspection

Primary tool for natural-language questions. Pass a restaurant name for a card, or a violation keyword plus city for a map (for example pest inspections in Milwaukee). Parameters: query, violation, city (required for violation maps), view (auto, card, map), limit (1–12).

search_restaurants

Fuzzy name search. Parameters: query (required), optional city (all or a slug), limit (1–50), threshold (0–1 match strictness), history_n recent inspections per match (1–20).

find_nearby_restaurants

Restaurants within a radius of a point or address. Provide latitude and longitude, or address (geocoded when coordinates are omitted). Optional radius_miles (default 0.25), city, limit (1–100), history_n.

get_city_inspections

Worst recent inspections in one city, ranked for the MCP App card. Parameters: city (required), limit (1–500, use 500 for a wide window), offset for paging (see Pagination).

get_milwaukee_inspections

Same as get_city_inspections but fixed to Milwaukee. Parameters: limit, offset.

MCP resources (JSON pagination)

Besides tools, the server exposes read-only resources such as safe-bite://chicago/inspections (and the same pattern for each city slug), plus safe-bite://all/violations for cross-city violation summaries. Use resources/read with optional query parameters on the URI:

• safe-bite://{city}/inspections?offset=0&limit=500

The JSON body includes a pagination object:

• total_count — rows available for that city in the database
• offset / limit — echo of the request
• has_more — whether another page exists
• next_offset — pass as offset on the next URI (or null when done)

When has_more is true, the response may include a second content item whose URI is the next page. Default limit is 500; maximum is 500.

Tool pagination vs resources

• Resources return raw inspection JSON and explicit next_offset metadata — best for agents that paginate programmatically.
• get_city_inspections / get_milwaukee_inspections accept offset and limit, but responses are severity-ranked MCP App cards, not paginated JSON. For “worst places in Chicago,” one call with limit=500 is usually enough; use resources if you need every row.
• Search and nearby tools are not paginated; raise limit or narrow city / radius instead.

Example prompts

• How did Auntie Anne's do in Milwaukee?
• Show pest violations in Milwaukee on a map.
• Find restaurants near 1060 W Addison St, Chicago.
• What are the worst recent inspections in Denver?

Troubleshooting

Results are official public records repackaged for reading. They are not a health inspection Safe Biter performed, and they are not advice about whether to eat somewhere.

Questions: vangilder.andrew@gmail.com.