younghef avatar

Nutriref

younghef/nutriref-api

Wraps the USDA FoodData Central database in a pay-per-call interface that agents can use without API keys or signup flows. Exposes four tools: search foods by name, fetch detailed nutrition per 100g, compare multiple foods across nutrients, and calculate totals for multi-ingredient recipes. Each call costs $0.001 to $0.005 in USDC on Base, paid automatically via the x402 micropayment protocol. Responses are cached in Redis for 24 hours to 7 days depending on endpoint. Reach for this when you need structured nutrition data in an agent workflow and want to avoid the friction of key management or per-developer rate limits. The MCP server handles wallet signing and payment retry logic so Claude just sees regular tool calls.

GitHub stars
1
tools
4
transport
STDIO
last updated
Jun 15, 2026

Tools

4 tools

Public tool metadata for what this MCP can expose to an agent.

nutrition_searchSearch USDA nutrition data by food name.

Search USDA nutrition data by food name.

No parameter schema in public metadata yet.

nutrition_detailGet the detailed nutrition profile for a food by its FDC ID.

Get the detailed nutrition profile for a food by its FDC ID.

No parameter schema in public metadata yet.

nutrition_compareCompare nutrition across several foods, with per-nutrient winners.

Compare nutrition across several foods, with per-nutrient winners.

No parameter schema in public metadata yet.

nutrition_recipeScale ingredients by grams and sum their nutrition totals.

Scale ingredients by grams and sum their nutrition totals.

No parameter schema in public metadata yet.

Sponsors

Readme

NutriRef

NutriRef MCP server

Pay-per-call USDA nutrition data for AI agents. Structured FoodData Central via the x402 micropayment protocol — agents pay $0.001–$0.005 in USDC per request, no signup, no API keys, no human auth flows.

Live at https://nutriref.xyz. Spec at /openapi.json · Swagger at /docs · Bazaar discovery at /.well-known/x402.

Endpoints

MethodPathPriceCache
GET/v1/nutrition/search?q=&limit=$0.00124h
GET/v1/nutrition/detail/{fdc_id}$0.0027d
POST/v1/nutrition/compare$0.003derived
POST/v1/nutrition/recipe$0.005derived

All values per 100g. Missing nutrients are null, not 0. compare returns per-nutrient winners (highest protein, lowest sodium, etc.). recipe scales by grams and sums.

Use it from Claude (or any MCP agent)


View the full README on GitHub

Details

Repository
github.com/younghef/nutriref-api
Package
https://github.com/Younghef/nutriref-api/releases/download/v0.2.3/nutriref.mcpb
Transport
STDIO
Registry
MCP registry, active