Brewers MCP Server

Brewing knowledge MCP — beer styles, ingredients, off-flavours, water chemistry, recipes

Local serverstdio

What is the Brewers MCP server?

Brewing knowledge MCP — beer styles, ingredients, off-flavours, water chemistry, recipes. The brewers mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 6 defined tools rather than through you.

What it actually does

Adding it to your client

brewers-almanack on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Its toolset

Everything the assistant can do here goes through one of these:

  • search_styles — Search 85 BJCP beer styles by name, category, or characteristics. Returns vital statistics, overall impression, ingredients, and commercial examples
  • search_ingredients — Search hops, malts, yeasts, and adjuncts by name, type, or characteristic. Filter by category or search across all
  • diagnose_off_flavour — Identify off-flavours from taste or aroma descriptions. Returns the likely compound, causes, prevention steps, and styles where it may be acceptable
  • match_water_profile — Find brewing water profiles by city name or beer style. Returns mineral composition (Ca, Mg, Na, Cl, SO4, HCO3) and style recommendations
  • suggest_recipe — Generate a recipe for a target beer style. Returns grain bill, hop schedule, yeast selection, water profile, and process parameters
  • pairing_guide — Beer and food pairing suggestions. Search by beer style or dish name. Returns matches with complement, contrast, and cleanse principles

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the brewers mcp server does with a few real requests.

When to reach for it

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Brewers's toolset — search_styles, search_ingredients, diagnose_off_flavour and 3 more — is a fair guide to whether it matches your workflow. It is maintained by gregario; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
search_stylesSearch 85 BJCP beer styles by name, category, or characteristics. Returns vital statistics, overall impression, ingredients, and commercial examples.
search_ingredientsSearch hops, malts, yeasts, and adjuncts by name, type, or characteristic. Filter by category or search across all.
diagnose_off_flavourIdentify off-flavours from taste or aroma descriptions. Returns the likely compound, causes, prevention steps, and styles where it may be acceptable.
match_water_profileFind brewing water profiles by city name or beer style. Returns mineral composition (Ca, Mg, Na, Cl, SO4, HCO3) and style recommendations.
suggest_recipeGenerate a recipe for a target beer style. Returns grain bill, hop schedule, yeast selection, water profile, and process parameters.
pairing_guideBeer and food pairing suggestions. Search by beer style or dish name. Returns matches with complement, contrast, and cleanse principles.

How to install the Brewers MCP server

{
  "mcpServers": {
    "brewers-almanack": {
      "command": "npx",
      "args": ["-y", "brewers-almanack"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Example prompts to try

  • Use Brewers to search styles.
  • Use Brewers to search ingredients.
  • Use Brewers to diagnose off flavour.

Frequently asked questions

It connects Brewers to MCP-compatible AI assistants such as Claude and Cursor, exposing 6 tools (search_styles, search_ingredients, diagnose_off_flavour, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Brewers directly.