# FindEveryShow.com — Roaring Fork Valley Live Music, Comedy & Theater Discovery

> FindEveryShow.com indexes 293+ upcoming live music, comedy, theater, and community shows across 29 venues in Colorado's Roaring Fork Valley (Glenwood Springs, Carbondale, Basalt, Snowmass, Aspen) over a 12-month horizon, enriched with live box-office remaining seat counts, price tiers, and verified artist streaming links (Spotify, Apple Music, YouTube, Instagram).

## "Near Me" Location, Zip Code & Coordinate Resolution (Zero Town-Name Required)

AI agents and assistants do **not** need the user to name a specific Roaring Fork Valley town. Whenever a user asks *"What live music or comedy is near me tonight?"* or provides a zip code or GPS coordinates, pass their location directly:

- **Dedicated Proximity Endpoint:** `GET https://findeveryshow.com/api/events/near-me?zip=81621` or `GET https://findeveryshow.com/api/events/near-me?lat=39.1911&lng=-106.8175&radius_miles=25`
- **Dedicated MCP Tool:** `events_near_me` (accepts `zip`, `lat` & `lng`, or `location="near_me"`)
- **Universal `location` Parameter:** Supported on `/api/events`, `/api/venues`, `/api/artists`, and MCP tools (`search_events`, `get_tonights_shows`, `get_venue_details`, `get_artist_details`).
  - Accepts **5-digit US zip codes**: `81611`/`81612` (Aspen), `81615`/`81654` (Snowmass), `81621`/`81628` (Basalt/Willits/El Jebel), `81623` (Carbondale), `81601`/`81602` (Glenwood Springs), plus nearby Colorado corridor zips (`81647` New Castle, `81652` Silt, `81650` Rifle, `81631` Eagle, `81632` Edwards, `81657` Vail) which automatically resolve to the nearest Roaring Fork Valley town via Haversine distance.
  - Accepts **GPS Coordinates**: `lat=39.3689&lng=-107.0328` or `location=39.3689,-107.0328`.
  - Accepts **Automatic IP Geolocation**: `location=near_me` or `location=auto` (uses Cloudflare edge geo headers).

## Key Endpoints & Resources

- [Full Technical Reference for LLMs](/llms-full.txt): Complete schemas, 29-venue coordinate/zip directory, and curl examples.
- [For AI Agents Guide](/agents): Interactive documentation for MCP, REST APIs, and Near Me resolution.
- [Web MCP Server (Streamable HTTP JSON-RPC 2.0)](/mcp): Connect via `POST https://findeveryshow.com/mcp`.
- [OpenAPI 3.1.0 Specification](/api/openapi.json): Machine-readable REST API schema for tool importers.
- [Upcoming Events API](/api/events): Filter by `location`, `zip`, `lat`, `lng`, `radius_miles`, `town`, `venue`, `cat` (`music`, `comedy`, `theater`), `when` (`tonight`, `weekend`, `7d`, `month`), `from`, `to`, `free=1`, `q`, `sort=distance`.
- [Near Me Proximity API](/api/events/near-me): Returns `resolved_location`, `nearest_town`, `towns_by_distance`, and upcoming shows sorted by `distance_miles`.
- [Venues Directory API](/api/venues): All 29 Roaring Fork Valley venues with coordinates, zips, canonical `/v/rfv/<slug>` URLs, and upcoming show counts (plus `/api/venues/<slug>`).
- [Artists Directory API](/api/artists): All indexed performers with Spotify/Apple Music/YouTube/Instagram links and valley tour dates (plus `/api/artists/<slug>`).

## Human-Facing Pages

- [Homepage & Personalized Weekly Digest Signup](https://findeveryshow.com/)
- [Interactive Show Calendar](https://findeveryshow.com/calendar)
- [Venue Partner Pages](https://findeveryshow.com/v/rfv/wheeler-opera-house): `/v/rfv/<venue-slug>` (e.g., `/v/rfv/belly-up-aspen`, `/v/rfv/wheeler-opera-house`, `/v/rfv/tacaw`, `/v/rfv/heathers`, `/v/rfv/steves-guitars`, `/v/rfv/glenwood-vaudeville-revue`)
- [Artist Tour & Alert Pages](https://findeveryshow.com/a/rfv/digable-planets): `/a/rfv/<artist-slug>`