Tools: Keller
Alle Tools des Toolsets cellar im BrewForge-MCP-Server und in der Actions-API, mit Zugriff, Berechtigung, Tariffunktion und Parametern.
Kellerbehälter, Abfüllung, abgefüllter Vorrat, Taplisten und Etiketten. Jedes Tool hier ist ein MCP-Tool auf https://brewforge.sh/api/mcp?toolsets=cellar und eine Action unter POST /api/v1/actions/<name>. Die Seite wird aus der API selbst erzeugt; Namen, Beschreibungen und Parameter sind deshalb auf Englisch. Wie du sie liest, steht in der Tool-Referenz.
get_cellar
Cellar overview: what is in which vessel
Shows the brewer's cellar vessels (fermenters, tanks, kegs) with what is in each today, the stays (planned or current) in a date window, and when each vessel is free. Use it for 'what's in the cellar?', 'what is free next week?' (from/to = that week; free_vessels are free all week, free_from/free_until show vessels free for part of it), or to find stay ids for save_stay / end_stay. Filter with vessel or brew. A stay is one beer in one vessel from start_date to end_date (end exclusive; no end = until ended). Volumes are in litres. Bottles/cans and keg volumes are in get_beer_stock.
Prop
Type
save_stay
Put a beer in a vessel, or change a stay
Create or change a stay (one beer in one cellar vessel for some days). Create: pass vessel and brew (or beer_name for a keg of beer that is not one of the brewer's brews), plus start_date (default today) and optionally end_date. A start_date in the future plans the stay. Change: pass stay (id, vessel name or brew) and only the fields to change; vessel moves it to another vessel. If new dates overlap later stays, nothing changes and the result has clash with would_push: show it to the user and call again with push: true to move those stays later. To fill kegs/bottles from a tank use package_beer; to empty a vessel today use end_stay. Volumes in litres; dates YYYY-MM-DD, end_date exclusive.
Prop
Type
end_stay
Empty a vessel today (end a stay)
Ends a current stay today, so the vessel is free from today on: the fermenter was emptied, the keg is finished. Use it for 'the keg of porter is empty' or 'I emptied Fermenter 1'. The stay stays in the history. A stay that has not started yet, or started today, cannot be ended: delete it with delete_cellar_item (kind: stay) instead. Packaging with package_beer already empties the source tank, so do not call this after packaging. Ending a keg returns an undo_token.
Prop
Type
plan_brew_cellar
Plan a brew's path through the cellar
Plans where a brew will sit in the cellar, as planned stays. Without steps it builds the plan from the brew's fermentation profile, like the app's 'Plan in cellar': one step per stage (primary, cold crash, conditioning ...) back to back from start_date (default: the brew day or planned brew day), each in the best free vessel that allows its role and holds the batch. Call with dry_run: true first to show the suggestion, then again without it to save. Pass steps to choose vessels and dates yourself. Saving replaces the brew's stays that have not started yet; stays that started are kept. Dates YYYY-MM-DD, end_date exclusive. For a single stay use save_stay; to move the brew day with its plan use move_brew_day.
Prop
Type
move_brew_day
Move a brew day and its planned cellar stays
Sets a brew's planned brew day (or, once brewed, its brew day) to another date and moves the brew's planned cellar stays by the same number of days, like changing the date on the brew page. Use it for 'push the saison brew day to Saturday'. Stays that already started never move. If the moved stays would overlap other beers' stays, nothing changes and the result has clash with would_push: show it, then call again with push: true to move those later too. date null clears the date (stays keep their dates). Dates YYYY-MM-DD. Brewed on another day than planned (set_brew_status says so)? Send align_to_brew_day: true instead of date: the planned stays move so the first one starts on the actual brew day, like the brew page's 'move the cellar plan' prompt (also works when that day is today).
Prop
Type
save_cellar_vessel
Add or edit a vessel or bottle/can container
Sets up the cellar. kind "vessel" = one named fermenter, tank or keg (e.g. "Fermenter 1", "Corny 3"); stays put beer in it. kind "container" = a pool of identical bottles, cans or small kegs counted by number (e.g. "0.5 L bottles", 48 owned). Omit ref to create; pass ref (id or exact name) to change only the fields you pass. Volumes in litres. Returns the saved item and, for a container, how many are filled and empty. Delete with delete_cellar_item.
Prop
Type
delete_cellar_item
Delete a stay, vessel or container
Deletes a stay (removes it from the cellar history entirely, e.g. a wrong or no longer wanted planned stay), a vessel, or a bottle/can container. To record that a vessel was emptied today, use end_stay instead (keeps the history). Vessels with current or planned stays and containers with stock cannot be deleted; the error says what to clear first. Without confirm: true it only shows what would be deleted.
Braucht confirm: true; ohne ändert sich nichts und die Antwort zeigt, was entfernt würde.
Prop
Type
get_packaging_context
Before packaging: volume, free kegs, bottles
Call before package_beer. Shows where the beer comes from and how many litres are there (available_l; estimate: true means it is the recipe's estimate), which kegs are free to fill (only free kegs can be used), and the bottle/can containers with how many empties are available. Pass brew (e.g. the brew's name) or from_vessel (e.g. a keg to move into bottles). Volumes in litres.
Prop
Type
package_beer
Package beer into kegs, bottles or cans
Records packaging day: beer from a brew (its tank, or straight from the brew) or from a vessel goes into kegs (litres each) and bottles/cans (counts), with loss in litres. Example: 'kegged the pale ale today: 19 L into Corny 1, 6 bottles of 0.5 L, half a litre lost' → {"brew":"Pale Ale","kegs":[{"keg":"Corny 1","volume_l":19}],"containers":[{"container":"0.5 L bottles","count":6}],"loss_l":0.5}. Call get_packaging_context first to see the litres available, the free kegs and the container names. Each keg becomes a serving stay holding its litres; bottles/cans add to stock; the source tank is emptied (source_empty) and the brew gets its packaging date. If packaged litres plus loss do not match what is available it still packages, and warnings says so (tell the user; pass available_l when the tank held more than shown). An overfilled keg is refused.
Prop
Type
get_beer_stock
Beer on hand: kegs, bottles and cans
Lists the packaged beer the brewer has: kegs on tap or ready (litres left, keg sensor), bottle/can stock lines (beer × container, count), and the containers with how many are owned, filled and empty. Use for 'how much porter is left?' or before update_keg / update_bottle_stock. Filter with beer (part of a beer name). Volumes in litres. Beer still in fermenters/tanks is in get_cellar.
Prop
Type
update_keg
Update a keg: litres left, pour, empty, sensor
Changes a keg that is on tap or ready (a current serving stay). action: set_volume = the real litres left (volume_l); pour = take litres out (pour_l, default 0.5; it lowers the litres left now: pours have no date or history, so an earlier pour is simply recorded now); free = the keg is empty and free from today; link_brew = a keg of a hand-typed beer belongs to one of the brewer's brews (brew); attach_sensor / detach_sensor = a keg scale or volume sensor (device) takes over / stops measuring the volume. Kegs with a sensor attached cannot be set by hand. Returns the keg and an undo_token (undo_stock_change). Filling kegs is package_beer; list kegs with get_beer_stock.
Prop
Type
update_bottle_stock
Change bottle/can stock
Changes the count of bottles or cans of a beer. action: adjust = add/remove some (delta, e.g. -3 after drinking three); set_count = the real count after counting (count); add = add stock by hand, e.g. bought cans or beer not packaged in BrewForge (container, beer, count; creates the line if needed); gone = bottles that left for good (given away, broken, one-way): lowers how many of the container are owned (container, count) — use adjust first to take them out of stock; link_brew = stock of a hand-typed beer belongs to one of the brewer's brews (beer = the typed name, brew). Point at stock with beer (brew name, batch number or typed name) and container (when the beer is in several), or line_id from get_beer_stock. Returns an undo_token.
Prop
Type
undo_stock_change
Undo a keg or bottle stock change
Takes back one change made by update_keg, update_bottle_stock or end_stay on a keg, using the undo_token that call returned (valid 15 minutes). It only undoes while nothing else changed that keg or stock line since; otherwise it says so and changes nothing.
Prop
Type
get_taplist
Tap lists: beers, taps, menus and screens
Shows the brewer's tap lists (the beers on offer in a taproom, at home or at an event). With one list (or list given): its beers, its taps with what is pouring and next up, the menus/screens showing it with their public URLs, guest add-links, and brews that could still be added. With several lists and no list: a summary of each list plus the menu and screen designs. Call it before manage_tap or save_taplist_beer to see names and ids.
Prop
Type
save_tap_list
Create or edit a tap list
Creates a tap list (the beers on offer somewhere: a taproom, the home bar, an event) or changes its settings. Omit list to create (name required); pass list (id or exact name) to change only the fields given. taps: n creates n taps with the list. Then add beers with save_taplist_beer, put them on taps with manage_tap, and share it with manage_taplist_sharing (a menu or screen link guests open to see the list).
Prop
Type
save_taplist_beer
Add a beer to a tap list, or change it
Adds a beer to a tap list or changes how it is shown. beer = one of the brewer's brews (name, batch number or id): added if it is not on the list yet, otherwise changed; its style, ABV, IBU come from the brew. name without beer = add a beer that is not one of the brewer's brews (a guest beer), with style/abv_pct/... typed in. beer + name = show it under another name. Override fields (style, abv_pct, ...) replace the brew's values on menus; null clears an override. available: false hides it without removing it; position moves it in the list (1 = first). Putting it on a tap is manage_tap; removing it is delete_taplist_item.
Prop
Type
manage_tap
Taps: put a beer on, next up, add/rename taps
Works with the taps of a tap list. action: put_on = the beer pours from this tap now; next_up = the beer comes on this tap next; promote = the next-up beer goes on now (keg changed); clear = nothing pours from the tap; clear_next_up; create = new tap (name); rename (name); enable / disable; move (position, 1 = first). Example: "put the porter on tap 2 and make the saison next up" = two calls: {"tap":"Tap 2","action":"put_on","beer":"Porter"} then {"tap":"Tap 2","action":"next_up","beer":"Saison"}. beer is a beer on the list or a brew (added to the list automatically). tap is the tap's name or id ("2" finds "Tap 2"). Returns all taps of the list.
Prop
Type
manage_taplist_sharing
Menus, TV screens and guest links of tap lists
Two different kinds of link. (1) A link guests OPEN TO SEE the list: kind menu (an online menu page, also printable as PDF) or kind screen (a TV display page); 'share my tap list' / 'a page guests can look at' = menu (create with list). (2) kind guest_link = a link where guests ADD THEIR OWN beers to the list (e.g. a bottle share); it does not show the list. Menus/screens are designs that can be shown on several lists, each with its own public URL. actions: create (name, template, optional list to show it on right away, title; screen: show taps/bottles/both), update (design: name/title/show), show_on (design + list), remove_from (design + list), activate / deactivate (screen on a list); guest_link: create (list, max_entries, expires_in_days) or revoke. Templates: menu classic, modern, brewery, taphouse-board, minimal; screen taproom, modern, chalkboard, taphouse-board. Colours, fonts and layout are edited in the app's design editor (not here). Returns the public URLs; menus also a PDF link to print.
Prop
Type
delete_taplist_item
Delete a tap list, beer, tap, menu or screen
Removes something from the tap lists: a whole list (with its beers, taps, guest add-links and the list's public menu/screen links; the menu/screen designs themselves stay), a beer from a list (it also leaves its tap), a tap, or a menu/screen design (its public URLs stop working). To hide a sold-out beer without removing it, use save_taplist_beer with available: false; to take a beer off a tap, manage_tap action clear. Without confirm: true it only shows what would be deleted.
Braucht confirm: true; ohne ändert sich nichts und die Antwort zeigt, was entfernt würde.
Prop
Type
get_labels
Label templates and the label text of brews
Bottle/cap label templates and what they print. No input: the templates (name, size in mm, shape). template: that template's elements (text with {{placeholders}}, positions in mm). brew: the values the placeholders print for that brew (name, style, abv, ibu, og, fg, batch, brewer, brew_date, packaging_date), formatted in the brewer's units and language. Printing happens in the app (Labels page); this tool reads and save_label_template edits.
Prop
Type
save_label_template
Create, edit or copy a label template
Creates or changes a bottle/cap label template. Omit template to create (name; size default 19×19 mm round with the beer name and style). Pass template (id or name) to change only the given fields; elements replaces all elements. duplicate: true copies the template (name = the copy's name). Sizes in mm (5-100); text elements use placeholders like {{name}} that print each brew's values (see get_labels).
Prop
Type
delete_label_template
Delete a label template
Deletes a label template (printed labels are not affected). Without confirm: true it only shows which template would be deleted.
Braucht confirm: true; ohne ändert sich nichts und die Antwort zeigt, was entfernt würde.
Prop
Type
set_trmnl_screen
Choose what a TRMNL e-ink screen shows
Sets what a connected TRMNL e-ink display shows: show fermentation (one fermenting brew's gravity and temperature; brew) or stock (beer on hand; stock_display text or icons). Call without show/brew/stock_display to list the connected screens and their settings. Connecting a TRMNL device happens on trmnl.com, not here.
Prop
Type
Tools: Brauen
Alle Tools des Toolsets brewing im BrewForge-MCP-Server und in der Actions-API, mit Zugriff, Berechtigung, Tariffunktion und Parametern.
Tools: Bestand
Alle Tools des Toolsets inventory im BrewForge-MCP-Server und in der Actions-API, mit Zugriff, Berechtigung, Tariffunktion und Parametern.