# events [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/capitalthought/yeehaw-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/events-2

## Description
Agent-first Austin events concierge — fresh, sourced answers to what's happening in Austin.

## Tools
Capabilities this server exposes over MCP:

- **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.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "events": {
    "url": "https://yeehaw.bot**"
  }
}
```

## Documentation & README

# Yeehaw — 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, …):

```jsonc
// .mcp.json
{ "mcpServers": { "yeehaw": { "url": "https://yeehaw.bot/mcp" } } }
```

Or call it directly:

```bash
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](./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_max` are often `null`; `find_events` reports 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.