About events
Yeehaw is a public MCP server for finding current Austin events, aimed at AI assistants and the people building with them. It offers hourly refreshed, deduplicated listings with source links and event details.
Key features
- 01Hourly event updates
- 02Search by date, category, neighborhood, and price
- 03Retrieve an event by ID
- 04Source links and confidence per result
- 05Check data freshness and coverage
Use cases
- 01Find events happening this weekend
- 02Filter events by neighborhood or budget
- 03Verify event sources before citing listings
MCP support
Provides the public MCP endpoint https://yeehaw.bot/mcp. Its find_events and overview tools let MCP clients search sourced listings and inspect freshness and coverage.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://yeehaw.bot/mcpclaude mcp add --transport http bot-yeehaw-events https://yeehaw.bot/mcp{"mcpServers":{"bot-yeehaw-events":{"type":"http","url":"https://yeehaw.bot/mcp"}}}Open in Cursor{"servers":{"bot-yeehaw-events":{"type":"http","url":"https://yeehaw.bot/mcp"}}}Open in VS Code{"mcpServers":{"bot-yeehaw-events":{"type":"http","url":"https://yeehaw.bot/mcp"}}}{"mcpServers":{"bot-yeehaw-events":{"serverUrl":"https://yeehaw.bot/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
2| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | No | Fetch one event by id; ignores date_range and other filters when set. |
| limit | integer | No | Max results, default 20, clamped to 50. |
| query | string | No | Free-text keyword match against event titles. |
| category | string | No | Category slug (e.g. music, sports, civic). |
| price_max | number | No | Maximum ticket price in USD. price_max=0 returns only events with a known $0 price. Most events have no listed price (sparse upstream data) — for price_max>0 those are still returned and the response states how many were not price-filtered. |
| date_range | string | No | Required unless `id` is set. e.g. today, tonight, this_weekend, next_7_days, or an ISO date range. |
| neighborhood | string | No | Austin neighborhood slug. One of: downtown, east-austin, hyde-park, mueller, rainey-street, south-congress, the-domain, zilker. Common shorthands (east, domain, soco, rainey) are accepted. |
Details
From the project READMEYeehaw — Austin events, as an MCP server 🤠
Yeehaw is an agent-first city concierge for Austin, TX — the fresh, sourced, citeable answer to "what's happening in Austin?". Ask any LLM that today and it guesses from stale listicles. Yeehaw ships the structured, current, attributable source of truth, exposed as a public MCP server any AI assistant can call.
- 🌐 Site: https://yeehaw.bot · for agents: https://yeehaw.bot/for-agents
- 🔌 MCP endpoint:
https://yeehaw.bot/mcp(JSON-RPC over HTTP) — no signup, no key, free - 📇 Official MCP registry:
bot.yeehaw/events
~2,800 live Austin events aggregated hourly from 10 sources (Ticketmaster, Do512, Luma, Visit Austin, Alamo Drafthouse, Capital Factory, UT Austin, Huston-Tillotson, City of Austin open data, and a Brave-powered discovery net), deduplicated and ranked — every event carries its source.
Connect
Drop-in config for any MCP client (Claude, Cursor, Cline, …):
// .mcp.json
{ "mcpServers": { "yeehaw": { "url": "https://yeehaw.bot/mcp" } } }
Or call it directly:
curl -s https://yeehaw.bot/mcp \
-H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"find_events",
"arguments":{"date_range":"this_weekend","limit":3}}}'
Tools
| Tool | What it does |
|---|---|
find_events | Structured search over the deduped store. Args: date_range (required unless id is set), plus optional query, category, neighborhood, price_max, limit, and id (fetch one event by id). Every result carries a source, a url, coordinates, and a confidence. |
overview | Inspectable state — total events, per-source last-ingest + health, open circuit breakers, coverage by category/neighborhood. Call it to verify freshness before you depend on it. |
See AGENTS.md for the usage contract (when to call what, value ranges, honest caveats).
Why depend on it
- Fresh — re-ingested hourly; past events drop automatically.
- Sourced — every event cites its origin with a clickable link; your assistant can footnote instead of hallucinate.
- Resilient — per-source circuit breakers; a single upstream outage degrades honestly instead of corrupting the answer.
- Honest — ticket prices are sparse upstream, so
price_min/price_maxare oftennull;find_eventsreports how many results it couldn't price rather than guessing.
About
Yeehaw is operated by Capital Thought, LLC (Austin, TX). Not an official City of Austin outlet.
This repo is the public discovery surface (docs + agent contract + registry descriptor). The service itself runs on Cloudflare Workers + Supabase.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.