Open Brewery DB

by jimbuck

386 downloads
Not rated
GitHub

About

Search and retrieve brewery data worldwide using the Open Brewery DB API.

Details

Author
jimbuck
Downloads
386
Categories
Search, Other, API, Database

- 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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Open Brewery DB
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. 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"] } } }

Open Brewery DBis a free and open-source API that provides comprehensive information about breweries worldwide. The database includes:

- 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 the
Open 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 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.

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)

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.