{
  "markdown": "# Yeehaw — Austin events, as an MCP server 🤠\n\n**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.\n\n- 🌐 Site: **https://yeehaw.bot** · for agents: **https://yeehaw.bot/for-agents**\n- 🔌 MCP endpoint: **`https://yeehaw.bot/mcp`** (JSON-RPC over HTTP) — **no signup, no key, free**\n- 📇 Official MCP registry: `bot.yeehaw/events`\n\n~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**.\n\n## Connect\n\nDrop-in config for any MCP client (Claude, Cursor, Cline, …):\n\n```jsonc\n// .mcp.json\n{ \"mcpServers\": { \"yeehaw\": { \"url\": \"https://yeehaw.bot/mcp\" } } }\n```\n\nOr call it directly:\n\n```bash\ncurl -s https://yeehaw.bot/mcp \\\n  -H 'content-type: application/json' \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\n       \"params\":{\"name\":\"find_events\",\n         \"arguments\":{\"date_range\":\"this_weekend\",\"limit\":3}}}'\n```\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `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`. |\n| `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. |\n\nSee **[AGENTS.md](./AGENTS.md)** for the usage contract (when to call what, value ranges, honest caveats).\n\n## Why depend on it\n\n- **Fresh** — re-ingested hourly; past events drop automatically.\n- **Sourced** — every event cites its origin with a clickable link; your assistant can footnote instead of hallucinate.\n- **Resilient** — per-source circuit breakers; a single upstream outage degrades honestly instead of corrupting the answer.\n- **Honest** — ticket prices are sparse upstream, so `price_min`/`price_max` are often `null`; `find_events` reports how many results it couldn't price rather than guessing.\n\n## About\n\nYeehaw is operated by **Capital Thought, LLC** (Austin, TX). Not an official City of Austin outlet.\n\nThis repo is the public discovery surface (docs + agent contract + registry descriptor). The service itself runs on Cloudflare Workers + Supabase.\n",
  "bytes": 2740,
  "sha": "6f8b05677e1d936952ffbac9ef0d666b4df3c0ae2263b03661e48873d3fc4bd2",
  "repo_slug": "capitalthought/yeehaw-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_bot_yeehaw_events_027facb3/readme"
}