io.github.cyanheads/usda-mcp-server
v0.1.12Search foods, compare nutrients, and look up the full USDA FoodData Central database.
Endpoint health
online- Last checked
- 11/20/2026, 9:18:07 AM
- Latency
- 237 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:io.github.cyanheads%2Fusda-mcp-server
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"io.github.cyanheads/usda-mcp-server": {
"url": "https://usda.caseyjhand.com/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
5 shown · authentication unknown
Compare USDA Foods
usda_compare_foods
Compare nutrients side-by-side for 2–5 foods. Returns a structured table — one row per nutrient, one column per food — formatted as markdown. Best for "spinach vs kale iron" or "which has more protein?" questions. Omit nutrients[] to use the 12 most common defaults (energy, protein, fat, saturated fat, carbs, fiber, sugars, sodium, potassium, calcium, iron, vitamin C); a food that lacks the default energy (1008) or total sugars (2000) value has that cell filled from its equivalent nutrient — energy from 2048, then 2047; sugars from 1063 — and each fill is listed in substitutions. Provide nutrients[] with specific FDC IDs to compare different nutrients; an explicit list is compared as given, without fills. All values are scaled to the same basis, quantity in unit: default 100 g, so unit="oz" alone compares per 100 oz and quantity alone is grams. A Branded food FDC reports per 100 ml (basisUnit "ml") or per 100 of a label unit that fixes neither (basisUnit absent) is compared on that basis without conversion, and a notice names it. If one or more FDC IDs are not found, the comparison proceeds with the valid foods — only throws too_few_foods when fewer than 2 IDs return data. IDs FDC does not return before the call's deadline (slow Foundation records, most often) or keeps failing on are left out, listed in deferredIds, and named in a notice; when that leaves fewer than 2 foods, the call fails with retry_deadline_exceeded instead, or with too_few_foods when even answers for the deferred IDs could not make 2 foods.
Schema valid · SHA-256 94e2ccfffa93…
View input schema
{ "type": "object", "properties": { "fdcIds": { "minItems": 2, "maxItems": 5, "type": "array", "items": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "description": "FDC IDs to compare — 2 to 5 foods. Use usda_search_foods to discover IDs." }, "nutrients": { "description": "Nutrient IDs to include in the comparison. Defaults to the 12 most common: energy (1008), protein (1003), total fat (1004), saturated fat (1258), carbohydrate (1005), fiber (1079), total sugars (2000), sodium (1093), potassium (1092), calcium (1087), iron (1089), vitamin C (1162). Under the defaults, a food missing energy or total sugars has that cell filled from its equivalent nutrient (listed in substitutions); IDs given here are compared as given. Use usda_list_nutrients to look up other IDs.", "type": "array", "items": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "quantity": { "default": 100, "description": "Amount of food, in unit, that every value is scaled to. Must be positive. Default 100.", "type": "number", "exclusiveMinimum": 0 }, "unit": { "default": "g", "description": "Unit for quantity. Default \"g\". Does not support \"serving\" (each food's portion weight differs, so a serving basis would not compare equal amounts).", "type": "string", "enum": [ "g", "oz", "lb", "kg" ] } }, "required": [ "fdcIds" ], "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false }
Connections
streamable-http
https://usda.caseyjhand.com/mcp