Open Brewery DB

@jimbuck

Visit Server

5 months ago

A free database of breweries, cideries, brewpubs, and bottleshops.

Overview Tools Comments

Overview

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 page and per_page parameters

🏭 `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.

Try in Playground

Server Config

{
  "mcpServers": {
    "open-brewery-db": {
      "command": "npx",
      "args": [
        "@jimbuck/open-brewery-db-mcp"
      ]
    }
  }
}

Build with ShipAny.