Skip to main content
Glama

Server Details

Search foods, compare nutrients, and look up the full USDA FoodData Central database.

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
cyanheads/usda-mcp-server
GitHub Stars
1
Server Listing
usda-mcp-server
ChatGPT
–
Claude
–

TDQS

A4.5/5.0

Scored across 5 tools

Disambiguation4/5

Each tool targets a distinct operation: keyword search, nutrient ID resolution, single-food profile, batch profile fetch, and side-by-side comparison. The only real collision risk is usda_get_food vs usda_get_foods (singular vs plural), but both descriptions explicitly state when to use the other and usda_get_foods even points to usda_compare_foods for formatted comparisons.

Naming Consistency5/5

All tools use a uniform usda_ prefix followed by a clear verb_noun pattern (search_foods, get_food, get_foods, compare_foods, list_nutrients). The singular/plural distinction between get_food and get_foods is the only near-deviation and it is a deliberate, readable convention.

Tool Count5/5

Five tools is well within the ideal range and each earns its place in a discover-inspect-compare workflow. No redundant or filler tools; the batch getter and comparator are justified by distinct response shapes and limits.

Completeness4/5

The surface covers the full practical lifecycle: search for IDs, resolve nutrient IDs, fetch one or many profiles, and compare foods. Minor gaps exist — no nutrient-based food search (e.g. 'foods high in iron') and no enumeration of data types/categories beyond what the search params expose — but agents can work around these via keyword search and the nutrient table.

Available Tools

5 tools
usda_compare_foodsCompare USDA FoodsA
Read-only
Inspect

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. Accepts up to 500 FDC IDs: repeats are dropped, the first 5 distinct IDs are compared, and the rest are returned in deferredIds without being requested from FDC, with a notice naming the follow-up call. 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, repeats dropped, 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 fdcIds holds fewer than 2 distinct IDs or fewer than 2 of the compared 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 ahead of any past the first 5, 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 those IDs could not make 2 foods.

Inputs: fdcIds (required), unit, quantity, nutrients. Returns: basis, error, foods, notice, +4 more

usda_get_foodGet USDA FoodA
Read-only
Inspect

Get the full nutrient profile for one food by FDC ID. Returns all available nutrients (or a filtered subset via the nutrients[] param) with optional per-portion scaling. Use usda_search_foods to discover FDC IDs. Values are per 100 g (basisUnit "g"), except Branded foods FDC reports per 100 ml (basisUnit "ml") or per 100 of a label unit that fixes neither (basisUnit absent, basis unverified). Provide unit, optionally with quantity, to scale all nutrient values from that basis to that amount (e.g. quantity=200, unit="g" → per-200g values); a mass unit is applied to an ml or label-unit basis without conversion, and a notice says so. quantity defaults to 100 for g, oz, lb, and kg and to 1 for serving. Serving uses the valid portion FDC displays first (lowest sequenceNumber), or a positive finite Branded label size in g/GRM/GM (case-insensitive) when no portion exists; quantity multiplies that weight. A label in any other unit sets the basis rather than a serving weight, so it requires an explicit mass-unit request. quantity without unit is rejected. Narrow nutrients[] to specific IDs to reduce response size for focused queries. Set provenance=true to add to each nutrient how FDC obtained its value (derivation code, description, and source), its sample count (dataPoints), and the sample min, max, and median scaled with amount, each only where FDC sends it.

Inputs: fdcId (required), unit, quantity, nutrients, +1 more. Returns: error, fdcId, notice, gtinUpc, +16 more

usda_get_foodsGet USDA Foods (Batch)A
Read-only
Inspect

Fetch nutrient profiles for several foods at once. More efficient than calling usda_get_food N times when you already have multiple FDC IDs. Accepts up to 500 IDs: repeats are dropped, the first 20 distinct IDs are fetched, and the rest are returned in deferredIds for a follow-up call. IDs FDC does not return before the call's deadline (slow Foundation records, most often) or keeps failing on also come back in deferredIds, ahead of those, named in a notice. Values are per 100 of each food's basisUnit, with no portion scaling: per 100 g (basisUnit "g"), except Branded foods FDC reports per 100 ml (basisUnit "ml") or per 100 of a label unit that fixes neither (basisUnit absent, basis unverified). Use the nutrients[] filter to limit response size — strongly recommended for batch calls; requested IDs a food does not report are listed in its missingNutrients. Set provenance=true to add to each nutrient how FDC obtained its value (derivation code, description, and source), its sample count (dataPoints), and the sample min, max, and median, each only where FDC sends it. For side-by-side comparison with a formatted table, use usda_compare_foods instead. Failed IDs (not found or no data) are reported in the failed[] array rather than aborting the entire batch.

Inputs: fdcIds (required), nutrients, provenance. Returns: error, foods, failed, notice, +1 more

usda_list_nutrientsList USDA NutrientsA
Read-only
Inspect

Look up the FDC nutrient reference table — 269 nutrients with their numeric IDs, names, SR reference numbers, units, and categories. Use to resolve a nutrient name (e.g. "vitamin C") to its FDC ID (1162) before passing it to the nutrients[] filter on other tools. Pass query to match a name, ID, or SR number, and category (macronutrients, vitamins, minerals, lipids, amino_acids, or other) to narrow to one group. The data is static — call once and reuse the IDs.

Inputs: query, category. Returns: error, notice, nutrients, effectiveQuery

usda_search_foodsSearch USDA FoodsA
Read-only
Inspect

Search USDA FoodData Central foods by keyword. Returns matching foods with FDC IDs and available preview nutrients: protein (1003), fat (1004), carbohydrate (1005), fiber (1079, and 2033 for AOAC 2011.25 total dietary fiber, a separate measure some Foundation foods report beside or instead of 1079), and energy (1008, 1062, 2047, 2048), preserving distinct fiber and energy measures. Missing nutrients are omitted. Use the returned fdcId with usda_get_food for other nutrients or the full profile, or usda_compare_foods for side-by-side comparisons. When dataType is omitted, defaults to SR Legacy (common whole foods with complete profiles), to Branded when brandOwner is set (only Branded records carry one), or to Branded and Survey (FNDDS) when the query is 8–14 digits alone (a UPC/GTIN barcode or an FNDDS food code). A 12–14-digit barcode with a valid check digit also matches the other digit forms FDC stores it in. Set dataType to ["Branded"] for packaged products. Pass brandOwner (e.g. "General Mills") to narrow branded results.

Inputs: query (required), dataType, pageSize, brandOwner, +3 more. Returns: error, foods, notice, totalHits, +3 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides intelligent access to the USDA nutrition database through AI assistants, enabling users to search foods, compare nutritional content, find foods high in specific nutrients, and query authoritative nutrition data across 7,146+ food items through natural language.
      1
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables Claude to search and access detailed nutritional information from the USDA's FoodData Central database.
      11
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.