nutriref-mcp 0.2.2__py3-none-any.whl

mcp_server/__init__.py

@@ -0,0 +1,13 @@
+"""MCP server that exposes NutriRef's endpoints as tools for AI agents.
+
+Run with:
+    python -m mcp_server
+
+Required env vars:
+    PAYER_PRIVATE_KEY  -- a funded Base mainnet wallet's private key (the agent operator pays from this wallet)
+    NUTRIREF_BASE_URL  -- defaults to https://nutriref.xyz
+"""
+
+from .server import main
+
+__all__ = ["main"]

mcp_server/__main__.py

@@ -0,0 +1,4 @@
+from .server import main
+
+if __name__ == "__main__":
+    main()

mcp_server/server.py

@@ -0,0 +1,107 @@
+"""FastMCP server exposing NutriRef as four tools.
+
+Each tool call makes a real x402 micropayment against NUTRIREF_BASE_URL using
+PAYER_PRIVATE_KEY. The agent operator funds that wallet with USDC on Base.
+"""
+
+import os
+from typing import Any
+
+import httpx
+from eth_account import Account
+from mcp.server.fastmcp import FastMCP
+from x402.client import x402Client
+from x402.http.clients.httpx import wrapHttpxWithPayment
+from x402.mechanisms.evm.exact import register_exact_evm_client
+
+
+NUTRIREF_BASE_URL = os.environ.get("NUTRIREF_BASE_URL", "https://nutriref.xyz")
+
+_http: httpx.AsyncClient | None = None
+
+
+def _client() -> httpx.AsyncClient:
+    global _http
+    if _http is not None:
+        return _http
+    key = os.environ.get("PAYER_PRIVATE_KEY")
+    if not key:
+        raise RuntimeError(
+            "PAYER_PRIVATE_KEY env var is required to make a paid NutriRef call. "
+            "Set it to a Base mainnet wallet private key with USDC balance "
+            "(each call costs $0.001-$0.005)."
+        )
+    account = Account.from_key(key)
+    x402 = x402Client()
+    register_exact_evm_client(x402, account)
+    _http = wrapHttpxWithPayment(x402, base_url=NUTRIREF_BASE_URL, timeout=30.0)
+    return _http
+
+
+mcp = FastMCP(
+    "nutriref",
+    instructions=(
+        "NutriRef: structured USDA FoodData Central nutrition data. Each call charges "
+        "USDC from the configured PAYER_PRIVATE_KEY wallet on Base mainnet via x402. "
+        "Use nutrition_search first to get an fdc_id, then nutrition_detail for the "
+        "full breakdown. nutrition_compare and nutrition_recipe compose from cached "
+        "detail data."
+    ),
+)
+
+
+@mcp.tool()
+async def nutrition_search(q: str, limit: int = 10) -> dict[str, Any]:
+    """Find foods in the USDA FoodData Central database by free-text name. Use this FIRST when the user mentions a food by name and you need its `fdc_id` for any of the other nutrition_* tools. Returns ranked matches with fdc_id, description, brand_owner, and a quick macro summary (calories/protein/carbs/fat per 100g). Charges $0.001 USDC per call.
+
+    Args:
+        q: Free-text food name (e.g. "banana", "greek yogurt", "chicken breast").
+        limit: Max results to return, 1-50. Default 10. Use a small limit unless you need to browse.
+    """
+    r = await _client().get("/v1/nutrition/search", params={"q": q, "limit": limit})
+    r.raise_for_status()
+    return r.json()
+
+
+@mcp.tool()
+async def nutrition_detail(fdc_id: int) -> dict[str, Any]:
+    """Get the full per-100g nutrition profile for one specific food. Use this when you have an `fdc_id` (from nutrition_search) and the user needs micronutrients beyond just calories/protein/carbs/fat. Returns all 13 tracked nutrients: calories, protein, fat, carbs, fiber, sugar, sodium, cholesterol, saturated_fat, vitamin_c, calcium, iron, potassium. Missing nutrients are `null`, not 0. Charges $0.002 USDC per call.
+
+    Args:
+        fdc_id: USDA FoodData Central ID, obtained from nutrition_search.
+    """
+    r = await _client().get(f"/v1/nutrition/detail/{fdc_id}")
+    r.raise_for_status()
+    return r.json()
+
+
+@mcp.tool()
+async def nutrition_compare(fdc_ids: list[int]) -> dict[str, Any]:
+    """Compare 2 to 5 foods side by side. Use this when the user asks "which is healthier," "which has more protein," or any cross-food comparison — it's cheaper and clearer than calling nutrition_detail multiple times. Returns each food's full nutrition plus per-nutrient winners (highest protein, lowest sodium, etc.). Charges $0.003 USDC per call.
+
+    Args:
+        fdc_ids: 2 to 5 USDA FDC IDs to compare.
+    """
+    r = await _client().post("/v1/nutrition/compare", json={"fdc_ids": fdc_ids})
+    r.raise_for_status()
+    return r.json()
+
+
+@mcp.tool()
+async def nutrition_recipe(ingredients: list[dict[str, Any]]) -> dict[str, Any]:
+    """Sum nutrition across a recipe of weighted ingredients. Use this for meal planning, recipe analysis, or any "what are the totals if I combine X grams of A with Y grams of B" task. Each food's per-100g nutrition is scaled by grams/100 then summed. Charges $0.005 USDC per call.
+
+    Args:
+        ingredients: List of {"fdc_id": int, "grams": float} pairs. At least one; weights in grams.
+    """
+    r = await _client().post("/v1/nutrition/recipe", json={"ingredients": ingredients})
+    r.raise_for_status()
+    return r.json()
+
+
+def main() -> None:
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()

nutriref_mcp-0.2.2.dist-info/METADATA

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: nutriref-mcp
+Version: 0.2.2
+Summary: MCP server for NutriRef — pay-per-call USDA nutrition for AI agents (x402 + USDC on Base).
+Author: Derek Hefley
+License: MIT
+Project-URL: Homepage, https://nutriref.xyz
+Project-URL: Repository, https://github.com/Younghef/nutriref-api
+Project-URL: Issues, https://github.com/Younghef/nutriref-api/issues
+Keywords: mcp,nutrition,usda,x402,agents,food,fooddata-central
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: eth-account>=0.13.0
+Requires-Dist: x402[evm]>=2.10.0
+
+# nutriref-mcp
+
+MCP server for **[NutriRef](https://nutriref.xyz)** — pay-per-call USDA FoodData Central nutrition for AI agents, gated by [x402](https://www.x402.org/) micropayments in USDC on Base. No signup, no API keys.
+
+It exposes four tools:
+
+| Tool | What it does | Price |
+|---|---|---|
+| `nutrition_search` | Find foods by name, get `fdc_id` + macros | $0.001 |
+| `nutrition_detail` | Full per-100g profile (13 nutrients) for one food | $0.002 |
+| `nutrition_compare` | Compare 2–5 foods with per-nutrient winners | $0.003 |
+| `nutrition_recipe` | Scale and sum nutrition across weighted ingredients | $0.005 |
+
+## Install
+
+```bash
+pip install nutriref-mcp
+```
+
+Or run without installing:
+
+```bash
+uvx nutriref-mcp
+```
+
+## Configure your MCP client
+
+Add this to your client config (Claude Desktop's `claude_desktop_config.json`, Claude Code's MCP settings, etc.):
+
+```json
+{
+  "mcpServers": {
+    "nutriref": {
+      "command": "nutriref-mcp",
+      "env": {
+        "PAYER_PRIVATE_KEY": "0x...your-funded-wallet-key...",
+        "NUTRIREF_BASE_URL": "https://nutriref.xyz"
+      }
+    }
+  }
+}
+```
+
+`PAYER_PRIVATE_KEY` is the private key of a Base mainnet wallet holding USDC — the wallet pays for each tool call. Use a dedicated wallet funded only with what you're willing to spend. `NUTRIREF_BASE_URL` is optional and defaults to `https://nutriref.xyz`.
+
+## License
+
+MIT

nutriref_mcp-0.2.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+mcp_server/__init__.py,sha256=WsV7TMPncqJZoQwM-q4cytxkBf9woxn_Dld4gIgJ4dw,349
+mcp_server/__main__.py,sha256=9it1my_mM7xBpDh79QSi7FAvZD3Vki3GQFPJIDZw_zs,64
+mcp_server/server.py,sha256=7n9brAv_gB7dxm8msRNZxY074MuytWwZ1X3fQ6Dj79c,4446
+nutriref_mcp-0.2.2.dist-info/METADATA,sha256=8d14X77yUzhDmQu9YPMoLBvmpPEAmNHu6mbe1SnAri8,2418
+nutriref_mcp-0.2.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+nutriref_mcp-0.2.2.dist-info/entry_points.txt,sha256=7sk1JF2nsBdpE0aBnERR4XvHzprUVCLrxv4Q9g50nQw,49
+nutriref_mcp-0.2.2.dist-info/top_level.txt,sha256=R49ZBwHkJvJ-AJ8o9wy6MuCs0rvZpyCEuvdwhI4PpHs,11
+nutriref_mcp-0.2.2.dist-info/RECORD,,

nutriref_mcp-0.2.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

nutriref_mcp-0.2.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+nutriref-mcp = mcp_server:main

nutriref_mcp-0.2.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+mcp_server