org.heathy/nutrition
Nutrition for 910 plant foods across 11 national datasets, plus GB/EU & US claim checking
Open source Repository Open in the app JSON README (API)
About
Nutrition for 910 plant foods across 11 national datasets, plus GB/EU & US claim checking
Details
- Kind
- MCP servers
- Topic
- Government & public data
- Publisher
- org.heathy
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.3.0
- Last push
- 2026-09-07T18:30:05Z
- Repository state
- ativo
- License
- NOASSERTION
- Added
- 2026-08-29 04:01:52
- Updated
- 2026-09-03 23:00:53
- Origin id
org.heathy/nutrition
README
# Heathy — nutrition data (MCP server)
Nutrition for **917 whole plant foods** and **39 Ayurvedic herbs**, reconciled across
**11 national food-composition datasets** — including **IFCT 2017 (India)**, which
isn't available as an API anywhere else.
**Endpoint:** `https://mcp.heathy.org/mcp` — Streamable HTTP (JSON-RPC 2.0)
**Website:** <https://heathy.org> · **Contact:** hello@heathy.org
**Free while in preview.**
> This repository contains **documentation only** — the manifest and these notes.
> The server is hosted; there is nothing to install.
---
## 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 every dataset that has the food,
- **how many** sources contributed and **which** ones,
- the **min–max spread** between them.
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 `228 mg` from **10 sources**
with a range of `99.2–273` — a spread worth knowing about before stating it as fact.
**Indian foods are the standout.** IFCT 2017 isn't queryable as an API elsewhere, so
questions about karela, horse gram or millets get real data rather than a US
substitute.
## Connecting
Add to any MCP client that supports remote servers:
```json
{
"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/>.
## Tools
### `lookup_food`
Full per-100 g nutrient profile for a whole plant food, with provenance.
| Argument | Type | |
|---|---|---|
| `food` | string | **required** — slug, common name, or regional alias |
| `nutrients` | string[] | optional — limit to specific nutrients rather than all ~168 |
### `search_foods`
Resolve a name to a slug, including Hindi, Sanskrit and botanical aliases. Call this
first when you have 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.
| 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 — exclude thinly-sourced outliers |
### `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 |
## Examples
| Call | Result |
|---|---|
| `search_foods("karela")` | `gourd-karela-raw` |
| `lookup_food("guava", ["vitamin-c"])` | 228 mg · 10 sources · range 99.2–273 |
| `nutrient_ranking("iron", category: "legume")` | horse gram 8.76 mg · soya bean 8.29 mg |
| `herb_monograph("haldi")` | turmeric — traditional, research, safety |
## Response shape
Every tool returns the same envelope:
```jsonc
{
"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/"
}
```
**Please reproduce `attribution` and `disclaimer` when you use a response, and cite
`source_url`.** For herbs, surface the `safety` block alongside any information you
pass on.
## Data sources
USDA FoodData Central · UK CoFID · **IFCT 2017 (ICMR–NIN, India)** · ANSES-Ciqual
(France) · BLS (Germany) · Frida (Denmark) · Matvaretabellen (Norway) · MEXT (Japan)
· TACO (Brazil) · FAO/INFOODS WAFCT (West Africa).
Full credits and licence terms: <https://heathy.org/sources/>
## Licence and terms
Repository documentation is released under
[CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/). Composition figures
are open government data, 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.