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.0.tar.gz (6.1 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.0-py3-none-any.whl (6.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: food_hygiene_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 6.1 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.0.tar.gz
Algorithm Hash digest
SHA256 d181e21e7cb1dbe5a5f2afaf99f790c5264398c915a816d780c39d7ba7bafb9e
MD5 55c022c39cf9dc239ca631cea8016ba8
BLAKE2b-256 c062eac748e34ee1afbc16b8fc3a71404473eceef5c5ea2b62ac0d9ea38dc166

See more details on using hashes here.

File details

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

File metadata

  • Download URL: food_hygiene_mcp-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 6.9 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9a5798216de3d11a25e370e1969f26a7fbe962219b75b0509df5489bcfa88af2
MD5 10e0ce8ad7398e64a3b27931b4a2a931
BLAKE2b-256 9b655d85f68b852138bc39d5d55e85a3aa3fc45ea55c0e94c30731ddb1c600f0

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