Your roast history, in your AI agent

Dashboard get_dashboard

Overview of your roasting setup as markdown: roasting style preference, gear, active cellar, green coffee inventory and your 5 most recent roasts. Start here.

List green coffees list_green_coffees

Your green coffee inventory: every bean with origin, process, purchase details and grams remaining.

Get green coffee get_green_coffee

One green coffee from your inventory by id.

Roast context for a bean get_roast_context

A briefing on one green coffee as text: its roast history, how those roasts were received, similar good roasts and candidate roast profiles.

List roasts list_roasts

Your roasts, newest first, as { total, items }. Optionally filter by green coffee or status. Paginated: limit defaults to 20 (max 50), offset to 0. Roast logs and notes are not included; use get_roast for one roast.

Get roast get_roast

One roast by id: weights, key metrics, the roast log fingerprint, automatic diagnostics and your cup notes. The raw log is never returned.

Roast analytics for a bean get_roast_analytics

One comparison row per finished roast of a green coffee: profile, level, weight loss, drop temperature and tasting result.

List roast profiles list_roast_profiles

The Kaffelogic roast profiles known to the app (no curves), whether you have used each, plus profile codes you use that are not in the registry.

Supply forecast get_supply_forecast

How much roasted coffee is ready or resting, when stock runs out, when to roast next and how much green to use, with the settings behind it.

List cellar list_cellar

Your cellar as one summary per coffee (scope active, archived, consumed or all): name, roaster, origin, current recipe, brew count and flags. No brew history.

Get cellar entry get_cellar_entry

One cellar entry by id with its current recipe, your most recent brew iterations (iterationLimit defaults to 20, max 50), the total iterationCount and your cup notes.

List gear list_gear

Your brewing gear: grinders, brewers, kettles and which is the default.

Search coffees search_coffees

Find in-stock coffees in the catalogue by name (query, at least 2 characters; limit defaults to 10, max 25). Returns id, name, roasterName, origin, process and roastType. Use the id with add_coffee_to_cellar.

Get guide get_guide

The BrewedLate domain guides as markdown. name roast-profile-selection: how to choose a Kaffelogic profile and level and adjust after a roast; read it before proposing a roast. name brewing-reference: grinder ranges, process and origin patterns, recipe scaling and troubleshooting.

Add green coffee add_green_coffee

Add a green coffee to your inventory. Remaining grams start at weightGrams.

Update green coffee update_green_coffee

Change fields of one green coffee by id, including its roast goals (targetRoastLevel, targetFlavorProfile, roastGoals).

Plan a roast plan_roast

Save a planned roast for one green coffee. Does not use up green coffee until the plan becomes a roast (update_roast). profileCode must be a code from list_roast_profiles or one you have used. Roast level is the Kaffelogic scale, 1.0 to 5.0, where higher is darker (2.4 is darker than 2.2). greenWeightGrams defaults to 120 or what remains, whichever is less.

Log a roast log_roast

Record a roast you have done (status roasting, resting or ready; default ready). Deducts greenWeightGrams from the green coffee, and fails if less remains. profileCode, when given, must be a code from list_roast_profiles or one you have used. Roast level is the Kaffelogic scale, 1.0 to 5.0, where higher is darker (2.4 is darker than 2.2).

Update a roast update_roast

Change fields of one roast by id. Moving a planned roast to roasting, resting, ready or consumed makes it a real roast and deducts its green weight once. profileCode, when given, must be a code from list_roast_profiles or one you have used. Roast level is the Kaffelogic scale, 1.0 to 5.0, where higher is darker (2.4 is darker than 2.2).

Add roast to cellar add_roast_to_cellar

Add one roast to your cellar. Repeating the call returns the cellar entry already made for that roast.

Add cup note add_cup_note

Record how a roast or cellar coffee tasted: a score 1-100, notes, a result (good or fault, with fault types) and brew method. Needs roastBatchId or cellarEntryId.

Update cup note update_cup_note

Change one of your cup notes by id.

Update supply settings update_supply_settings

Change the settings behind the supply forecast: dailyConsumptionGrams, restDays, targetBufferDays. At least one.

Set roasting preference set_roasting_preference

Replace your roasting style preference, the free text shown in get_dashboard and used when planning roasts.

Add coffee to cellar add_coffee_to_cellar

Add a coffee to your cellar: either coffeeId from search_coffees (repeating the call returns the entry already made) or coffee, a described coffee not in the catalogue (name required). Pass exactly one. Returns the cellar entry; its id is the cellarEntryId for record_brew.

Record a brew record_brew

Log a brew on one cellar entry: the recipe used, optional notes and score (1-100) which become a cup note, optional negative feedback. A brew logged without feedback becomes the entry's current recipe and may be published as a public recipe, as on the site.

Set cellar entry state set_cellar_entry_state

Set one cellar entry to active (in the cellar), archived (put away) or consumed (bag finished). Nothing is deleted.