{
  "version": "0.1.0",
  "protocolVersion": "2025-06-18",
  "serverInfo": {
    "name": "heathy",
    "title": "Heathy — nutrition data",
    "version": "0.1.0"
  },
  "registryName": "org.heathy/nutrition",
  "description": "Nutrition data for 917 whole plant foods and 39 Ayurvedic herbs, reconciled across 11 national food-composition datasets including IFCT 2017 (India). Every value carries its provenance: how many sources contributed, which ones, and the spread between them.",
  "websiteUrl": "https://heathy.org",
  "documentationUrl": "https://github.com/Chandata/heathy-mcp",
  "iconUrl": "https://heathy.org/icon.svg",
  "transport": {
    "type": "streamable-http",
    "endpoint": "https://mcp.heathy.org/mcp"
  },
  "capabilities": {
    "tools": {
      "listChanged": false
    }
  },
  "authentication": {
    "required": false,
    "type": "none",
    "note": "Free while in preview. Contact hello@heathy.org for higher limits."
  },
  "tools": [
    {
      "name": "lookup_food",
      "title": "Look up a food",
      "description": "Get the full per-100 g nutrient profile of a whole plant food, reconciled across up to 11 national food-composition datasets (USDA, UK CoFID, IFCT India, Ciqual, BLS, Frida, and more). Unlike a single-source table, every value reports how many sources contributed, which ones, and the per-source spread — so the number can be cited rather than asserted. Covers Indian foods from IFCT 2017, which is not available as an API elsewhere. Accepts a slug (\"bitter-gourd\") or a plain or regional name (\"karela\", \"chickoo\").",
      "inputSchema": {
        "type": "object",
        "properties": {
          "food": {
            "type": "string",
            "description": "Food slug, common name, or regional alias."
          },
          "nutrients": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Optional nutrient slugs or names to return (e.g. [\"iron\",\"vitamin-c\"]). Omit for the full profile of ~168 nutrients."
          }
        },
        "required": [
          "food"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "search_foods",
      "title": "Search foods and herbs",
      "description": "Find the Heathy slug for a food or Ayurvedic herb by name, including regional and non-English aliases (Hindi, Sanskrit, botanical names). Call this first when you have a plain-English or local name and need the slug for lookup_food or herb_monograph. Returns ranked candidates rather than guessing a single answer.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Name, partial name, or alias — e.g. \"haldi\", \"bitter gou\"."
          },
          "kind": {
            "type": "string",
            "enum": [
              "food",
              "herb",
              "any"
            ],
            "description": "Restrict to foods or Ayurvedic herbs. Default \"any\"."
          },
          "limit": {
            "type": "integer",
            "description": "Max results, 1–50. Default 10."
          }
        },
        "required": [
          "query"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "nutrient_ranking",
      "title": "Rank foods by a nutrient",
      "description": "Rank whole plant foods by how much of a nutrient they provide per 100 g — the \"highest in vitamin C / iron / calcium\" question, answered from reconciled multi-source data rather than one national table. Optionally filter by food category. Each result reports how many sources backed the value, so thinly-sourced outliers can be spotted or excluded via min_sources.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "nutrient": {
            "type": "string",
            "description": "Nutrient slug or name — e.g. \"iron\", \"vitamin-c\", \"folate\"."
          },
          "limit": {
            "type": "integer",
            "description": "Max results, 1–100. Default 20."
          },
          "category": {
            "type": "string",
            "description": "Optional substring filter on the food category — e.g. \"fruit\", \"legume\", \"millet\"."
          },
          "min_sources": {
            "type": "integer",
            "description": "Only include values backed by at least this many datasets (1–11). Default 1."
          }
        },
        "required": [
          "nutrient"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "herb_monograph",
      "title": "Ayurvedic herb monograph",
      "description": "Get a sourced monograph for an Ayurvedic herb, with traditional use and modern research kept strictly separate and never blended: `traditional` records what the tradition claims, `modern` records what research shows with an evidence tier (1 = strongest). Every response includes a mandatory `safety` block — cautions, pregnancy guidance and drug interactions — which must be reproduced alongside any information taken from this tool. Accepts English, Sanskrit, Hindi or botanical names (\"turmeric\", \"haldi\", \"Curcuma longa\").",
      "inputSchema": {
        "type": "object",
        "properties": {
          "herb": {
            "type": "string",
            "description": "Herb slug or name — English, Sanskrit, Hindi, or botanical."
          }
        },
        "required": [
          "herb"
        ],
        "additionalProperties": false
      }
    }
  ],
  "dataset": {
    "foods": 917,
    "herbs": 39,
    "nutrients": 168,
    "sources": [
      "us",
      "uk",
      "jp",
      "fr",
      "de",
      "dk",
      "no",
      "wa",
      "br",
      "sl",
      "in"
    ],
    "updated": "2026-08-12"
  },
  "terms": "https://heathy.org/terms/",
  "contact": "hello@heathy.org"
}