Tool-Referenz
Alle Tools des BrewForge-MCP-Servers und der Actions-API nach Toolset, direkt aus der API erzeugt.
Alle Tools des MCP-Servers und Actions der Actions-API, nach Toolset gruppiert. Die Referenz wird bei jedem Build der Doku aus der API erzeugt und passt deshalb immer zu dem, was der Server anbietet. Namen, Beschreibungen und Parameter sind die, die ein KI-Assistent sieht, und deshalb auf Englisch.
So liest du einen Eintrag
- lesen, schreiben oder löschend: ob das Tool nur liest, Daten ändert oder etwas löscht bzw. rückgängig macht. Löschende Tools ändern ohne
confirm: truenichts und liefern stattdessen eine Vorschau (Details). - Berechtigung: was ein API-Token braucht: diese Bereichs-Berechtigung oder die Sammel-Berechtigung
read/write. Per OAuth verbundene Apps habenreadoderwrite. - Tariffunktion: Das Tool braucht zusätzlich diese Funktion deines Tarifs; ohne sie antwortet es mit
TIER_REQUIREDund dem Tarif, der sie enthält. - Parameter: die JSON-Eingabe. Pflichtfelder sind markiert;
ingredients[].amount_gist ein Feld jedes Eintrags der Listeingredients. Einheiten stehen im Feldnamen (_sg,_c,_l,_g). - API-Referenz führt zur selben Action in der OpenAPI-Referenz, mit Ausgabeschema und Playground.
Getting started
Account, plan, units and enabled features; a map of the other toolsets. Always available. (1 Tool)
| Tool | Was es tut | Berechtigung |
|---|---|---|
get_started | Get started | lesen |
Brewing
Recipes and brews, brew day, fermentation readings, evaluations and devices. (33 Tools)
| Tool | Was es tut | Berechtigung |
|---|---|---|
find_brews | Find brews | lesenbrews:read |
get_brew | Get a brew | lesenbrews:read |
find_recipes | Browse the recipe book | lesenbrews:read |
create_brew | Create a recipe / brew | schreibenbrews:write |
update_recipe | Edit a brew's recipe | schreibenbrews:write |
update_brew | Rename, date, tag or pin a brew | schreibenbrews:write |
set_brew_status | Change a brew's status | schreibenbrews:write |
copy_brew | Brew again, new version or copy as new recipe | schreibenbrews:write |
share_brew | Turn a brew's share link on or off | schreibenbrews:write |
convert_imported_brew | Make an imported recipe editable | schreibenbrews:write |
import_recipe | Import a recipe (BeerXML or MMuM) | schreibenbrews:write |
export_brew | Export a brew (BeerXML, JSON, PDF sheets) | lesenbrews:read |
delete_brew | Delete a brew | löschendbrews:write |
get_brew_day_plan | Get the brew day plan | lesenbrews:read |
record_brew_measurements | Record brew day measurements | schreibenbrews:write |
deduct_brew_ingredients | Deduct a brew's ingredients from stock | schreibeninventory:write |
log_fermentation_reading | Log a fermentation reading | schreibenbrews:write |
get_fermentation | Get fermentation status and readings | lesenbrews:read |
delete_fermentation_readings | Delete fermentation readings | löschendbrews:write |
plan_carbonation | Plan carbonation (priming sugar or keg pressure) | schreibenbrews:write |
save_brew_note | Add or edit a brew note | schreibenbrews:write |
list_brew_notes | List a brew's notes | lesenbrews:read |
delete_brew_note | Delete a brew note | löschendbrews:write |
set_brew_custom_fields | Set custom field values on a brew | schreibenbrews:write |
rate_brew | Rate a brew (quick star rating) | schreibenbrews:write |
save_scoresheet | Fill in a BJCP or Lagerbernd scoresheet | schreibenbrews:write |
list_evaluations | List a brew's ratings and scoresheets | lesenbrews:read |
delete_evaluation | Delete a rating or scoresheet | löschendbrews:write |
set_evaluation_link | Turn the public evaluation link on or off | schreibenbrews:write |
list_devices | List fermentation devices | lesenbrews:read |
add_device | Add a fermentation device | schreibenbrews:write |
update_device | Attach a device to a brew or change its settings | schreibenbrews:write |
delete_device | Delete a device | löschendbrews:write |
Cellar
Cellar vessels, packaging, packaged stock, tap lists and labels. (23 Tools)
| Tool | Was es tut | Berechtigung |
|---|---|---|
get_cellar | Cellar overview: what is in which vessel | lesencellar:read |
save_stay | Put a beer in a vessel, or change a stay | schreibencellar:write |
end_stay | Empty a vessel today (end a stay) | schreibencellar:write |
plan_brew_cellar | Plan a brew's path through the cellar | schreibencellar:write |
move_brew_day | Move a brew day and its planned cellar stays | schreibenbrews:write |
save_cellar_vessel | Add or edit a vessel or bottle/can container | schreibencellar:write |
delete_cellar_item | Delete a stay, vessel or container | löschendcellar:write |
get_packaging_context | Before packaging: volume, free kegs, bottles | lesencellar:read |
package_beer | Package beer into kegs, bottles or cans | schreibencellar:write |
get_beer_stock | Beer on hand: kegs, bottles and cans | lesencellar:read |
update_keg | Update a keg: litres left, pour, empty, sensor | schreibencellar:write |
update_bottle_stock | Change bottle/can stock | schreibencellar:write |
undo_stock_change | Undo a keg or bottle stock change | schreibencellar:write |
get_taplist | Tap lists: beers, taps, menus and screens | lesencellar:read |
save_tap_list | Create or edit a tap list | schreibencellar:write |
save_taplist_beer | Add a beer to a tap list, or change it | schreibencellar:write |
manage_tap | Taps: put a beer on, next up, add/rename taps | schreibencellar:write |
manage_taplist_sharing | Menus, TV screens and guest links of tap lists | schreibencellar:write |
delete_taplist_item | Delete a tap list, beer, tap, menu or screen | löschendcellar:write |
get_labels | Label templates and the label text of brews | lesencellar:read |
save_label_template | Create, edit or copy a label template | schreibencellar:write |
delete_label_template | Delete a label template | löschendcellar:write |
set_trmnl_screen | Choose what a TRMNL e-ink screen shows | schreibencellar:write |
Inventory
Ingredient stock, ingredient catalog, packages, orders and the planner (what am I short of). (16 Tools)
| Tool | Was es tut | Berechtigung |
|---|---|---|
find_stock | Find ingredient stock | leseninventory:read |
add_stock | Add ingredient stock | schreibeninventory:write |
update_stock | Use up, correct or edit stock | schreibeninventory:write |
remove_stock | Remove a stock row | löschendinventory:write |
find_ingredients | Find ingredients | leseninventory:read |
save_custom_ingredient | Create or edit an own ingredient | schreibeninventory:write |
delete_custom_ingredient | Delete an own ingredient | löschendinventory:write |
get_ingredient_packages | List or open ingredient packages | leseninventory:read |
select_package_ingredients | Pick ingredients from a package | schreibeninventory:write |
get_orders | List orders or open one | leseninventory:read |
save_order | Create or edit an order | schreibeninventory:write |
edit_order_items | Add, change or remove order lines | schreibeninventory:write |
receive_order | Receive an order into stock | schreibeninventory:write |
delete_order | Delete an order | löschendinventory:write |
get_planner | Plan ingredients for planned brews | leseninventory:read |
create_order_from_shortages | Order what the planned brews are short of | schreibeninventory:write |
Setup
Profiles (equipment, mash, water, fermentation), styles, custom fields, preferences, calendar, analysis, calculators, imports and exports. (19 Tools)
| Tool | Was es tut | Berechtigung |
|---|---|---|
find_profiles | Find profiles | lesenprofiles:read |
get_profile | Get a profile with all settings | lesenprofiles:read |
create_profile | Create a profile | schreibenprofiles:write |
update_profile | Change a profile | schreibenprofiles:write |
delete_profile | Delete a profile | löschendprofiles:write |
apply_profile | Apply a profile to brews | löschendbrews:write |
find_styles | Find beer styles | lesenstyles:read |
save_style | Create or change an own style | schreibenstyles:write |
delete_style | Delete an own style | löschendstyles:write |
list_custom_fields | List custom field definitions | lesencustom-fields:read |
save_custom_field | Create, change or archive a custom field | schreibencustom-fields:write |
delete_custom_field | Delete a custom field for good | löschendcustom-fields:write |
get_preferences | Get preferences | lesensettings:read |
update_preferences | Change preferences | schreibensettings:write |
reset_preferences | Reset preferences to defaults | löschendsettings:write |
get_calendar | Brewing calendar | lesenbrews:read |
run_calculator | Run a brewing calculator | lesensettings:read |
list_imports | List import runs | lesensettings:read |
undo_import | Undo an import run | löschendsettings:write |
Community
Community feed and profiles, recipe sharing, feedback, support tickets, inbox and changelog. (20 Tools)
| Tool | Was es tut | Berechtigung |
|---|---|---|
browse_community | Browse the community feed or discover brewers | lesencommunity:read |
get_brewer_profile | Get a brewer's community profile | lesencommunity:read |
interact_with_brewer | Follow, unfollow, block or report a brewer | schreibencommunity:write |
cheer_brew | Cheer another brewer's beer | schreibencommunity:write |
update_community_profile | Update the community profile and shared recipes | schreibencommunity:write |
adopt_shared_recipe | Copy a shared recipe into the user's brews | schreibenbrews:write |
find_feedback_threads | Find feedback threads (feature requests, questions, roadmap) | lesencommunity:read |
get_feedback_thread | Read a feedback thread | lesencommunity:read |
post_feedback | Post a feature request, question or reply in Feedback | schreibencommunity:write |
edit_feedback_post | Edit the user's own Feedback post | schreibencommunity:write |
delete_feedback_post | Delete the user's own Feedback post | löschendcommunity:write |
react_to_feedback | Vote, follow, accept an answer or report in Feedback | schreibencommunity:write |
answer_feedback_questionnaire | Answer a feedback questionnaire | schreibencommunity:write |
contact_support | Report a problem to support, or reply on a ticket | schreibencommunity:write |
get_inbox | Inbox: support tickets, team messages and notifications | lesencommunity:read |
mark_inbox_read | Mark inbox items as read or archive messages | schreibencommunity:write |
get_changelog | What's new in BrewForge | lesencommunity:read |
get_account_overview | Plan, limits, bounty points and referrals | lesencommunity:read |
redeem_bounty_code | Redeem a bounty code | schreibencommunity:write |
export_my_data | Export the user's account data (JSON) | lesenread |
Actions-APIPro
Die Actions-API von BrewForge: aufgabenbezogene Actions wie log_fermentation_reading oder package_beer per HTTP, mit Übersicht, Verweisen per Name, kanonischen Einheiten, Bestätigung beim Löschen und Fehlern, die erklären, was zu tun ist.
Tools: Erste Schritte
Alle Tools des Toolsets core im BrewForge-MCP-Server und in der Actions-API, mit Zugriff, Berechtigung, Tariffunktion und Parametern.