Nutri-MCP

Nutrition data for AI agents. Query 4M+ food products from Open Food Facts, USDA, and Nutritionix through a single MCP server.

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────────────┐
│   Claude Code   │────▶│   Nutri-MCP     │────▶│   Open Food Facts (3M+) │
│   Agno Agent    │◀────│     Server      │────▶│   USDA FoodData (400K+) │
│   Any MCP Host  │     │                 │────▶│   Nutritionix (900K+)   │
└─────────────────┘     └─────────────────┘     └─────────────────────────┘

Quick Start

# Add to Claude Code (no install needed)
claude mcp add nutri-mcp -- npx nutri-mcp

# Verify
claude mcp list

Ask Claude: "What's the nutrition for barcode 3017620422003?"

With API Keys

Open Food Facts works without keys. Add USDA for better micronutrient data:

claude mcp add nutri-mcp \
  -e USDA_API_KEY=your-key \
  -- npx nutri-mcp

Get a free USDA key: fdc.nal.usda.gov/api-key-signup

Tools

35 tools across 7 categories:

Category	Tools	What it does
Product	2	getProduct, searchProducts
Nutrition	8	Macros, daily values, Nutri-Score, NOVA, Eco-Score
Allergen	8	Detection, alternatives, diet compatibility
Comparison	4	Side-by-side, healthier alternatives, rankings
Price	6	Retailer prices, deals, price history
Recipe	4	Recipe analysis, scaling, substitutes
Insights	3	Category trends, brand analysis

How It Works

┌──────────────────────────────────────────────────────────────────────────┐
│                             Nutri-MCP                                     │
├──────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│   getProduct("3017620422003")                                            │
│          │                                                               │
│          ▼                                                               │
│   ┌──────────────┐                                                       │
│   │   Cache?     │──── hit ───▶ return cached                            │
│   └──────┬───────┘                                                       │
│          │ miss                                                          │
│          ▼                                                               │
│   ┌──────────────┐     ┌──────────────┐     ┌──────────────┐            │
│   │     OFF      │     │     USDA     │     │  Nutritionix │            │
│   │   Provider   │     │   Provider   │     │   Provider   │            │
│   └──────┬───────┘     └──────┬───────┘     └──────┬───────┘            │
│          │                    │                    │                     │
│          └────────────────────┼────────────────────┘                     │
│                               ▼                                          │
│                    ┌──────────────────┐                                  │
│                    │  Merge & Return  │                                  │
│                    └──────────────────┘                                  │
│                                                                          │
│   Built-in: Circuit Breaker │ Rate Limiter │ Retry w/ Backoff           │
│                                                                          │
└──────────────────────────────────────────────────────────────────────────┘

Example Output

{
  "barcode": "3017620422003",
  "name": "Nutella",
  "brand": "Ferrero",
  "nutriScore": { "grade": "E", "score": 26 },
  "novaGroup": 4,
  "nutrients": [
    { "id": "energy", "value": 539, "unit": "kcal" },
    { "id": "sugar", "value": 56.3, "unit": "g", "dailyValuePercent": 113 }
  ],
  "allergens": ["milk", "tree_nuts"],
  "sources": ["openfoodfacts", "usda"]
}

HTTP Mode

For web apps, run as HTTP server:

TRANSPORT=http HTTP_PORT=3000 npx nutri-mcp

# Health check
curl localhost:3000/health

# Query
curl -X POST localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"getProduct","arguments":{"barcode":"3017620422003"}}}'

Configuration

Variable	Default	Description
TRANSPORT	stdio	stdio or http
HTTP_PORT	3000	Port for HTTP mode
USDA_API_KEY	-	USDA FoodData Central key
NUTRITIONIX_APP_ID	-	Nutritionix app ID
NUTRITIONIX_APP_KEY	-	Nutritionix app key
LOG_LEVEL	info	debug, info, warn, error
CACHE_MAX_SIZE	1000	Max cached items

Monorepo

nutri-mcp/
├── packages/core     # MCP server (npm: nutri-mcp)
└── packages/docs     # VitePress docs

pnpm install          # Install deps
pnpm build            # Build all
pnpm docs:dev         # Dev server at localhost:5173

Links

• Docs: nutri-mcp.com

License

MIT