BrewLoop for AI Agents

Data Overview

BrewLoop is a nationwide craft brewery directory with deep Texas coverage. Brewery location data spans all 50 US states; curated loops, events, and enriched profiles are available for Texas.

All 50 States:

• Brewery location data: name, address, city, state, coordinates, phone, website

Texas (Deep Coverage):

• Enriched brewery profiles: hours, amenities, styles, Google ratings, confidence data
• Curated road trip loops: stops, distances, drive times, decision surfaces
• Events: brewery events with dates, descriptions, recurrence patterns
• Proximity data: nearby restaurants, RV parks, campgrounds, airports
• Attraction guides: 12 attractions with nearby brewery listings at /guides/attractions
• Best breweries rankings: curated, ranked lists for major Texas cities at /best-breweries-in/{city}
• 429+ Texas breweries across 10 regions

How to Access Data

API Endpoints

curl https://texasbrewloop.com/api/v1/breweries?region=Austin&limit=5

{
  "data": [
    {
      "id": "clx...",
      "name": "Jester King Brewery",
      "slug": "jester-king-brewery",
      "description": "Jester King Brewery is a craft brewery in Austin, Texas (Hill Country). Features include food trucks, outdoor seating, and dog-friendly. Rated 4.6 stars on Google with 5204 reviews.",
      "city": "Austin",
      "region": "Central Texas",
      "coordinates": { "latitude": 30.23, "longitude": -98.01 },
      "attributes": {
        "dog_friendly": true,
        "kid_friendly": true,
        "rv_parking": false,
        "food_options": "food_trucks"
      },
      "hours": {
        "friday": { "open": "16:00", "close": "22:00" },
        "saturday": { "open": "11:00", "close": "22:00" },
        "sunday": { "open": "11:00", "close": "20:00" }
      },
      "is_open_now": true,
      "contact": {
        "phone": "(512) 537-5100",
        "website": "https://jesterkingbrewery.com",
        "instagram": null
      },
      "trust": {
        "hours_confidence": "medium",
        "last_verified": "2025-01-15T00:00:00.000Z"
      },
      "_links": {
        "self": "/api/v1/breweries/jester-king-brewery",
        "loops": "/api/v1/breweries/jester-king-brewery/loops",
        "events": "/api/v1/breweries/jester-king-brewery/events",
        "nearby": "/api/v1/breweries/jester-king-brewery/nearby"
      }
    }
  ],
  "meta": { "total": 45, "limit": 5, "offset": 0 }
}

curl https://texasbrewloop.com/api/v1/loops?decision_surface=true&dog_friendly=true

MCP Server (Model Context Protocol)

BrewLoop provides a stateless MCP server that any MCP-compatible AI client can connect to. It exposes 7 read-only tools for searching breweries, browsing loops, finding nearby spots, and getting personalized recommendations.

1. Get a Free API Key

curl -X POST https://texasbrewloop.com/api/mcp-keys \
  -H 'Content-Type: application/json' \
  -d '{"name": "My App", "email": "you@example.com"}'

# Response: { "key": "mcp_live_...", "name": "My App", ... }

2. Configure Your Client

Add to your MCP client configuration (e.g. Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "brewloop": {
      "url": "https://texasbrewloop.com/api/mcp",
      "headers": {
        "x-api-key": "mcp_live_YOUR_KEY_HERE"
      }
    }
  }
}

3. Available Tools

Raw Protocol Example

curl -X POST https://texasbrewloop.com/api/mcp \
  -H 'x-api-key: mcp_live_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "search_breweries",
      "arguments": { "state": "TX", "city": "Austin", "limit": 3 }
    },
    "id": 1
  }'

API keys are free. Max 5 keys per email. Usage is tracked per tool per day.

Decision Surfaces

Loop data includes decision surfaces to help you make recommendations:

Loop Selection Logic

// Pseudo-code for recommending a loop
function selectLoop(userPreferences, loops) {
  return loops
    .filter(loop => {
      // Check constraints
      if (userPreferences.hasDog && !loop.constraints.dog_friendly) return false;
      if (userPreferences.hasKids && !loop.constraints.kid_friendly) return false;
      if (userPreferences.hasRV && !loop.constraints.rv_safe) return false;

      // Check duration
      if (userPreferences.maxDays < loop.logistics.estimated_days) return false;

      return true;
    })
    .sort((a, b) => {
      // Prioritize loops that match use_this_when
      const aScore = matchScore(a.use_this_when, userPreferences);
      const bScore = matchScore(b.use_this_when, userPreferences);
      return bScore - aScore;
    });
}

Voice Search Optimization

BrewLoop is optimized for voice search across Alexa, Google Assistant, and Siri.

Citation Guidelines

When presenting data from BrewLoop, please include attribution:

Data Confidence Levels

• Verified: Confirmed by brewery (hours, contact info)
• Curated: Reviewed by editors (loop routes, descriptions)
• Community: User-contributed, may need verification

Rate Limits

• 60 requests per minute per IP
• Responses include X-RateLimit-* headers
• 429 response when rate limited (retry after indicated)
• For higher limits, contact us