What beer style data does it include?

It includes 85 BJCP 2021 beer styles with vital statistics, overall impressions, ingredients, and commercial examples.

Can it help diagnose brewing problems?

Yes. The diagnose_off_flavour tool maps taste or aroma descriptions to likely compounds, causes, prevention steps, and styles where the flavour may be acceptable.

Which brewing water details are returned?

The match_water_profile tool returns calcium, magnesium, sodium, chloride, sulfate, and bicarbonate values, along with style recommendations.

Brewers Almanack

Q: Can it create a complete beer recipe?

Yes. The suggest_recipe tool returns a grain bill, hop schedule, yeast selection, water profile, and process parameters for a target style.

brewingbeerrecipesfood-pairingwater-chemistry

MCP server for beer styles, brewing ingredients, water profiles, off-flavour diagnosis, recipes, and food pairings.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

We couldn’t automatically confirm this listing starts correctly

The install command below started, but didn't respond the way we expected when we tried to talk to it.

npx -y brewers-almanack

initialize succeeded but no response to tools/list.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

Brewers Almanack provides embedded brewing data through six MCP tools. Use it to research BJCP beer styles, select ingredients, diagnose brewing problems, build recipes, evaluate water profiles, or find beer and food pairings. It runs locally with no API keys or network dependencies.

Use cases

Search BJCP beer styles by name, category, or characteristics

Find hops, malts, yeasts, and adjuncts by brewing characteristics

Diagnose off-flavours from taste or aroma descriptions

Generate recipes for target beer styles

Match brewing water profiles and food pairings

Key features

Searches 85 BJCP 2021 beer styles

Searches 113 hop varieties plus malts, yeasts, and adjuncts

Identifies likely off-flavour compounds, causes, and prevention steps

Returns mineral compositions for 20 water profiles

Generates grain bills, hop schedules, yeast selections, and process parameters

Suggests pairings using complement, contrast, and cleanse principles

Capabilities & Tool Schemas (6)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Brewers Almanack.

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.

Documentation Overview

Brewers Almanack

A brewing knowledge MCP server: beer styles, ingredients, off-flavour diagnosis, water chemistry, and recipe guidance for AI assistants.

Ask your AI assistant about beer styles, diagnose off-flavours, build recipes, match water profiles, and pair food (all backed by real brewing data, not hallucinations).

6 tools. Zero config. Works with every MCP-compatible IDE.

Install

Terminal

npx -y brewers-almanack

No API keys, no network dependencies. All brewing data is embedded.

Add to your IDE

Claude Code

Terminal

claude mcp add brewers-almanack -- npx -y brewers-almanack

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

config.json

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

Cursor

Add to .cursor/mcp.json:

config.json

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

VS Code (Copilot)

Add to .vscode/mcp.json:

config.json

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

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

config.json

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

Zed

Add to settings.json:

config.json

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

Tools

Tool	Description
`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.

Example Conversations

"What hops work in a Belgian Dubbel?"

Searches ingredients for hops that complement Belgian styles, returning varieties like Styrian Goldings and Saaz with alpha acid ranges, aromas, and substitutes.

"My beer tastes like butter, what went wrong?"

Diagnoses diacetyl: identifies the compound, explains causes (incomplete fermentation, premature racking), and gives prevention steps (diacetyl rest, healthy yeast pitch).

"Suggest a recipe for a West Coast IPA"

Builds a complete recipe: pale malt base with crystal malt, Centennial/Cascade hop schedule with dry hop additions, American ale yeast, and a Burton-style water profile.

"What food pairs well with a stout?"

Returns pairing suggestions (oysters, chocolate desserts, grilled meats) with principles explaining why each pairing works (complement, contrast, or cleanse).

Data Sources

Dataset	Records	Source	Licence / Basis
Beer styles	85	BJCP 2021 Guidelines via beerjson/bjcp-json	MIT; BJCP attribution
Hops	113	kasperg3/HopDatabase	MIT
Malts	38	Compiled from published maltster spec sheets	Factual data
Yeasts	33	Compiled from published yeast lab spec sheets	Factual data
Adjuncts	21	Compiled from brewing literature	Factual data
Water profiles	20	Compiled from brewing literature	Factual data
Off-flavours	25	Compiled from brewing science literature	Factual data
Food pairings	23	Compiled from Cicerone curriculum and pairing guides	Factual data

Roadmap

See ROADMAP.md for planned features: brewing calculators, recipe intelligence, BeerXML/BeerJSON integration, and a brewing journal.

Contributing

Contributions are welcome, especially data contributions. More hop varieties, yeast strains, regional water profiles, and food pairings make the server more useful for everyone.

bash

git clone https://github.com/gregario/brewers-almanack.git
cd brewers-almanack
npm install
npm run build
npm test        # 73 tests

Running locally

Terminal

claude mcp add brewers-almanack-dev -- node /path/to/brewers-almanack/dist/index.js

See ROADMAP.md for areas where contributions are most needed.

Licence

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Knowledge & Memory View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

1.1k

Package downloads in the last 30 days.

Last commit

3d ago

Most recent push to the default branch.

Install check

Inconclusive

Started but did not complete the MCP handshake in our test.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Brewers Almanack

No. The README states that it requires no API keys and uses embedded brewing data.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Brewers Almanack AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/gregario-brewers-almanack?style=directory)](https://allmcps.com/mcp/gregario-brewers-almanack)

HTML Embed

<a href="https://allmcps.com/mcp/gregario-brewers-almanack"><img src="https://allmcps.com/api/badge/gregario-brewers-almanack?style=directory" alt="Brewers Almanack on AllMCPs" /></a>

Technical Specs & Signals

CategoryKnowledge & Memory

PricingFree

11/11 checks healthy over the last 32d

61Quality signal: Good · 61/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools28/30

Adoption & activity8/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 22d ago via OSV.dev · brewers-almanack (npm)

★ Featured

AllMCPs Server

The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🧠 Knowledge & Memory →Best MCP servers for Memory & Knowledge →Alternatives to Brewers Almanack →Install in Claude Desktop Install in Cursor Install in VS Code

Brewers Almanack

brewingbeerrecipesfood-pairingwater-chemistry

MCP server for beer styles, brewing ingredients, water profiles, off-flavour diagnosis, recipes, and food pairings.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

We couldn’t automatically confirm this listing starts correctly

The install command below started, but didn't respond the way we expected when we tried to talk to it.

npx -y brewers-almanack

initialize succeeded but no response to tools/list.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

Use cases

Search BJCP beer styles by name, category, or characteristics

Find hops, malts, yeasts, and adjuncts by brewing characteristics

Diagnose off-flavours from taste or aroma descriptions

Generate recipes for target beer styles

Match brewing water profiles and food pairings

Key features

Searches 85 BJCP 2021 beer styles

Searches 113 hop varieties plus malts, yeasts, and adjuncts

Identifies likely off-flavour compounds, causes, and prevention steps

Returns mineral compositions for 20 water profiles

Generates grain bills, hop schedules, yeast selections, and process parameters

Suggests pairings using complement, contrast, and cleanse principles

Capabilities & Tool Schemas (6)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Brewers Almanack.

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.

Documentation Overview

Brewers Almanack

A brewing knowledge MCP server: beer styles, ingredients, off-flavour diagnosis, water chemistry, and recipe guidance for AI assistants.

Ask your AI assistant about beer styles, diagnose off-flavours, build recipes, match water profiles, and pair food (all backed by real brewing data, not hallucinations).

6 tools. Zero config. Works with every MCP-compatible IDE.

Install

Terminal

npx -y brewers-almanack

No API keys, no network dependencies. All brewing data is embedded.

Add to your IDE

Claude Code

Terminal

claude mcp add brewers-almanack -- npx -y brewers-almanack

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

config.json

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

Cursor

Add to .cursor/mcp.json:

config.json

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

VS Code (Copilot)

Add to .vscode/mcp.json:

config.json

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

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

config.json

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

Zed

Add to settings.json:

config.json

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

Tools

Tool	Description
`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.

Example Conversations

"What hops work in a Belgian Dubbel?"

Searches ingredients for hops that complement Belgian styles, returning varieties like Styrian Goldings and Saaz with alpha acid ranges, aromas, and substitutes.

"My beer tastes like butter, what went wrong?"

Diagnoses diacetyl: identifies the compound, explains causes (incomplete fermentation, premature racking), and gives prevention steps (diacetyl rest, healthy yeast pitch).

"Suggest a recipe for a West Coast IPA"

Builds a complete recipe: pale malt base with crystal malt, Centennial/Cascade hop schedule with dry hop additions, American ale yeast, and a Burton-style water profile.

"What food pairs well with a stout?"

Returns pairing suggestions (oysters, chocolate desserts, grilled meats) with principles explaining why each pairing works (complement, contrast, or cleanse).

Data Sources

Dataset	Records	Source	Licence / Basis
Beer styles	85	BJCP 2021 Guidelines via beerjson/bjcp-json	MIT; BJCP attribution
Hops	113	kasperg3/HopDatabase	MIT
Malts	38	Compiled from published maltster spec sheets	Factual data
Yeasts	33	Compiled from published yeast lab spec sheets	Factual data
Adjuncts	21	Compiled from brewing literature	Factual data
Water profiles	20	Compiled from brewing literature	Factual data
Off-flavours	25	Compiled from brewing science literature	Factual data
Food pairings	23	Compiled from Cicerone curriculum and pairing guides	Factual data

Roadmap

See ROADMAP.md for planned features: brewing calculators, recipe intelligence, BeerXML/BeerJSON integration, and a brewing journal.

Contributing

Contributions are welcome, especially data contributions. More hop varieties, yeast strains, regional water profiles, and food pairings make the server more useful for everyone.

bash

git clone https://github.com/gregario/brewers-almanack.git
cd brewers-almanack
npm install
npm run build
npm test        # 73 tests

Running locally

Terminal

claude mcp add brewers-almanack-dev -- node /path/to/brewers-almanack/dist/index.js

See ROADMAP.md for areas where contributions are most needed.

Licence

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Knowledge & Memory View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

1.1k

Package downloads in the last 30 days.

Last commit

3d ago

Most recent push to the default branch.

Install check

Inconclusive

Started but did not complete the MCP handshake in our test.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Brewers Almanack

No. The README states that it requires no API keys and uses embedded brewing data.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/gregario-brewers-almanack?style=directory)](https://allmcps.com/mcp/gregario-brewers-almanack)

HTML Embed

<a href="https://allmcps.com/mcp/gregario-brewers-almanack"><img src="https://allmcps.com/api/badge/gregario-brewers-almanack?style=directory" alt="Brewers Almanack on AllMCPs" /></a>

Technical Specs & Signals

CategoryKnowledge & Memory

PricingFree

11/11 checks healthy over the last 32d

61Quality signal: Good · 61/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools28/30

Adoption & activity8/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 22d ago via OSV.dev · brewers-almanack (npm)

★ Featured

AllMCPs Server

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🧠 Knowledge & Memory →Best MCP servers for Memory & Knowledge →Alternatives to Brewers Almanack →Install in Claude Desktop Install in Cursor Install in VS Code