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.
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 ENOENTorspawn uv ENOENT, Claude Desktop can't find the executable. Use the full path instead (runwhich uvxorwhich uvto 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
- uk-charities-mcp — Query the Charity Commission register
Data Source
FSA Food Hygiene Rating Scheme API — free, public, no authentication required.
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d181e21e7cb1dbe5a5f2afaf99f790c5264398c915a816d780c39d7ba7bafb9e
|
|
| MD5 |
55c022c39cf9dc239ca631cea8016ba8
|
|
| BLAKE2b-256 |
c062eac748e34ee1afbc16b8fc3a71404473eceef5c5ea2b62ac0d9ea38dc166
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9a5798216de3d11a25e370e1969f26a7fbe962219b75b0509df5489bcfa88af2
|
|
| MD5 |
10e0ce8ad7398e64a3b27931b4a2a931
|
|
| BLAKE2b-256 |
9b655d85f68b852138bc39d5d55e85a3aa3fc45ea55c0e94c30731ddb1c600f0
|