# Assist With Food

> A private kitchen notebook the person's AI can read, add to and use again: foods, places and dated prices, recipes and their versions, what was eaten, comparisons, lists and research. Connect at https://www.assistwithfood.com/mcp with the person's sign-in.

## For your AI

- [The full guide](https://www.assistwithfood.com/ai.txt): how to connect, the vocabulary, a normal job, writes, recovery, and every tool.

## Start and orient

- food_get_workspace_overview (read): Start here once per conversation.
- food_list_queue (read): What the person has asked for, a page at a time, newest first: waiting, working or answered, or only the items that need their input.
- food_manage_connection (write): See what this AI connection may do, or give some of it back.

## Find before creating

- food_search (read): Find records by name in the person's own words, across every kind or the kinds you name.
- food_find (read): Page through one kind of record, newest first, optionally narrowed by one filter.
- food_list_library (read): The Library's shelves, a page at a time: research (long findings), sources (where things came from), instructions (the person's research approaches and prompts).

## Read in depth

- food_get_records (read): Read up to 20 records by ref, each with what it links to: a Food's kinds, components and recipes; a Place's offerings; an offering's latest dated prices; a Recipe's current versions; a version's ingredients and equipment; a visit's entries; a Comparison's candidates and price ranking; a List's entries.

## Record the food world

- food_save_foods (write): Create Foods, or change them by ref with expectedVersion.
- food_save_links (write): Say what kind of food something is (kind_of), what it is made of (made_of), or which recipe makes it (recipe_for) — three different links, never folded into one — or unlink one.
- food_save_places (write): Create Places — anywhere the person gets food — or change them by ref with expectedVersion.
- food_save_offerings (write): Say that a Place sells a Food or Resource, under its own label.
- food_save_observations (write): Record dated prices, availability and menu facts — twenty grocery prices are one call.
- food_save_resources (write): Create or change Resources: the kitchen's cookware, appliances and tools.
- food_save_sources (write): Create or change Sources: the menu, label, listing, receipt, person or publication a fact came from.

## Cooking

- food_save_recipes (write): Create a Recipe — the continuing identity of a preparation — or change its title and note.
- food_save_recipe_versions (write): Add a new Version of a Recipe, or correct a version's label, state, yield or note.

## What was eaten

- food_save_experiences (write): Record what actually happened: a visit or meal with its food entries in one item (a dinner where two people ate two dishes is one visit with two entries), a cook, a purchase or a tasting.

## Decide with the person

- food_save_comparisons (write): Set up a Comparison — foods, a whole order at each place, recipes, places or equipment — with its criteria and candidates, or add candidates to one.
- food_suggest_preference (write): Propose a Preference for the person to adopt or decline.

## Organize

- food_save_lists (write): Create Lists (a dated List is a plan: this week's dinners), change them, and add, tick or remove entries.
- food_save_library_items (write): Put long research on the Library's shelves (research, sources, instructions), edit it, or take it off a shelf and back.
- food_save_people (write): Record the people the person feeds and their strict food facts.
- food_save_topics (write): Create or change Topics: techniques, cuisines and food science, each a short summary with links.

## Photos and files

- food_begin_upload (write): Step 1 of 2 for photos, PDFs (menus, receipts) and voice notes.
- food_finish_upload (write): Step 2 of 2, the only way a file is saved: once every byte is PUT, Food checks length, SHA-256, type and that it opens, then saves it with your name on it, on the records you named.
- food_get_media_batch (read): See photos, PDFs and voice notes themselves, as images, audio or an embedded PDF.
- food_attach_media (write): Put a file on another record: a menu photo on the Place and the Comparison, a receipt on the visit.
- food_set_media_captions (write): Set or change a file's caption, with the expectedVersion you read.

## Queue work

- food_add_to_queue (write): When the person asks for something mid-conversation that should wait, add it to their Queue, marked as added by you.
- food_update_queue (write): Take a Queue item: mark it working, answer it (name the records you saved), or ask the person for what you need.