# Open Brewery DB MCP > Open Brewery DB MCP Server connects your AI agent directly to a structured database of U.S. breweries. It lets you search by name, filter results down to a specific city or state, and narrow the list by business type (micro, brewpub, etc.). You get immediate access to addresses, phone numbers, and websites for every location. ## Overview - **Category:** travel-hospitality - **Price:** Free - **Tags:** business-directory, location-search, hospitality, data-retrieval ## Description Your AI client connects directly to an open-source database covering U.S. breweries through this MCP Server. You don't have to scrape anything or guess parameters; your agent uses specific, structured tools to pull exactly what you need. **`search_breweries`**: This tool lets your agent find any brewery using a general keyword or a partial name across the entire United States. If you know a brand name but not its exact location, running this query gets results from all matching entries nationwide. **`find_breweries_by_city`**: When you need to plan an itinerary for a specific local area, your agent executes this tool. It returns every known brewery located within the city boundary you specify. **`find_breweries_by_state`**: If you're mapping out coverage across a whole region, this tool works for you. You feed it the full official name of any US state, and your agent gathers a complete list of all breweries operating anywhere in that designated state boundary. **`find_breweries_by_type`**: Need to narrow down results by style? This tool filters the database based on specific operational types, like 'micro' or 'brewpub.' You can run this query to limit the search only to businesses that match your criteria. When you call any of these tools—whether it’s a general keyword search, filtering by state, or listing all locations in Chicago—your agent automatically pulls structured data for every single entry. This output is robust: you get the full address, the phone number, the website URL, and even the precise GPS coordinates for every listed brewery. You're building something that needs reliable contact details. You can pull out specific fields like the web link or the main phone number for any location found in the results set. The system handles the data retrieval so you don't have to worry about authentication or complex API calls. It just gives you clean, actionable data. If your goal is simple local planning, let your agent use **`find_breweries_by_city`**. If you need massive coverage and are mapping out a whole state for research, run **`find_breweries_by_state`**. For a quick check on a brand name anywhere in the country, just hit up **`search_breweries`**. And if your dataset is huge and you only care about nano-brewery operations, **`find_breweries_by_type`** will cut through the noise. You get immediate access to comprehensive location data without any guesswork. ## Tools ### find_breweries_by_city Finds all breweries located in a specific city name, great for local planning. ### find_breweries_by_state Locates every brewery operating within an entire US state by its full official name. ### find_breweries_by_type Filters the database based on business style, such as 'micro' or 'brewpub'. ### search_breweries Searches for any brewery using a general keyword or partial name across all of the United States. ## Prompt Examples **Prompt:** ``` Find me craft breweries in Portland. ``` **Response:** ``` Portland is a craft beer paradise! I found 50+ breweries including: Deschutes Brewery (regional), Hair of the Dog Brewing (micro), Widmer Brothers (regional), and Cascade Brewing (micro). Each listing includes full address, phone, and website for planning your brewery tour. ``` **Prompt:** ``` List some nanobreweries in Colorado. ``` **Response:** ``` I found several nanobreweries in Colorado! Some options include: The Old Mine Cidery & Brewpub in Erie, Paradox Beer Company in Divide, and Nano 108 Brewing Company in Colorado Springs. ``` **Prompt:** ``` I need the address and website for Russian River Brewing in California. ``` **Response:** ``` Russian River Brewing Company is located at 725 4th St, Santa Rosa, CA 95404. You can visit their website at http://www.russianriverbrewing.com. They are categorized as a regional brewery. ``` ## Capabilities ### Search by Keyword Find breweries across the US using a general keyword or partial name. ### List All Breweries in a City Retrieves every known brewery location within a specified city boundary. ### Locate by State Boundary Gathers a full list of breweries operating anywhere in a designated US state. ### Filter by Business Type Narrows down the search results to specific operational types, like nano or brewpub. ### Extract Contact Details Pulls structured data including address, phone number, and website for every listed location. ## Use Cases ### Planning a multi-city tour A travel developer needs to build an itinerary covering three states. Instead of running three separate web searches, they use `find_breweries_by_state` for each state and then combine the structured results into one master data set. ### Curating a themed list A local guide needs to publish an article on 'The Best Nano-Breweries.' They use `find_breweries_by_type` first, then refine the results using `find_breweries_by_city` to keep the focus tight and accurate. ### Building a directory lookup An API requires rapid lookups of businesses by name. The agent uses `search_breweries` with only keywords, getting immediate hits for partial names that manual search would miss. ### Verifying regional coverage A company wants to know if they have enough partners in the South. They run `find_breweries_by_state` on Texas and Florida, getting a verifiable count of locations for planning purposes. ## Benefits - Skip manual database compilation. Instead of opening multiple websites (Yelp, Google Maps) to compile a list, your agent uses `find_breweries_by_city` to pull all relevant locations in one go. - Pinpoint specific venue types instantly. Use `find_breweries_by_type` to filter out noise and only see micro-breweries or brewpubs, which is impossible with standard keyword search tools. - Scale your coverage across the nation. Need a list of every location in Oregon? Run `find_breweries_by_state`. It handles the entire state boundary reliably. - Handle ambiguous queries easily. If you only know a partial name or concept, `search_breweries` catches it without requiring exact city/state matches. - Get guaranteed structured data. Every result includes address, phone number, and website URL, so your agent doesn't have to guess which details are missing. ## How It Works The bottom line is: you get clean, predictable data from a US database without writing complex API calls yourself. 1. Your AI client sends a natural language prompt to your agent (e.g., 'I need micro-breweries in Denver'). 2. The agent translates the intent, selecting and running multiple specialized tools (`find_breweries_by_city` and `find_breweries_by_type`) sequentially. 3. It returns a structured JSON payload containing all matching brewery names, addresses, and contact details. ## Frequently Asked Questions **How do I find all breweries in Colorado using the Open Brewery DB MCP Server?** You use `find_breweries_by_state`. This tool targets the entire state boundary and returns every brewery found in Colorado, regardless of city. **Is there a way to find only nano-breweries? Open Brewery DB MCP Server?** Yes. Use `find_breweries_by_type`. This tool lets you filter the entire database down to specific business styles like 'nano' or 'brewpub'. **Can I search for a brewery if I only remember part of the name? Open Brewery DB MCP Server?** Absolutely. Use `search_breweries`. This tool handles general keywords and partial names, making it ideal when you're unsure of the exact spelling or full title. **Does Open Brewery DB MCP Server provide GPS coordinates? Open Brewery DB MCP Server?** Yes. Every record returned by any tool includes the address, phone number, website, and precise GPS coordinates for planning purposes. **Does the Open Brewery DB MCP Server require any authentication keys or setup?** No, it doesn't. The server runs with zero authentication required, making connection and testing immediate. You can connect your AI agent without needing to manage API credentials. **What happens if I call `find_breweries_by_city` too many times in a row?** The server handles usage limits automatically. If you exceed the allowed rate, your agent will receive an explicit error response detailing the limit violation and when you can safely retry the function. **Can I combine filtering from `find_breweries_by_type` with a specific state?** You must execute these calls sequentially. Pass the results or parameters gathered from the state search into the type filter's input to narrow down your dataset. **Is Open Brewery DB MCP Server compatible with multiple AI clients and platforms?** Yes, because it uses the open Model Context Protocol (MCP) standard. Any client that supports MCP—like Claude or Cursor—can connect to and use the available tools directly. **What brewery types are available?** Six types: micro (small-scale production), nano (ultra-small, often home-based), regional (large-scale distribution), brewpub (restaurant+brewery combo), contract (brewed at another location), and proprietor (owner-operated with minimal production). **Can I search for breweries by location coordinates?** Yes, many entries in the Open Brewery DB include precise latitude and longitude coordinates, making it possible to query for breweries near a specific geographical point. **Are international breweries included?** While the primary focus of Open Brewery DB has historically been the United States, it is actively expanding to include breweries from the UK, Ireland, South Korea, and other international locations.