Reference
REST /api/v1 and the MCP tools an agent sees via tools/list.
No initialize call needed. Run tools/list for each tool's input schema.
A tool call outside the key's scopes returns JSON-RPC -32003 with data.code "forbidden". Clerk sessions are not scope-checked. Id fields and id arrays must be UUIDs.
REST API
MCP Tools
Registered tools (MCP_TOOLS / listedTools()):
- whoami
- search_recipes
- get_recipe
- create_recipe
- import_recipe
- import_recipe_from_image
- delete_recipe
- get_household_context
- manage_household_schedule
- manage_household_settings
- manage_kitchen_invites
- manage_kitchen_members
- get_person_rules
- manage_people
- manage_person_rules
- manage_person_loves
- check_meal_plan
- export_shopping_list
- save_meal_plan
- get_meal_plan
- edit_meal_plan
- delete_meal_plan
- list_cookbooks
- get_cookbook
- manage_cookbook
- reorder_people