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:

1. Check the Open Brewery DB documentation
2. Open an issue in this repository
3. 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.