Skip to main content
Brewgravity ships an MCP server. Point an MCP client at it and the assistant can read and edit your recipes, run brewing calculations, and log fermentation readings, using the same API and the same ownership rules as everything else. This is different from the in-app AI assistant: that one lives in Brewgravity’s chat panel, this one brings your data into whatever client you already work in.

​
Setup

1

Create an API key

Follow Authentication. The MCP server authenticates as you, with your key.
2

Add the server to your client

For Claude Desktop, add this to your MCP configuration:
3

Restart the client

The Brewgravity tools appear once the server connects.
GRAVITY_API_URL defaults to http://localhost:8787, which is the local development API. Set it to https://brewgravity.com to work against your real data.

​
Tools

list_recipes · get_recipe · get_recipe_stats · create_recipe · update_recipe · delete_recipePlus add, update, and delete for fermentables, hops, yeasts, and mash steps.
list_brew_sessions · get_brew_session · create_brew_session · update_brew_session · delete_brew_sessionBrew day steps: add_brew_step · update_brew_step · delete_brew_stepFermentation: log_fermentation · list_fermentation_logs · update_fermentation_log · delete_fermentation_log
list_inventory · search_inventory · get_inventory_item · add_inventory_item · update_inventory_item · delete_inventory_item
calc_og · calc_ibu · calc_volumes · calc_strike_water · calc_mash_schedule · calc_priming_sugar · calc_forced_carbonation · predict_fg · analyze_fermentation · analyze_water · water_profiles · srm_color · hop_character · bugu_ratioThese run locally against Brewgravity’s brewing library and need no API call, so they work even without a key.
recipe_preview — the structured tasting and style analysis described in AI assistant.

​
Prompts

Two prepared prompts ship with the server:

recipe_consultant

Recipe design advice — style guidelines, ingredient selection, process parameters. Takes an optional target style and your question.

brew_day_assistant

Live brew day help — strike water, timing, gravity checks, and troubleshooting. Takes an optional recipe id and the problem you are having.

​
What it can do to your data

The MCP tools are not read-only. delete_recipe deletes a recipe; update_hop changes a hop. There is no confirmation step at the protocol level, so the guardrail is your client’s — most MCP clients ask before running a tool, and it is worth leaving that setting on.
Deletions made through MCP are not covered by the app’s undo history, which is local to a browser session. Before letting an assistant reorganise your library, pull a copy of your recipes with the script in Exporting.