Open Brewery DB
Open Brewery DB MCP Server
A Model Context Protocol (MCP) server that provides access to the Open Brewery DB API. This server enables AI assistants and other MCP clients to search for breweries, get detailed brewery information, and explore brewery data from around the world.
Installation
MCP Client Configuration Example
To connect this server to an MCP client like Claude Desktop, add the following configuration:
{
"mcpServers": {
"open-brewery-db": {
"command": "npx",
"args": ["@jimbuck/open-brewery-db-mcp"]
}
}
}
Brewery Types
The API categorizes breweries into several types:
- micro - Most craft breweries. For example, Samuel Adams is still considered a micro brewery
- nano - An extremely small brewery which typically only distributes locally
- regional - A regional location of an expanded brewery. Ex. Sierra Nevada Asheville
- brewpub - A beer-focused restaurant or restaurant/bar with a brewery on-premise
- large - (DEPRECATED) A very large brewery. Likely not for visitors. Ex. Miller-Coors
- planning - A brewery in planning or not yet opened to the public
- bar - (DEPRECATED) A bar. No brewery equipment on premise
- contract - A brewery that uses another brewery's equipment
- proprietor - Similar to contract brewing but refers to a brewery incubator
- closed - A location which has been closed
Features
This MCP server provides the following tools:
🔍 search_breweries
Search for breweries with flexible filtering options:
- by name - Search by brewery name
- by city - Filter by city name
- by state - Filter by state (full name or abbreviation)
- by type - Filter by brewery type (see types above)
- pagination - Control results with
pageandper_pageparameters
🏭 get_brewery_by_id
Get detailed information about a specific brewery using its unique ID.
🎲 get_random_brewery
Discover new breweries by getting random brewery information. You can specify how many random breweries to retrieve (1-10).
📋 list_brewery_types
Get a complete list of all available brewery types with descriptions.
Acknowledgments
- Open Brewery DB for providing the excellent brewery API
- Model Context Protocol for the protocol specification
- All contributors to the brewery data
Support
If you encounter any issues or have questions:
- Check the Open Brewery DB documentation
- Open an issue in this repository
- Check existing issues for similar problems
Note: This is an unofficial MCP server for Open Brewery DB. It is not affiliated with or endorsed by Open Brewery DB.
Server Config
{
"mcpServers": {
"open-brewery-db": {
"command": "npx",
"args": [
"@jimbuck/open-brewery-db-mcp"
]
}
}
}