Get information about the connected Meticulous espresso machine including model, firmware version, serial number, and build info

Get current machine settings including auto preheat, sounds, timezone, and other configurable parameters

Update a specific machine setting. Use get_settings first to see available settings and their current values.

Get the current real-time status of the machine including sensor data (pressure, flow, weight, temperature), machine state (idle/brewing/etc), and current profile

Execute an action on the machine such as start brewing, stop, tare the scale, or preheat

List all saved espresso extraction profiles with their names and basic info

Get the full details of a specific espresso profile including all extraction parameters and steps

Load a specific profile to be used for the next espresso extraction. The machine will use these settings when brewing starts.

Get the profile that was most recently loaded, including when it was loaded

Get the JSON schema for creating custom espresso extraction profiles. Use this to understand the structure before creating a new profile with save_profile.

Save a new espresso extraction profile to the Meticulous machine. Use get_profile_schema first to understand the required format. The profile will be available immediately on the machine.

Start brewing espresso using the currently loaded profile. Make sure the machine is ready and a profile is loaded before calling this.

Stop the current brewing operation immediately. Use this if something goes wrong or to manually end the extraction.

Zero/tare the built-in scale. Call this after placing your cup on the drip tray before starting a brew.

Start preheating the group head to the target temperature. This helps ensure consistent extraction temperatures.

Reset the machine state, useful if the machine is in an error state

Search and list espresso shots with optional filters. Returns lightweight results by default. Use get_shot_details to get full timeseries data for a specific shot.

Get full details for a specific shot by ID, including complete timeseries data (pressure, flow, weight, temperature over time). Use search_shot_history first to find shot IDs.

Get summary information about the most recent espresso shot. Returns metadata and profile info without full timeseries. Use get_shot_details with the returned ID for full data.

Get information about the currently brewing shot. Returns brewing status and live data if a shot is in progress.

Get aggregate statistics about your espresso shots including total shots and usage by profile

Rate a shot as like or dislike, or remove the rating