# Diet, Recipe & Allergen Data — agent instructions

Service ID: `nb:diet-recipe-allergen-data` · version 0.2.0 · status **Beta** · consumable: **true**

Structured original recipes with deterministic serving scaling, declared dietary tags and jurisdiction-aware ingredient allergen tags for developer workflows.

> **Public beta.** Use the live REST API with `payment=false` for up to five free preview requests per minute per client IP. Paid routes use x402 Base Sepolia testnet.

## REST routes
- `GET https://27r6c27lk00cr97y.7dn.lambda-web.eu-west-2.on.aws/v1/recipes?q=tomato&diet=vegan&servings=4&jurisdiction=GB&payment=false` — free search preview and scale recipe ingredients.
- `GET https://27r6c27lk00cr97y.7dn.lambda-web.eu-west-2.on.aws/v1/recipes/{recipe_id}?servings=4&jurisdiction=US&payment=false` — retrieve one exact recipe with a jurisdiction-scoped allergen taxonomy.

Allergen tags describe listed ingredients only. US and GB tags are not label verification and do not establish safety or account for cross-contact, packaged products, substitutions or preparation conditions. Do not use the result as medical advice.

## Does not do
- medical or nutrition advice
- calorie or nutrient values
- a guarantee that a recipe is safe for an allergy
- cross-contact or packaged-product verification
- user-submitted recipe parsing
- verified nutrient totals for finished recipes
- food-safety or medical advice

## Connection
- Endpoint: https://27r6c27lk00cr97y.7dn.lambda-web.eu-west-2.on.aws
- Transport: http-rest
- Auth: none
- Manifest: /manifests/diet-recipe-allergen-data/0.2.0.json

## Tools

| Tool | Built | Read-only | Price |
|---|---|---|---|
| `recipe_search` | yes | yes | 0.005 USDC per call [x402-exact, not approved] |
| `recipe_get` | yes | yes | 0.005 USDC per call [x402-exact, not approved] |

## Data
- Coverage: Nine original recipe records with ingredient quantities, preparation steps, declared diet tags, jurisdiction-aware ingredient allergen tags and deterministic serving scaling.
- Freshness: Versioned static recipe data; records change only when a dataset version is released.
- Document schema: `/schemas/diet-recipe-data-v2.json`
- Sources:
  - Niftibot original recipe collection (Original Niftibot content; redistribution terms pending review)

## Limitations
- The dataset is a small original collection, not a general recipe index
- Ingredient tags describe the listed ingredients only; they do not establish allergen safety or account for cross-contact, brands, substitutions or preparation conditions
- US and GB tags reflect listed ingredient categories, not regulatory label review
- Diet tags are metadata, not medical or nutritional advice
- Ingredient scaling is arithmetic only and does not guarantee cooking-time, texture or equipment adjustments
- Nutrition facts are served separately by Health & Nutrition Facts and are not calculated for finished recipes

## Rights
- Status: unreviewed
- Attribution: Recipe and ingredient records: Niftibot original content; publisher terms for redistribution are pending confirmation

## Open readiness blockers
- Publisher terms for redistribution of original recipe content are pending confirmation.

See also: /agents/payments.md · /agents/security.md · /agents/licensing.md