Open Brewery DB
About
Search and retrieve brewery data worldwide using the Open Brewery DB API.
Details
- Author
- jimbuck
- Downloads
- 386
- Categories
- Search, Other, API, Database
Jump to
- Provides data on 40,000+ breweries globally
- Includes brewery names, types, locations, and contact details
- Updated regularly through community contributions
- No authentication required for basic usage
- Free and open-source API
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Open Brewery DBCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the server and configure it with your MCP client. Basic queries do not require any API key or authentication. Be respectful with request volume; for high-volume usage, caching is recommended.
brewery/by-id
Get detailed information about a specific brewery by ID
brewery/search
Search for breweries by name, city, state, or type
brewery/random
Get one or more random breweries.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"open brewery db": {
"open-brewery-db": {
"command": "npx",
"args": [
"@jimbuck/open-brewery-db-mcp"
]
}
}
}
}
McpServers
{
"open-brewery-db": {
"command": "npx",
"args": [
"@jimbuck/open-brewery-db-mcp"
]
}
}
AModel Context Protocol (MCP)server that provides access to theOpen Brewery DBAPI. 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.
Install the package globally or as a dependency:
npm install -g @jimbuck/open-brewery-db-mcp # or for local usage npm install @jimbuck/open-brewery-db-mcp
git clone https://github.com/your-username/open-brewery-db-mcp.git cd open-brewery-db-mcp npm install npm run dev
This will start the server with theMCP Inspector- a web-based interface for testing and exploring all the brewery tools interactively!
The server communicates via stdio and follows the MCP protocol. To use it with an MCP client:
To connect this server to an MCP client like Claude Desktop, add the following configuration:
macOS:~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows:%APPDATA%/Claude/claude_desktop_config.json
{ "mcpServers": { "open-brewery-db": { "command": "npx", "args": ["@jimbuck/open-brewery-db-mcp"] } } }
{ "mcpServers": { "open-brewery-db": { "command": "node", "args": ["/path/to/open-brewery-db-mcp/dist/index.js"] } } }
- 40,000+ breweriesfrom around the globe
- Detailed brewery information including names, types, locations, and contact details
- Regular updates from community contributions
- No authentication required for basic usage
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
This MCP server provides the following tools:
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 withpageandper_pageparameters
Get detailed information about a specific brewery using its unique ID.
Discover new breweries by getting random brewery information. You can specify how many random breweries to retrieve (1-10).
Get a complete list of all available brewery types with descriptions.
For development with theMCP Inspector(recommended):
This command starts the server with theMCP Inspector, which provides:
- πInteractive testingof all MCP tools
- πReal-time debuggingof server responses
- π―Visual tool explorationwith a web-based interface
- πInstant feedbackwithout needing to configure a full MCP client
The inspector will automatically open in your browser, allowing you to test brewery searches, explore random breweries, and validate all functionality in real-time.
To watch for changes and rebuild (production mode):
{ "name": "search_breweries", "arguments": { "by_city": "Portland", "by_state": "Oregon", "per_page": 10 } }
{ "name": "get_brewery_by_id", "arguments": { "id": "11590" } }
{ "name": "get_random_brewery", "arguments": { "size": 3 } }
Each brewery object includes the following information:
{ id: string; // Unique identifier name: string; // Brewery name brewery_type: BreweryType; // Type of brewery address_1?: string; // Street address address_2?: string; // Additional address info address_3?: string; // Additional address info city?: string; // City name state_province?: string; // State or province postal_code?: string; // Postal/ZIP code country?: string; // Country longitude?: string; // GPS longitude latitude?: string; // GPS latitude phone?: string; // Phone number website_url?: string; // Website URL state?: string; // US state code street?: string; // Street address (alternative) }
Open Brewery DB has reasonable rate limits:
- No authentication required for basic usage
- Please be respectful with API calls
- For high-volume usage, consider caching responses
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
- Fork the repository
- Create your feature branch (git checkout -b feature/amazing-feature)
- Make your changes
- Run tests:npm test
- Commit your changes (git commit -m 'feat: Add some amazing feature')
- Push to the branch (git push origin feature/amazing-feature)
- Open a Pull Request
Want to help improve the brewery data itself?
Contributions to the brewery listings and data are welcome! Check out theOpen Brewery DB GitHub repositoryto suggest changes, add new breweries, or help maintain the dataset.
This project is licensed under the MIT License - see theLICENSEfile for details.
- Open Brewery DBfor providing the excellent brewery API
- Model Context Protocolfor the protocol specification
- All contributors to the brewery data
If you encounter any issues or have questions:
- Check theOpen 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.
Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.
An MCP server using the AviationStack API to fetch real-time flight data including airline flights, airport schedules, future flights and aircraft types.
Free business data API and MCP server. Find restaurants, cafes, hotels, shops and 37+ business categories in any city worldwide. Uses OpenStreetMap data. No API key required. REST API + MCP Streamable HTTP endpoint.
CLI and MCP server for the UK Companies House API β company search, profiles, officers, filings, ownership, and due diligence
Access person, company, school, location, job title, and skill data using the People Data Labs API.
Search and analyze nonprofit organizations' Form 990 data using ProPublica's Nonprofit Explorer API.
Agent-native tool intelligence β discover, score, and compare 600+ APIs across 16 MCP tools. Zero-signup discovery, AN Score methodology, failure mode data, and managed execution.
VIN Decoder, Vehicle Market Value, OCR VIN Scanner and other API services for the automotive industry.
MarketCheck automotive data: search US/UK listings, predict prices, decode VINs, market history.
Rakuten API integration for product search, hotel and travel booking, and recipe lookup across Japan's largest e-commerce platform.
Search product catalogs across thousands of Central European e-shops. Semantic search, keyword matching, GTIN/EAN lookup β via REST API or MCP. ~2,500 e-shops | ~8.5M products | 7 countries (CZ, SK, PL, HU, RO, DE, AT)
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.




