brewery/by-id
Get detailed information about a specific brewery by ID
LABSCO SUMMARY
A thin pass-through: the dataset's own filters, its own paging, and nothing invented on top.
The surface mirrors the underlying API rather than layering over it — the same by_city, by_state and by_type filters, the same page and per_page, and an id lookup for the record behind a search hit. brewery/random is not a query at all: it takes size and hands back that many at random, which is what makes this as useful for filling a fixture as for answering a question. There is no coordinate or radius parameter anywhere here, so a question shaped like "breweries near me" has to be turned into a city or a state before it can be asked.
What it is
A client for the Open Brewery DB dataset with three tools: a paged search across name, city, state and type, a detail lookup by brewery id, and a random sampler.
What you get
- brewery/search takes a free-text query or the by_city, by_state and by_type filters, paging through page and per_page.
- brewery/by-id returns the detail for a single brewery from its id.
- brewery/random returns random breweries, with size deciding how many come back.
Requirements
Nothing — no account, no key.
Setup effort
One command — npm install -g @jimbuck/open-brewery-db-mcp
USE CASES
01
Finding the breweries in a city you are visiting
Filter by the city, or by state and type when the city is too narrow, then open the one worth the detour.
02
Filling a demo or a test fixture with real records
Ask for as many random breweries as the fixture needs and use them as they come.
3 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
brewery/random
Get one or more random breweries.
brewery/search
Search for breweries by name, city, state, or type
BEFORE YOU INSTALL
What to know first
Tools you get
3 tools when we connected. Tool names use slashes: brewery/search, brewery/by-id and brewery/random. The documentation's older names, such as search_breweries, are stale, and list_brewery_types no longer exists.
Requires
npx on PATH
Where it runs
The documented client runs the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 3 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install -g @jimbuck/open-brewery-db-mcpMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"open-brewery-db": {
"command": "npx",
"args": [
"@jimbuck/open-brewery-db-mcp"
]
}
}
}
