# Mealary

> Nutrition analysis and FDA Nutrition Facts label generation, computed from the
> authoritative USDA FoodData Central database. Type a recipe, get per-serving
> nutrition, %DV, allergens and a print-ready FDA label. Built for humans and agents.

Base URL: https://mealary.com
API base: https://mealary.com/api/v1
Auth: single API key — `Authorization: Bearer <key>` or `x-api-key: <key>`.
Public sandbox key (no signup, real data, rate-limited): `mly_test_sandbox`

## Why agents call Mealary
- Deterministic FDA 21 CFR 101.9 rounding + 2016 Daily Values — not an LLM guess.
- Every value cites a USDA FoodData Central id (verifiable, GEO-grade sources).
- Structured errors, idempotency keys, clear rate limits, an inspectable request log.
- Usage-metered pricing so an agent can decide programmatically whether to call.

## Tools / endpoints
- POST /api/v1/analyze — recipe -> per-serving nutrition facts + allergens + sources.
- POST /api/v1/label — recipe -> FDA Nutrition Facts panel (SVG). Free = watermarked.
- GET  /api/v1/foods/search?q= — search USDA foods (fdcId + description).
- GET  /api/v1/foods/{fdcId} — full per-100g nutrient profile for a USDA food.

## MCP
- Streamable-HTTP MCP server: https://mealary.com/api/mcp
- Tools: analyze_recipe, generate_label, search_foods, get_food

## Example (cURL)
curl -X POST https://mealary.com/api/v1/analyze \
  -H "Authorization: Bearer mly_test_sandbox" \
  -H "content-type: application/json" \
  -d '{"ingredients":["2 cups all-purpose flour","1 cup sugar","2 large eggs"],"servings":12}'

## Pricing (machine-readable)
- Free: 100 calls/month, nutrition analysis + watermarked label preview.
- Pro ($29/mo): 10,000 calls/month, clean FDA label export (PDF/PNG/SVG), metered
  overage $0.01/call, unlimited saved recipes. See https://mealary.com/pricing
- OpenAPI: https://mealary.com/openapi.json

## Data source & disclaimer
Nutrient data: U.S. Department of Agriculture, FoodData Central (https://fdc.nal.usda.gov).
Mealary is a computation tool; verify labels against your final formulation before print.