# Cook Together (recipes.kapps.dev)

> Family recipes to cook with kids, gluten-free and vegan first, in English, Hebrew (/he) and European Portuguese (/pt). Every recipe is open data: CC0 (public domain) unless the recipe says otherwise. Fork any recipe to make your own version.

## Read (no key)
- https://recipes.kapps.dev/api/recipes?q=banana&gf=1&vegan=1&lang=en  search, JSON
- https://recipes.kapps.dev/r/<slug>.json  one recipe, all languages, JSON
- https://recipes.kapps.dev/sitemap.xml  every listed recipe

## Write (Authorization: Bearer <key>, made at https://recipes.kapps.dev/me)
- MCP: https://recipes.kapps.dev/mcp (Streamable HTTP). Tools: search_recipes, get_recipe, create_recipe, fork_recipe, update_recipe, ai_write_recipe, make_diet_version, ai_change_recipe
- REST: POST /api/recipes, PUT /api/r/<slug>, POST /api/r/<slug>/fork, POST /api/ai/write, POST /api/r/<slug>/ai

## Recipe document
{"emoji":"🍌","course":"snack","difficulty":1,"prep_min":5,"cook_min":0,"servings":2,"gf":1,"vegan":1,"vegetarian":1,"dairy_free":1,"nut_free":1,"texts":{"en":{"title":"Frozen banana pops","summary":"Bananas on sticks, dipped and frozen.","ingredients":[{"q":2,"i":"bananas"},{"q":2,"u":"tbsp","i":"cocoa powder"}],"steps":[{"t":"Peel the bananas and push a stick into each half."},{"t":"Roll in cocoa and freeze for 2 hours.","min":120}],"tips":""}}}
Step flags f: knife, hot, oven, blender, boil (a grown-up is needed). Ingredient "check": true = may contain hidden gluten.

Docs: https://recipes.kapps.dev/developers