random-brewery-finder

Fetch information about a random brewery from around the world, including name, type, city, state, and country, using the Open Brewery DB.

Features

• Tool: get_random_brewery — Returns details for a randomly selected brewery.
• No API keys or authentication required.
• Pulls live data from an open global breweries database.

Installation & Usage

One-line Run

Run with npx (recommended):

npx @dennisk2025/random-brewery-finder

Or add to your project:

npm install @dennisk2025/random-brewery-finder

Adding to Claude Desktop

To integrate this MCP server:

1. Open your Claude Desktop config file:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Add the following under mcpServers:

{
  "mcpServers": {
    "random-brewery-finder": {
      "command": "npx",
      "args": ["@dennisk2025/random-brewery-finder"]
    }
  }
}

Available Tools

get_random_brewery

Description: Returns information about a randomly selected brewery from the Open Brewery DB.

Parameters

• None

Example Call

You can use this tool with no parameters:

{
  "name": "get_random_brewery",
  "arguments": {}
}

Example Response

{
  "name": "Flying Dog Brewery",
  "brewery_type": "micro",
  "city": "Frederick",
  "state": "Maryland",
  "country": "United States",
  "website_url": "http://www.flyingdogbrewery.com"
}

Error Handling

If an error occurs (e.g., network or Open Brewery DB API issue), you will get an error message indicating the problem.

License

MIT License.