Heathy — nutrition data (MCP server)

Nutrition for more than 1,100 whole plant foods and their flours and 39 Ayurvedic herbs, drawn from 30 food-composition tables covering 26 countries plus West Africa, the Pacific and FAO's global biodiversity table — including IFCT 2017 (India). It also answers which GB/EU and US nutrition claims the published data supports for a raw whole food or an unfortified flour.

Endpoint: https://mcp.heathy.org/mcp — Streamable HTTP (JSON-RPC 2.0) Website: https://heathy.org · Contact: hello@heathy.org Operated by CCT Technologies Ltd (England & Wales, company no. 06337577) Free while in preview.

This repository contains no server code — only the manifest, these notes and a Dockerfile. The server is hosted; there is nothing to install. The Dockerfile only bridges stdio to the hosted endpoint, for directories that inspect servers in a container.

---

What makes it different

Most nutrition APIs hand back a single number from a single national table. This one returns the number and its provenance:

• the median across the datasets that have the food,
• how many sources contributed and which ones,
• the min–max spread between them, and every source's own value.

So an agent can cite a figure instead of asserting it, and can tell when the sources disagree. Guava vitamin C, for example, comes back as 222 mg — the median of 13 tables, ranging 68–273 — with 20 national values listed side by side. That spread is real: soil, cultivar and analytical method differ between countries, and it is worth knowing before stating a figure as fact.

Indian foods are covered from IFCT 2017, so questions about karela, horse gram or millets are answered from Indian data rather than a US substitute.

How far the cross-checking goes

Be aware of coverage when you use the data:

• Fewer than half the foods are held by two or more tables — up to 26 for common produce.
• More than half come from a single table. Their sources count is 1; there is nothing to cross-check them against. Use min_sources on nutrient_ranking to keep these out of a ranking; they are then listed beside it.
• Some tables' licences allow their figures to be shown but not averaged. Those values appear under by_source but are not folded into the median, which is why sources can be lower than the number of values listed.

Connecting

Add to any MCP client that supports remote servers:

{
  "mcpServers": {
    "heathy": {
      "type": "streamable-http",
      "url": "https://mcp.heathy.org/mcp"
    }
  }
}

No API key, no signup. A service card describing the server is at https://mcp.heathy.org/.well-known/mcp/server-card.json.

Tools

lookup_food

Full per-100 g nutrient profile for a whole plant food or flour, with provenance.

Argument	Type
food	string	required — slug, common name, or regional alias
nutrients	string[]	optional — limit to specific nutrients rather than the full profile

The full profile covers about 130 nutrients, plus a research tier marked tier: "research" (thin coverage, or a restatement of another nutrient).

What comes back when the name is not an exact match:

• An everyday name ("potato", "kela", "besan") opens the food most national tables carry. When the match was loose, the answer says so in matched_from, with the other foods it could have meant.
• Everyday nutrient names ("fiber", "omega 3", "calories", "vit c") are understood. A name that is not is listed in unrecognised_nutrients; the rest of the answer is returned.
• A cooked or prepared form ("lentils boiled", "brown rice cooked") is refused, and the reply names the unprepared food that is held. The unprepared figures are not returned in its place: per 100 g they are a different food.
• A food that is not held — animal foods, foods made from plants (tofu, pasta, sugar), refined wheat flours — gets a reply saying which of those it is.

search_foods

Resolve a name to a slug, including Hindi, Sanskrit and botanical aliases. Returns ranked candidates for a plain-English or local name.

Argument	Type
query	string	required
kind	food | herb | any	optional, default any
limit	integer	optional, 1–50, default 10

nutrient_ranking

Rank foods by a nutrient per 100 g — the "highest in iron" question. Each row also gives the typical serving heathy.org holds for the food and the amount in it; the order is per 100 g.

Foods eaten a few grams at a time — dried herbs, spices, tea leaves, and dried seaweed, mushrooms and vegetables, 102 foods — are not ranked in results. They are reported beside it in also_higher.small_amounts: a count of those holding more per 100 g than the last row, and the first five. They are ranked in results when include_small_amounts is true, and when the category asked for is mostly such foods (spice, tea, seaweed).

Argument	Type
nutrient	string	required — slug or name
limit	integer	optional, 1–100, default 20
category	string	optional — e.g. fruit, legume, millet
min_sources	integer	optional, default 1 — smallest number of sources for a food to be ranked; foods below it are reported in also_higher.fewer_sources
include_small_amounts	boolean	optional, default false — rank spices, tea and dried seaweed with every other food

herb_monograph

An Ayurvedic herb monograph. Traditional use and modern research are kept strictly separate — traditional records what the tradition claims, modern records what research shows with an evidence tier. Every response carries a mandatory safety block (cautions, pregnancy guidance, drug interactions).

Argument	Type
herb	string	required — English, Sanskrit, Hindi or botanical name

check_claim

For a raw whole food or an unfortified single-ingredient flour, which nutrition claims ("source of potassium", "high in vitamin C") the data supports under GB/EU rules (Reg. 1924/2006, per 100 g) and US rules (21 CFR 101.54, per RACC). It flags where the answer depends on which national table was used, listing the tables that do and don't support it.

Argument	Type
food	string	required — slug or name
nutrient	string	optional — check one nutrient only
market	uk | us | both	optional, default both
only_permitted	boolean	optional — return only supported claims
preparation	raw	optional, and the only value accepted

Scope. This is a screening tool, not permission to make a claim. It refuses cooked and manufactured products, whose composition depends on recipe and processing. A supported claim still needs an analysis of the producer's own produce: the law looks at the final product, not at a reference table. It lists the tables that do and do not support a claim; it does not choose one that qualifies.

search_recipes

Find original raw / no-cook vegan recipes on Heathy by free text, health goal, category, ingredient, time or allergen. Per-serving nutrition is computed from the same food rows lookup_food returns.

Argument	Type
query	string	optional — free text, e.g. breakfast
goal	string	optional — e.g. immune, bone, gut, heart
category	string	optional — e.g. smoothies, salads, chutneys
ingredient	string	optional — food slug or name that must appear
max_time	integer	optional — total minutes
exclude_allergens	string[]	optional — e.g. ["tree-nuts","sesame"]
limit	integer	optional, 1–50, default 10

get_recipe

One recipe in full: ingredients with food slugs and gram weights, method, per-serving nutrition, allergens and carbon footprint.

Argument	Type
recipe	string	required — slug or name

health_topic

What to eat for a health goal — the nutrients involved, why each one, and which raw recipes carry them. Accepts a goal ("gut health") or a named condition ("PCOS", "anaemia"). Topics people reach for with a diagnosis carry a note on what the evidence does and does not support, with its own evidence rating. Omit topic to list every topic.

Argument	Type
topic	string	optional — goal slug or title, or a condition name
include_recipes	boolean	optional, default true

Examples

Call	Result
search_foods("karela")	gourd-karela-raw
lookup_food("guava", ["vitamin-c"])	222 mg · median of 13 tables · range 68–273
lookup_food("besan", ["protein"])	chickpea-flour · 22.39 g · 3 tables
lookup_food("lentils boiled")	refused — names lentil-whole-brown, held unprepared
nutrient_ranking("iron", category: "legume", min_sources: 3)	brown lentil 8 mg · white soybean 7.91 mg · chickpea 5.4 mg
nutrient_ranking("magnesium")	hulled hemp seed 591.5 mg (177.4 mg per 30 g) first · 37 foods eaten a few grams at a time counted beside the list, led by dried sea lettuce 3,200 mg
check_claim("banana", nutrient: "potassium")	GB/EU "source of" supported at 335 mg — 16 of 21 tables support it and 5 don't
health_topic("anaemia")	iron-deficiency-anaemia — nutrients, reasons, recipes
herb_monograph("haldi")	turmeric — traditional, research, safety

Response shape

Every tool returns the same envelope:

{
  "data":        { /* the payload */ },
  "attribution": ["USDA FoodData Central …", "IFCT 2017, ICMR–NIN …"],
  "source_url":  "https://heathy.org/food/guava-flesh-only-raw/",
  "disclaimer":  "Informational only — not medical advice.",
  "license":     "https://heathy.org/terms/"
}

Each response includes attribution, disclaimer and source_url; herb responses also include a safety block with cautions, pregnancy guidance and drug interactions. The terms at https://heathy.org/terms/ ask that figures you republish carry the attribution.

Data sources

Americas — USDA FoodData Central (Foundation Foods and SR Legacy) · Canadian Nutrient File · TACO (Brazil) · INCMNSZ (Mexico) · ARGENFOODS (Argentina)

Europe — UK CoFID · ANSES-Ciqual (France) · BLS (Germany) · Frida (Denmark) · Matvaretabellen (Norway) · Livsmedelsverket (Sweden) · Fineli (Finland) · NEVO (Netherlands) · CREA (Italy) · Swiss FCDB · NutriData (Estonia)

Asia — IFCT 2017 (ICMR–NIN, India) · MEXT (Japan) · China CFCT · Korea MFDS · Singapore SG FoodID · Pakistan FCT · Sri Lanka FCT

Africa and Oceania — FAO/INFOODS WAFCT (West Africa) · Kenya KFCT · Ethiopia EFCT · Australia AFCD (FSANZ) · Pacific Nutrient Database

Global — FAO/INFOODS BioFoodComp · open-licence (CC BY) research papers for foods no national table covers · Phenol-Explorer (polyphenol content, shown but not averaged)

Full credits and licence terms: https://heathy.org/sources/

Licence and terms

The files in this repository (documentation, manifest and Dockerfile) are released under the MIT licence. That licence covers this repository only. Composition figures come from the published tables above, each under its own terms, and are credited per response and at the link above. The reconciliation, recipes, herb monographs and original content are © Heathy — see https://heathy.org/terms/. Use of the hosted service at mcp.heathy.org is governed by those terms.

Not medical advice. The data is informational and does not diagnose or treat anything. A 100% raw-vegan diet does not supply adequate vitamin B12 or vitamin D.