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

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'.

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.

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).

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

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 the full details of a specific profile by its UUID.

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

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

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:}.

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

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:}.

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

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

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

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 most recently completed shot. Defaults to a compact summary to avoid token overflow.

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

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

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

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.

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

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

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

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.

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

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.

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.