GeraEats MCP Server

An MCP server that lets AI agents — Claude Desktop, ChatGPT with tools, Cursor, Windsurf, or any MCP client — look up UK food hygiene ratings, profile a city's food safety, and find the cleanest (or worst-rated) places to eat, fully offline.

It ships the real FSA Food Hygiene Rating dataset that powers GeraEats: 607,906 establishments across 360 UK local authorities, crawled from ratings.food.gov.uk under the Open Government Licence v3.0. England, Wales & Northern Ireland use the FHRS 0–5 star scheme; Scotland uses the FHIS Pass / Improvement-Required scheme — both are handled. No backend, no network, no auth — every answer is computed locally from on-disk data, so it is safe to run anywhere.

Contains public sector information licensed under the Open Government Licence v3.0. Ratings are a point-in-time snapshot; the live record lives at ratings.food.gov.uk.

Tools

| Tool | What it does | |------|--------------| | list_authorities | List/search the 360 UK local authorities covered, with each authority's slug, name, scheme (FHRS/FHIS) and establishment count. Use first to find the right city name. | | lookup_food_hygiene_rating | Find an establishment's hygiene rating by (partial) name within a city/authority — star rating, address, postcode, business type and last inspection date. | | get_city_hygiene_stats | Full hygiene profile for a city: total establishments, % rated, average rating, 0–5 star distribution, 5-star and 0-star shares, latest inspection date (FHIS Pass/Improvement breakdown for Scotland). | | find_top_rated_restaurants | The best- (or, order: "worst", worst-) rated real establishments in a city, optionally filtered by business type (restaurant, takeaway, cafe, pub, …). | | compare_city_hygiene | Compare 2–8 cities side by side — average rating, % 5-star, low-rated count — ranked cleanest-first. |

A typical agent flow: list_authorities → get_city_hygiene_stats for a city → find_top_rated_restaurants to pick where to eat, or lookup_food_hygiene_rating to check a specific place, or compare_city_hygiene across cities.

Install & run

# Run directly (no global install) once published to npm:
npx -y @gera-services/mcp-gera-eats

# Or from this repo:
cd packages/mcp-gera-eats
npm run extract-data   # extracts the FHRS dataset from geraeats-web (one-time)
npm run build          # tsc --noCheck + copy dataset -> dist/
node bin/cli.js        # starts on stdio
npm run smoke          # initialize + tools/list + real tools/call over stdio

Client configuration

Claude Desktop / Claude Code (claude_desktop_config.json)

{
  "mcpServers": {
    "gera-eats": {
      "command": "npx",
      "args": ["-y", "@gera-services/mcp-gera-eats"]
    }
  }
}

Local (unpublished) variant — point at the built CLI:

{
  "mcpServers": {
    "gera-eats": {
      "command": "node",
      "args": ["/absolute/path/to/Gera/packages/mcp-gera-eats/bin/cli.js"]
    }
  }
}

On macOS, claude_desktop_config.json lives at ~/Library/Application Support/Claude/claude_desktop_config.json. Restart the client after editing, then ask: "What's the food hygiene rating profile for Leeds?" or "Compare restaurant hygiene in Birmingham vs Manchester."

Data & licensing

• Source: Food Standards Agency Food Hygiene Rating Scheme (FHRS) and Food Hygiene Information Scheme (FHIS, Scotland) — https://ratings.food.gov.uk.
• Licence: Contains public sector information licensed under the Open Government Licence v3.0.
• Snapshot: the bundled dataset is a point-in-time crawl; regenerate with npm run extract-data against an updated geraeats-web dataset.

GeraEats provides this for orientation. Always confirm a current rating against the live FSA record before relying on it.

A Gera Systems product.