io.github.cyanheads/openfoodfacts-mcp-server
REMOTE · OPENFOODFACTS.CASEYJHAND.COM · 2 COMPONENTS · SCANNED SEP 21
Barcode lookup, nutrition search, and product comparison for 3M+ crowd-sourced food products.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security66
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation not fully verified: no authorisation is required to call this server, and 4 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe. See how to fix → View diagnostics → Unverified
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
- DNSSEC is configured correctly; the domain's records validate against the full chain to the root. View diagnostics → Pass
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability60
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 2299 tokens (~574/item across 4 items; 4 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 4 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 5 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
How do I install the io.github.cyanheads/openfoodfacts-mcp-server server?
io.github.cyanheads/openfoodfacts-mcp-server is a hosted endpoint at https://openfoodfacts.caseyjhand.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · openfoodfacts.caseyjhand.com
claude mcp add --transport http cyanheads-openfoodfacts-mcp-server 'https://openfoodfacts.caseyjhand.com/mcp'
{
"mcpServers": {
"cyanheads-openfoodfacts-mcp-server": {
"url": "https://openfoodfacts.caseyjhand.com/mcp"
}
}
} {
"servers": {
"cyanheads-openfoodfacts-mcp-server": {
"type": "http",
"url": "https://openfoodfacts.caseyjhand.com/mcp"
}
}
} [mcp_servers.cyanheads-openfoodfacts-mcp-server] url = "https://openfoodfacts.caseyjhand.com/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"cyanheads-openfoodfacts-mcp-server": {
"type": "remote",
"url": "https://openfoodfacts.caseyjhand.com/mcp",
"enabled": true
}
}
} openclaw mcp add cyanheads-openfoodfacts-mcp-server --url 'https://openfoodfacts.caseyjhand.com/mcp' --transport streamable-http
mcp_servers:
cyanheads-openfoodfacts-mcp-server:
url: "https://openfoodfacts.caseyjhand.com/mcp" {
"McpServers": {
"cyanheads-openfoodfacts-mcp-server": {
"Transport": "http",
"Url": "https://openfoodfacts.caseyjhand.com/mcp"
}
}
} assistant mcp add cyanheads-openfoodfacts-mcp-server -t streamable-http -u 'https://openfoodfacts.caseyjhand.com/mcp'
{
"mcpServers": {
"cyanheads-openfoodfacts-mcp-server": {
"type": "http",
"url": "https://openfoodfacts.caseyjhand.com/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 17 Sept 26 −1
- The server rewrote its instructions, which are the text every model session reads security
- Tool “off_get_product” rewrote its description, which is the text the model reads security
- Tool “off_search_products” rewrote its description, which is the text the model reads security
- Tool “off_browse_taxonomy” rewrote its description, which is the text the model reads security
- Schema quality: 474 → 574 ▼ functional
- Schema quality: 474 → 554 ▼ functional
- Server version: 0.3.3 → 0.3.4 functional
- Server version: 0.3.2 → 0.3.3 functional
- “off_search_products” added an optional parameter “nutrient_filters” cosmetic
- “off_get_product” reworded the description of “fields” cosmetic
- “off_search_products” reworded the description of “sort_by” cosmetic
- “off_search_products” reworded the description of “query” cosmetic
- “off_search_products” reworded the description of “additives_tag” cosmetic
- “off_browse_taxonomy” reworded the description of “search” cosmetic
- 9 Sept 26 0
- Stability: 0.97 → pass security
- 8 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.
- 7 Sept 26 −1
- Stability: pass → 0.93 functional
- 26 Aug 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 25 Aug 26 0
- Stability: 0.97 → pass security
- Tool “off_browse_taxonomy” rewrote its description, which is the text the model reads security
- MCP protocol: Implements a current MCP spec version (2026-07-28). functional
- MCP protocol version: 2025-11-25 → 2026-07-28 functional
- Server version: 0.3.1 → 0.3.2 functional
- “off_browse_taxonomy” reworded the description of “facet” cosmetic
- “off_search_products” reworded the description of “additives_tag” cosmetic
- “off_browse_taxonomy” reworded the description of “search” cosmetic
- “off_browse_taxonomy” reworded the description of “limit” cosmetic
- 24 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.
- 11 Aug 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 21 Sept 2026 · Probed https://openfoodfacts.caseyjhand.com/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=caseyjhand.com | CN=WE1,O=Google Trust Services,C=US | 4 Sept 2026 | 3 Dec 2026 | ECDSA 256 | ECDSA-SHA256 | a6985204ed51ae050e7738aa6be668e9 |
| SANs: caseyjhand.com, *.caseyjhand.com | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
Background: What to check on a remote MCP endpoint →
DNSSEC secure
Validation of openfoodfacts.caseyjhand.com. — Secure
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| com. | present | 19718 | 13 | Verified |
| caseyjhand.com. | present | 2371 | 13 | Verified |
| openfoodfacts.caseyjhand.com. | Verified address RRset verified with the apex keys |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
| Header | Value |
|---|---|
| strict-transport-security | max-age=63072000; includeSubDomains; preload |
| x-content-type-options | nosniff |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://openfoodfacts.caseyjhand.com/mcp | Verified | 200 | |
| http (plaintext) | http://openfoodfacts.caseyjhand.com/mcp | HTTPS enforced | 301 | https://openfoodfacts.caseyjhand.com/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
off_browse_taxonomy Browse Food Facts Taxonomy ~484
Resolve a human term to the canonical Open Food Facts tag ID that off_search_products filters on. Covers categories, labels/certifications, allergens, additives, countries, NOVA groups, and Nutri-Score grades. Pass a search term to resolve against the Open Food Facts vocabulary, which holds tens of thousands of tags; omitting it returns only a small reference list for each facet except NOVA groups and Nutri-Score grades, which are complete. Most tag IDs use the "en:" prefix (e.g. "en:organic", "en:no-gluten", "en:crustaceans"); NOVA groups return bare digits "1"-"4" and Nutri-Score grades bare letters "a"-"e". Pass the id through to off_search_products exactly as returned. Category tags are frequently plural ("kombucha" resolves to "en:kombuchas"), so use the returned id rather than constructing one.
| Name | Type | Req | Description |
|---|---|---|---|
| facet | string | yes | "categories" covers food categories (en:cheeses, en:breakfast-cereals). "labels" covers certifications (en:organic, en:fair-trade). "allergens" covers declared allergens (en:milk, en:gluten). "additi… |
| limit | integer | – | Maximum entries to return (1–100, default 20). There is no offset or page input: Open Food Facts returns only the first `limit` matches for a term and offers no cursor, so narrow the search term rath… |
| search | string | – | Term to resolve. Matched case-insensitively as a substring of the tag ID, the display name, or a common synonym of either ("shellfish" resolves to en:crustaceans, "gluten free" to en:no-gluten). A si… |
| Name | Type | Req | Description |
|---|---|---|---|
| cap | number | – | The limit that was applied. |
| error | object | – | Present when the call failed. Absent on success. |
| facet | string | – | The facet name that was queried (echoes the input). |
| notice | string | – | Caveat about the answer — that the listing is a limited reference list rather than the full vocabulary, that Open Food Facts was unreachable, or that nothing matched and why. |
| shown | number | – | Number of tags returned. |
| tags | array | – | Matching tag entries. |
| total_in_facet | number | – | Total entries in this facet. Present only for nova_groups and nutrition_grades, whose vocabularies are closed and complete. Absent for the other facets: Open Food Facts reports no match total and can… |
| truncated | boolean | – | True when more tags exist beyond the limit. |
No examples provided.
off_compare_products Compare Food Products Side-by-Side ~207
Side-by-side nutrition and scoring comparison for 2–10 products by barcode. Returns a normalized table of energy (kcal/100g), fat, saturated fat, sugars, salt, protein, fiber, Nutri-Score, NOVA group, and Green-Score. Designed for "which of these cereals is healthiest?" or "compare these pasta brands" workflows. Missing nutrition data for any product is preserved as absent — comparisons are not imputed. A batch is not all-or-nothing: barcodes that resolve are returned even when others fail, with confirmed-missing barcodes listed in not_found and failed fetches listed separately in failed. Scores carry regional formula caveats. Data under ODbL 1.0 — cite Open Food Facts in downstream use.
| Name | Type | Req | Description |
|---|---|---|---|
| barcodes | array | yes | 2–10 barcodes to compare, returned as one row each in input order. Example: ["3017620422003", "7622210100146"]. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | Present when the call failed. Absent on success. |
| failed | array | – | Barcodes whose fetch failed, with the per-barcode reason. Absent when every fetch completed. A barcode listed here is unknown, not absent from Open Food Facts — retry it with off_get_product before c… |
| not_found | array | – | Barcodes Open Food Facts answered for, confirming no contributor record exists. Not an error — the product may exist but not yet be entered. Never used for a fetch that failed. |
| products | array | – | Comparison rows in input order — one per barcode whose fetch completed, whether or not a record exists. Barcodes whose fetch failed have no row here; they appear in failed. |
| succeeded | number | – | Number of barcodes that resolved to a found product. |
No examples provided.
off_get_product Get Food Product by Barcode ~317
Fetch a packaged food product by barcode (EAN-13 or UPC) from Open Food Facts. Returns the product name, brand, quantity, ingredients (raw text and parsed list), declared allergens, trace allergens the label warns about, additives, the product-level vegan/vegetarian/palm-oil analysis, computed scores (Nutri-Score a–e, NOVA 1–4, Green-Score), nutrition per 100g and per serving, categories, labels, packaging, origins, countries of sale, image URL, and data completeness. Open Food Facts is a crowd-sourced database — a missing field means "not yet entered by contributors," not that the attribute is absent from the actual product. Computed scores carry regional formula caveats and are indicators, not absolute rankings. Data is under ODbL 1.0 — cite Open Food Facts in downstream use.
| Name | Type | Req | Description |
|---|---|---|---|
| barcode | string | yes | EAN-13 or UPC barcode (8–14 digits). The primary key for Open Food Facts. Example: "3017620422003" (Nutella FR). |
| fields | array | – | Subset of fields to return. Omitting returns all standard fields. Use to reduce payload when only scores or ingredients are needed. A field that cannot be read on its own arrives with what it depends… |
| Name | Type | Req | Description |
|---|---|---|---|
| barcode | string | – | Barcode as returned by the API. |
| error | object | – | Present when the call failed. Absent on success. |
| product | object | – | Product data. Always present on a successful call — a barcode with no contributor record raises the not_found error instead of returning an empty result. |
| requested_fields | array | – | The field subset that was fetched, when the caller passed `fields` — the requested fields plus the ones they depend on, so every field that can appear in `product` is named here. Absent means all sta… |
No examples provided.
off_search_products Search Food Products ~1,125
Search Open Food Facts by full-text query, structured tag filters, or both at once. Returns a summary list with barcodes, product names, brands, Nutri-Score, NOVA group, and categories — enough for triage and selection, not full label data. Use off_get_product on the returned barcodes for complete details. A text query and tag filters combine: results match the query text and satisfy every filter provided (e.g. query "dark chocolate" with labels_tag "en:organic" and countries_tag "en:france" returns organic chocolate sold in France); numeric nutrient_filters express per-100 g thresholds such as sugars below 8 g and combine the same way; additives_tag is the one exception, filtering only on searches carrying neither query nor nutrient_filters. Tag filter values must be canonical tag IDs (e.g. "en:organic", "en:no-gluten") — use off_browse_taxonomy to resolve human terms to tag IDs. At least one search parameter is required. The two paths read different indexes: a search carrying query is answered by the text index, a snapshot that lags the live database, while a tag-only search reads the live database and is current — so a recently contributed product can be missing from a text search and present in the same search without query. Data is crowd-sourced; result count reflects contributed products, not all products in the market. Data under ODbL 1.0 — cite Open Food Facts in downstream use.
| Name | Type | Req | Description |
|---|---|---|---|
| additives_tag | string | – | Canonical additive (E-number) tag ID. Example: "en:e322", "en:e330". Use off_browse_taxonomy with facet="additives". Available only on searches carrying neither query nor nutrient_filters — both rout… |
| allergens_tag | string | – | Canonical allergen tag ID. Example: "en:milk", "en:gluten". Use off_browse_taxonomy with facet="allergens". Selects products that declare this allergen; it cannot select allergen-free products, becau… |
| brands_tag | string | – | Brand slug (lowercased, hyphenated). Example: "nutella", "kelloggs". Matched exactly against the normalized slug — a partial or misspelled slug matches nothing rather than falling back to a near matc… |
| categories_tag | string | – | Canonical category tag ID. Example: "en:breakfast-cereals", "en:cheeses". Use off_browse_taxonomy with facet="categories" to discover valid values. |
| countries_tag | string | – | Canonical country tag ID. Example: "en:france", "en:united-states". Filters to products sold in that country. |
| labels_tag | string | – | Canonical label/certification tag ID. Example: "en:organic", "en:fair-trade", "en:no-gluten". Use off_browse_taxonomy with facet="labels". |
| nova_group | string | – | Filter by NOVA food processing class. "1"=unprocessed/minimally processed, "4"=ultra-processed. Products without a NOVA score are excluded. |
| nutrient_filters | array | – | Numeric constraints on nutrient values per 100 g, combined as AND with each other and with every other filter. Pair two entries on the same nutrient to express a range (e.g. sugars gte 2 and sugars l… |
| nutrition_grade | string | – | Filter by Nutri-Score grade. "a" is highest nutritional quality, "e" is lowest. Products without a score are excluded. |
| page | integer | – | Page number (1-based). Use with page_size to paginate results. Searches that include a text query serve only the first 10,000 results, so page * page_size must stay at or below 10,000 — a deeper requ… |
| page_size | integer | – | Results per page (1–50, default 20). Keep low for initial exploration; increase for comparison workflows. |
| query | string | – | Full-text search term across product names, brands, and ingredients. Combines with any tag filters — results match this text and satisfy the filters. Example: "dark chocolate 70%". Supplying it route… |
| sort_by | string | – | Sort order, applied on every search. Each value orders newest or highest first: "unique_scans_n" surfaces the most-scanned products, "last_modified_t" and "created_t" the most recently updated and ne… |
| Name | Type | Req | Description |
|---|---|---|---|
| cap | number | – | The page_size that was applied. |
| error | object | – | Present when the call failed. Absent on success. |
| last_page | number | – | Deepest page of this result set that holds products, at the page_size used — capped by the 10,000-result window on a search the text index answers. Absent when total_is_lower_bound is true — the tota… |
| notice | string | – | Guidance about this result set — echoes the filters and suggests how to broaden when nothing matched, or names the current page and how far the backend will actually paginate when more results exist. |
| page | number | – | Current page number (1-based). |
| page_count | number | – | Products returned on this page (mirrors page_size except on the last page). Not the total number of pages. |
| products | array | – | Matching products. Use barcodes with off_get_product for full label data. |
| shown | number | – | Number of products returned on this page. |
| text_index_snapshot | string | – | Present only on searches the text backend answered. States that those results come from an index snapshot that lags the live Open Food Facts database, so a recently contributed product can be missing… |
| total | number | – | Matching products in the database for this search. Exact unless total_is_lower_bound is true, in which case at least this many match and the real figure is unknown. |
| total_is_lower_bound | boolean | – | True when the backend stopped counting at its ceiling and total is a floor, not the match total. Only text searches can hit it; add filters to bring the result set under the ceiling and get an exact… |
| truncated | boolean | – | True when more results exist beyond this page. |
No examples provided.
What is the io.github.cyanheads/openfoodfacts-mcp-server server?
io.github.cyanheads/openfoodfacts-mcp-server is listed in the public MCP registry as io.github.cyanheads/openfoodfacts-mcp-server. Barcode lookup, nutrition search, and product comparison for 3M+ crowd-sourced food products. This page covers its hosted endpoint (https://openfoodfacts.caseyjhand.com/mcp).
Is the io.github.cyanheads/openfoodfacts-mcp-server server safe to use?
io.github.cyanheads/openfoodfacts-mcp-server scores 79 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.cyanheads/openfoodfacts-mcp-server server expose?
io.github.cyanheads/openfoodfacts-mcp-server exposes 4 tools: off_get_product, off_search_products, off_compare_products, off_browse_taxonomy. Their descriptions and schemas cost roughly 2,133 tokens of context every time the server is loaded.
Does the io.github.cyanheads/openfoodfacts-mcp-server server require authentication?
No. We connected to io.github.cyanheads/openfoodfacts-mcp-server without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.
Is the io.github.cyanheads/openfoodfacts-mcp-server server still maintained?
io.github.cyanheads/openfoodfacts-mcp-server is still listed as active in the MCP registry. We last reached this channel on 21 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.