Skip to main content

MCP server for querying UK food hygiene ratings via the FSA API

Project description

Food Hygiene MCP Server

Query UK food hygiene ratings from Claude.

PyPI Python 3.14+ License: MIT MCP

Quick Start

Add to your Claude Desktop config:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Option 1: Via PyPI (recommended)

{
  "mcpServers": {
    "food-hygiene": {
      "command": "uvx",
      "args": ["food-hygiene-mcp"]
    }
  }
}

Option 2: From source

git clone https://github.com/w4sspr/food-hygiene-mcp.git
cd food-hygiene-mcp
uv sync
{
  "mcpServers": {
    "food-hygiene": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/food-hygiene-mcp", "food-hygiene-mcp"]
    }
  }
}

Troubleshooting: If you get spawn uvx ENOENT or spawn uv ENOENT, Claude Desktop can't find the executable. Use the full path instead (run which uvx or which uv to find it, e.g., /Users/you/.local/bin/uvx).

Restart Claude Desktop, then try:

"What's the hygiene rating for Dishoom in London?"

Example Prompts

  • "What's the hygiene rating for Dishoom in London?"
  • "Find restaurants in Manchester with at least a 4-star rating"
  • "Show me takeaways in SW1A 1AA"
  • "Get full inspection details for establishment 1662145"
  • "Find cafes within 2 miles of 51.5074, -0.1278"

Tools

search_establishments

Search for food establishments by name, location, or rating.

Parameter Type Description
name string Business name (partial match)
address string Street or area
postcode string UK postcode
latitude float Latitude for geo-search
longitude float Longitude for geo-search
radius_miles float Max distance in miles (default: 1)
business_type string "restaurant", "takeaway", "pub", "cafe", "hotel", etc.
min_rating int Minimum hygiene rating (0-5)
max_rating int Maximum hygiene rating (0-5)

get_establishment_details

Get full details for a specific establishment by FHRS ID.

Returns: rating breakdown (hygiene, structural, confidence in management), inspection date, local authority info.

Limitations

  • England, Wales, and Northern Ireland only — Scotland uses a different system
  • No aggregate statistics — can't calculate "% of 5-star restaurants" without fetching all data
  • Limited business types — ~15 common types mapped; niche categories may not work
  • Geo-search requires coordinates — city names alone won't trigger distance filtering

Roadmap

  • get_local_authority_stats — aggregate ratings by area (requires pagination through all establishments)
  • Scotland support via FHIS API
  • Cache business type mappings

Why I Built This

Built to demonstrate MCP integration with UK public sector data for my FDE application.

See Also

Data Source

FSA Food Hygiene Rating Scheme API — free, public, no authentication required.

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

food_hygiene_mcp-0.1.1.tar.gz (6.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

food_hygiene_mcp-0.1.1-py3-none-any.whl (7.2 kB view details)

Uploaded Python 3

File details

Details for the file food_hygiene_mcp-0.1.1.tar.gz.

File metadata

  • Download URL: food_hygiene_mcp-0.1.1.tar.gz
  • Upload date:
  • Size: 6.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for food_hygiene_mcp-0.1.1.tar.gz
Algorithm Hash digest
SHA256 a3e81a2f61f32150257c15372eeb3095db769ad2d8c9e80234ddef127e54a00a
MD5 845741e2e280699eaccc787b6994407d
BLAKE2b-256 bc2697787dc6f738e1e7cd2330c0d6b2db4598c8b6267423a3a99a9e964a4df6

See more details on using hashes here.

File details

Details for the file food_hygiene_mcp-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: food_hygiene_mcp-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 7.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for food_hygiene_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ae876f5f57f2869ec763e9df429d97d4ad4e87b41c285908f3375bc420a1753e
MD5 193584545e9cf704382743b0f3e97bf0
BLAKE2b-256 2c12aec8b17b40a220cf9b55cc8491380c01ff03eb15a84b84e6715589a8ccb4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page