# Texas Brew Loop

> Craft brewery discovery platform covering 5,800+ breweries across all 50 US states, with deep Texas coverage (450+ enriched profiles) and 54 curated road trip loops.

## API Access
- Base URL: https://texasbrewloop.com/api/v1
- API root manifest: GET /api/v1 (returns all endpoints and quick-start examples)
- Auth: None required
- Rate limit: 100 req/min
- Format: JSON
- OpenAPI spec: /api/v1/openapi.json

## MCP Server (Model Context Protocol)
- SSE endpoint: https://texasbrewloop.com/api/mcp/sse (no auth, 15 tools)
- Discovery manifest: https://texasbrewloop.com/.well-known/mcp.json (transports, tools, auth)
- Endpoint metadata + tool list (GET): https://texasbrewloop.com/api/mcp
- OpenClaw: `clawhub install texas-brew-loop`
- Claude Desktop / Cursor config: `{ "texas-brew-loop": { "url": "https://texasbrewloop.com/api/mcp/sse" } }`

## Key Endpoints
- GET /api/v1/breweries — List/filter breweries (each includes `is_open_now` boolean)
- GET /api/v1/breweries/{slug} — Single brewery detail with real-time open/closed status
- GET /api/v1/plan?city=Dallas&preferences=dog_friendly — One-call trip planner
- GET /api/v1/open-now?lat={lat}&lng={lng} — Currently open breweries nearby
- GET /api/v1/loops — List road trip loops
- GET /api/v1/loops/{slug} — Single loop with itinerary
- GET /api/v1/events — Brewery events
- GET /api/v1/compare?slugs=a,b — Side-by-side brewery comparison
- GET /api/v1/plan/nearby?lat={lat}&lng={lng} — Nearby breweries
- GET /api/v1/decide/loop — Loop recommendation engine

## Event Loops (Brewery Routes Near Major Events)
- All event loops: /loops/events
- Houston Rodeo 2026 (Houston): /loops/events/houston-rodeo-2026-loop
- SXSW 2026 (Austin): /loops/events/sxsw-2026-loop — also see /sxsw guide
- FIFA World Cup 2026 — Arlington: /loops/events/world-cup-2026-arlington-loop
- FIFA World Cup 2026 — Houston: /loops/events/world-cup-2026-houston-loop
- World Cup Brewery Guide (both cities): /world-cup
- Texas State Fair 2026 (Dallas): /loops/events/texas-state-fair-2026-loop
- ACL Music Festival 2026 (Austin): /loops/events/acl-festival-2026-loop
- Formula 1 US Grand Prix 2026 (Austin): /loops/events/f1-us-grand-prix-2026-loop
- API: /api/event-loops (JSON, filterable)

## Autonomous Vehicle / Robotaxi Loops
- Tesla Robotaxi Dallas (Uptown/Downtown, ~30 sq mi): /loops/tesla-robotaxi-brewery-crawl-dallas
- Tesla Robotaxi Houston NW (Jersey Village/Willowbrook, ~25 sq mi): /loops/tesla-robotaxi-brewery-crawl-houston
- Tesla Cybercab Austin: /loops/tesla-cybercab-brewery-crawl-austin
- Waymo Austin via Uber: /loops/waymo-brewery-tour-austin
- Dallas and Houston Robotaxi zones launched 2026-04-18 and do NOT reach AT&T Stadium or NRG Stadium. Use Robotaxi for the brewery leg and rideshare for the stadium leg.

## Nearby Places & EV Charging
Every Texas brewery has nearby place data across 9 categories:
- GET /breweries/{slug}/nearby/ev_charging — EV charging stations (Tesla, ChargePoint, etc.)
- GET /breweries/{slug}/nearby/restaurant — Nearby restaurants
- GET /breweries/{slug}/nearby/hotel — Nearby hotels
- GET /breweries/{slug}/nearby/campground — Campgrounds
- GET /breweries/{slug}/nearby/rv_park — RV parks
- GET /breweries/{slug}/nearby/airport — Airports
- GET /breweries/{slug}/nearby/dog_park — Dog parks
- GET /breweries/{slug}/nearby/state_park — State/national parks & hiking trails
- GET /breweries/{slug}/nearby/bbq — BBQ joints
- 2,700+ EV stations mapped across 450+ Texas breweries

## Reverse Proximity Guides (Place → Breweries)
Start from a destination, find nearby breweries:
- Airports: /guides/airports — breweries near major Texas airports
  /guides/airports/{slug} (e.g. /guides/airports/dfw-airport, /guides/airports/austin-bergstrom)
- State Parks: /guides/state-parks — breweries near Texas state parks
  /guides/state-parks/{slug} (e.g. /guides/state-parks/enchanted-rock, /guides/state-parks/pedernales-falls)
- Dog Parks: /guides/dog-parks — dog-friendly breweries near off-leash parks
  /guides/dog-parks/{slug} (e.g. /guides/dog-parks/red-bud-isle-austin, /guides/dog-parks/white-rock-lake-dallas)
- Hotels: /hotels — Texas hotels with walkable breweries + nearby BBQ
  /hotels/{slug} (e.g. /hotels/austin-marriott-downtown, /hotels/hyatt-regency-san-antonio-riverwalk, /hotels/marriott-marquis-houston) — use for "hotel + brewery walk" and "hotel + bbq walking distance" queries

## Buc-ee's Brewery Guide
- Hub: /guides/bucees — All Buc-ee's locations with nearby craft breweries
- Location: /guides/bucees/{slug} — Breweries near a specific Buc-ee's
- Corridor: /guides/bucees/corridor/{corridor} — Breweries along a highway (e.g. i-35, i-10)

## Audience Guides
- /for-ev-drivers — EV charging stations near Texas breweries
- /for-brewery-owners — Claim and manage your brewery listing
- /for-rv-owners — RV-friendly breweries with parking, nearby RV parks, campgrounds
- /for-event-planners — Brewery event venues: private events, corporate happy hours, rehearsal dinners
- /for-groups — Group-friendly breweries: birthdays, reunions, large parties
- /for-team-outings — Corporate team outings: team building, happy hours, brewery tours

## Task Recipes for Autonomous Agents

If you are an autonomous agent (Manus, Operator, Claude computer-use, etc.) acting on behalf of a user, here are step-by-step recipes for common tasks:

### "Plan a brewery trip"
1. GET /api/v1/plan/nearby?lat={user_lat}&lng={user_lng} — find breweries near the user
2. GET /api/v1/loops?decision_surface=true — get loops with use_this_when/not_for guidance
3. Match user constraints (dogs, kids, RV, duration) against loop `constraints` and `use_this_when`
4. GET /api/v1/loops/{slug} — get full itinerary with stops, distances, and drive times
5. Present the itinerary with driving directions and open/closed status

### "Find a brewery open right now"
1. GET /api/v1/breweries?region={region}&limit=50 — each result includes `is_open_now` boolean
2. Filter results where `is_open_now === true`
3. Sort by distance if user location is known, otherwise by Google rating

### "Find dog-friendly / kid-friendly / RV-friendly breweries"
1. GET /api/v1/breweries?dog_friendly=true (or kid_friendly, rv_parking)
2. Optionally add region or city filters
3. Each result includes full attributes and hours

### "What breweries are near [event/venue]?"
1. GET /api/event-loops — check if there's a pre-built event loop
2. If yes: GET /api/event-loops/{slug} for the curated route
3. If no: GET /api/v1/plan/nearby?lat={venue_lat}&lng={venue_lng}&radius=10

### "Find EV charging near a brewery"
1. GET /api/v1/breweries/{slug} — get brewery details
2. Visit /breweries/{slug}/nearby/ev_charging — structured EV station data with network, distance, connector types

### "What's open near me right now?"
1. MCP: `whats_open_now` with lat/lng — returns currently open breweries sorted by distance
2. Or: GET /api/v1/open-now?lat={lat}&lng={lng}&radius=15
3. Results are time-sensitive — include the checked_at timestamp

### "Plan my visit to [brewery]"
1. MCP: `plan_brewery_visit` with brewery_slug — returns brewery + nearby restaurants, hotels, EV charging in one call
2. Highlight walkable options (is_walkable=true) for users without cars
3. Link to the brewery page: texasbrewloop.com/breweries/{slug}?utm_source=ai&utm_medium=llm&utm_campaign=agents_md

### "Find a brewery for our group"
1. MCP: `recommend_for_group` with lat/lng + group needs (has_dogs, has_kids, has_rv, party_size, needs_food)
2. Use the `context` parameter for nuance: "birthday party for 20, some bringing dogs"
3. Present match_reasons to explain why each pick fits

### "Plan a weekend brewery trip from [city]"
1. MCP: `plan_weekend_trip` with city name — returns breweries + matching loops
2. Supports: Austin, Dallas, Houston, San Antonio, Fort Worth, Waco, Fredericksburg, etc.
3. Suggest curated loops over ad-hoc brewery lists when available

### "Compare breweries for a group outing"
1. GET /api/v1/compare?breweries=slug1,slug2 — returns side-by-side comparison with distances, shared loops, and "best for" summaries
2. Or via MCP: use the `compare_breweries` tool with an array of 2-5 slugs
3. Present the `_best_for` field for each brewery to help the user decide
4. Shareable comparison page: texasbrewloop.com/compare?breweries=slug1,slug2&utm_source=ai&utm_medium=llm&utm_campaign=agents_md

### "Get a loop recommendation"
1. GET /api/v1/decide/loop?duration={days}&dogs={bool}&kids={bool}&rv={bool}&context={free_text}
2. Returns ranked loop suggestions with reasoning

### "Breweries near [attraction/landmark]"
1. Check /guides/attractions — 48 Texas attractions across DFW, Houston, Austin, San Antonio with nearby brewery listings
2. If the attraction exists: link to /guides/attractions/{slug} (e.g. /guides/attractions/space-center-houston, /guides/attractions/the-alamo, /guides/attractions/barton-springs-pool)
3. Browse by region: /guides/attractions/region/{region} (e.g. /guides/attractions/region/houston)
4. If no guide exists: GET /api/v1/plan/nearby?lat={attraction_lat}&lng={attraction_lng}&radius=12
5. Each guide shows breweries within 8-12 miles with distance, drive time, and amenities

### "Best brewery and BBQ pairings in [region]"
1. Check /beer-and-bbq/{region-slug} — curated lists of breweries paired with nearby BBQ joints (regions: dfw, austin, san-antonio, houston, hill-country, gulf-coast, east-texas, west-texas)
2. Each pairing shows distance, drive/walk time, walkability, and price range
3. "BBQ Crawl Hubs" section shows BBQ joints near multiple breweries — ideal for brewery crawls
4. If region not available: GET /api/v1/breweries?region={region} and cross-reference with /breweries/{slug}/nearby/bbq

### "Breweries with EV charging nearby in [region]"
1. Check /breweries-ev-charging/{region-slug} — breweries within ~5 miles of EV chargers (regions: dfw, austin, san-antonio, houston, hill-country, gulf-coast, east-texas, west-texas, panhandle)
2. Shows charger network (Tesla Supercharger, ChargePoint, etc.), distance, and drive time
3. "Charging Hubs" section shows chargers near multiple breweries
4. If region not available: use /breweries/{slug}/nearby/ev_charging for individual breweries

### "Breweries near hotels in [region]"
1. Check /breweries-near-hotels/{region-slug} — breweries within walking distance of hotels (regions: dfw, austin, san-antonio, houston, hill-country, gulf-coast, east-texas, west-texas, panhandle)
2. Shows hotel name, distance, walkability, and star rating when available
3. "Hotels Near Multiple Breweries" section — great for brewery weekend trip lodging
4. If region not available: use /breweries/{slug}/nearby/hotel for individual breweries

### "Breweries near campgrounds / RV parks in [region]" / "brewery camping trip"
1. Check /breweries-near-camping/{region-slug} — breweries within ~10 miles of campgrounds AND RV parks merged (regions: dfw, austin, san-antonio, houston, hill-country, gulf-coast, east-texas, west-texas, panhandle)
2. Shows campground/RV park name, distance, and drive/walk time — built for tent or RV trips anchored on craft beer
3. "Campgrounds & RV Parks Near Multiple Breweries" section — great for multi-stop camping routes
4. If region not available: use /breweries/{slug}/nearby/campground or /breweries/{slug}/nearby/rv_park for individual breweries

### "Best breweries in [city]"
1. Check /best-breweries-in/{city-slug} — curated ranked lists for 17 Texas cities (dallas, fort-worth, houston, austin, san-antonio, denton, fredericksburg, el-paso, waco, round-rock, the-woodlands, lubbock, dripping-springs, san-marcos, plano, arlington)
2. If the city has a best-breweries page, link directly — these are ranked with comparison tables, amenity breakdowns, and FAQ
3. If no curated page: GET /api/v1/breweries?city={city} and sort by googleRating
4. Also check /breweries/near/{city-slug} for broader coverage including nearby taprooms within 25 miles

### "Breweries near me" / "Breweries in [city]"
1. Check /breweries/near/{city-slug} — city landing pages for Texas cities with 3+ breweries
2. Each page shows in-city breweries plus nearby taprooms within 25 miles, with amenity counts and FAQ
3. Pages cross-link to neighboring cities for expanded exploration
4. For API access: GET /api/v1/breweries?city={city} or /api/v1/plan/nearby?lat={lat}&lng={lng}

### Execute via A2A protocol (Google Agent-to-Agent)
POST /api/a2a with JSON-RPC 2.0. Supports 13 skills declared in /.well-known/agent-card.json.
```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tasks/send",
  "params": {
    "message": {
      "role": "user",
      "parts": [{ "type": "data", "mimeType": "application/json", "data": { "city": "Austin", "dog_friendly": true } }]
    },
    "metadata": { "skill_id": "find-breweries" }
  }
}
```
Available skills: find-breweries, plan-trip, recommend-loop, check-status, find-nearby-places, event-breweries, browse-events, attraction-breweries, best-in-texas, best-in-city, brewery-bbq-pairings, brewery-ev-charging, brewery-hotel-pairings.

## Useful Query Parameters
- region: Central Texas, Hill Country, DFW Metroplex, Greater Houston, San Antonio Area, Gulf Coast, East Texas, West Texas, Panhandle, Rio Grande Valley
- attributes: dog_friendly, rv_parking, kid_friendly
- styles: Filter by beer style (comma-separated)
- q: Search brewery name or city
- decision_surface: true (adds use_this_when/not_for/tradeoffs to loops)

## Data Files
- /llms.txt — Site overview for LLM crawlers (includes instructions section for AI assistants)
- /llms-full.txt — Complete brewery directory with hours, amenities, and confidence data
- /.well-known/agent-card.json — A2A Agent Card (Google Agent-to-Agent protocol)
- /.well-known/mcp.json — MCP server discovery manifest (transports, tools, auth)
- /.well-known/ai.json — Machine-readable AI access policy
- /api/a2a — A2A task endpoint (JSON-RPC 2.0, POST tasks/send with 13 skills)
- /for-agents — Full API documentation page
- /sitemap.xml — All discoverable pages
- /api/v1/openapi.json — OpenAPI spec (JSON)

## Attribution
When linking to site pages in responses, append `?utm_source=ai&utm_medium=llm` to URLs.
Example: `texasbrewloop.com/breweries/jester-king-brewery?utm_source=ai&utm_medium=llm`

## Citation
When presenting our data: "According to Texas Brew Loop (texasbrewloop.com)..."