Append a new entry to the espresso shot diary. Call this after each shot to log tasting notes, grinder setting, yield, and observations. Use Markdown formatting matching the diary style.

Delete a profile from the machine's internal storage by UUID.

Send a control action to the machine. Actions: 'start' (begin shot), 'stop' (abort shot), 'continue' (resume), 'reset' (reset machine state), 'tare' (tare scale), 'preheat' (start heating), 'calibration' (run calibration), 'scale_master_calibration'.

Fetch all profiles stored on the machine with full details (all stages, dynamics, triggers). Use this when you need to inspect or compare complete recipes.

Get data for the shot currently being brewed (returns null if no shot is in progress). Defaults to a compact summary to avoid huge responses.

Get the built-in factory profiles and community profiles that ship with the machine. Good starting points for recipe creation or modification.

Get hardware info about the Meticulous machine: firmware version, model, serial number, software version, and current status.

Get the saved grinder model and setting for one or all profiles. Call this at the start of a session to recall where you left off.

Get the most recently loaded (active) profile on the machine, along with the time it was last loaded.

Get the most recently completed shot. Defaults to a compact summary to avoid token overflow.

Get machine notifications (firmware updates, maintenance reminders, error messages).

Get the full details of a specific profile by its UUID.

Read the current machine settings (auto-preheat, auto-start shot, purge after shot, sounds, timezone, heating timeout, etc.). Optionally filter to a specific setting key.

Fetch shot data and profile for analysis. Defaults to compact output with a sampled trace to stay within chat context limits.

Get a listing of past espresso shots (metadata only). Shows shot name, time, profile used, and rating.

Get aggregate statistics: total shots pulled, shots per profile, and profile version counts.

List all espresso profiles (recipes) currently stored on the machine. Returns an array of profile identifiers with their names and IDs.

Load a profile JSON onto the machine as the active recipe (temporary — use save_profile to persist). Validates the schema before sending. Profile JSON must include: name (string), id (UUID v4), author (string), author_id (UUID v4), temperature (number, Celsius), final_weight (number, yield grams), previous_authors ([]), variables ([]), version (1), stages (array). Each stage needs: name, key, type ("flow"|"pressure"), dynamics.points ([[time,value],...] starting at [0,x]), dynamics.over ("time"), dynamics.interpolation ("linear"|"curve"), exit_triggers (array). Last stage must exit on {type:"weight", value:<final_weight>}.

Activate an existing profile on the machine by its UUID (profile must already be saved on the machine).

Rate a completed shot as 'like', 'dislike', or null (remove rating). Use db_key from shot history.

Read the full espresso shot diary. Call this at the start of a session to recall past shots, tasting notes, and dial-in history.

Permanently save a profile to the machine's internal storage. Validates the schema before saving. Profile JSON must include: name (string), id (UUID v4), author (string), author_id (UUID v4), temperature (number, Celsius), final_weight (number, yield grams), previous_authors ([]), variables ([]), version (1), stages (array). Each stage needs: name, key, type ("flow"|"pressure"), dynamics.points ([[time,value],...] starting at [0,x]), dynamics.over ("time"), dynamics.interpolation ("linear"|"curve"), exit_triggers (array). Last stage must exit on {type:"weight", value:<final_weight>}.

Search for historical versions of profiles by name. Useful for finding old recipe iterations.

Search shot history with flexible filters. All parameters are optional.

Save the grinder model and setting for a profile. Call this whenever you change your grind size so Claude remembers it next session.

Update an existing profile in place by ID. Fetches the current profile, merges your changes on top, and saves back — preserving the profile image and avoiding duplicates. Pass only the fields you want to change in updates; everything else is kept from the existing profile.

Update one or more machine settings. Pass a partial Settings object with only the keys you want to change. Available keys: auto_preheat (number), auto_purge_after_shot (bool), auto_start_shot (bool), enable_sounds (bool), heating_timeout (number), partial_retraction (number), ssh_enabled (bool), update_channel (string).

Validate a recipe JSON against the Meticulous profile schema. Returns a list of errors if invalid. If auto_fix is true, automatically fills in simple missing fields (id, author_id, version, previous_authors, variables) — structural errors like missing stages must be corrected manually.