# FindEveryShow.com — Complete AI Agent & LLM Technical Reference (/llms-full.txt) > Comprehensive documentation for autonomous agents, travel concierges, MCP clients, and LLM tool callers querying FindEveryShow.com (293 upcoming shows across 29 Roaring Fork Valley venues). --- ## 1. "Near Me" Location & Proximity Resolution Engine Agents frequently know a user's **5-digit zip code** (e.g. `81621`) or **latitude/longitude coordinates** (e.g. `39.1911, -106.8175`) without the user naming a specific Roaring Fork Valley town. FindEveryShow resolves any location input using Haversine great-circle distance to both the 5 Roaring Fork Valley towns and all 29 individual venues. ### Roaring Fork Valley Town Coordinates & Zip Codes | Town | Latitude | Longitude | Primary & Local Zip Codes | | :--- | :--- | :--- | :--- | | **Glenwood Springs** | `39.5505` | `-107.3248` | `81601`, `81602` (also resolves nearby `81647` New Castle, `81652` Silt, `81650` Rifle) | | **Carbondale** | `39.4022` | `-107.2112` | `81623` (incl. Redstone & Marble) | | **Basalt** | `39.3689` | `-107.0328` | `81621`, `81628` (incl. Willits `39.3872, -107.0819` & El Jebel) | | **Snowmass** | `39.2130` | `-106.9378` | `81615`, `81654` (Snowmass Village & Old Snowmass `39.3317, -106.9850`) | | **Aspen** | `39.1911` | `-106.8175` | `81611`, `81612` | ### Supported Location Input Formats 1. **Zip code:** `zip=81621` or `location=81621` 2. **Explicit coordinates:** `lat=39.1911&lng=-106.8175` 3. **Combined coordinate string:** `location=39.1911,-106.8175` 4. **Town or neighborhood name:** `location=Basalt`, `location=Willits`, `location=Snowmass Village`, `location=Glenwood Springs` 5. **Edge IP auto-detection:** `location=near_me` or `location=auto` --- ## 2. Public CORS REST API Endpoints All endpoints return `application/json` with `Access-Control-Allow-Origin: *`. ### `GET /api/events/near-me` Dedicated proximity search endpoint returning `resolved_location`, `nearest_town`, `towns_by_distance`, and upcoming `events` enriched with `distance_miles` and `venue_coordinates`. **Query Parameters:** - `zip` (string): 5-digit US zip code (e.g. `81621`, `81611`, `81623`, `81601`, `81615`, `81647`). - `lat` & `lng` (number): Decimal latitude and longitude. - `location` (string): Zip code, `"lat,lng"`, town name, or `"near_me"`. - `radius_miles` (number, default `35`): Maximum distance in miles from the query point. - `when` / `preset` (string): `tonight`, `weekend`, `7d` (or `week`), `month`. - `from` & `to` (string): `YYYY-MM-DD` date range. - `cat` / `category` (string): `music`, `comedy`, `theater`. - `free` (boolean `1`/`true`): Only free shows. - `q` (string): Keyword search. - `sort` (string): `distance` (default: closest first, then date/time) or `date_then_distance`. - `limit` (integer, default `50`). **Example Invocations:** ```bash # Find shows near Basalt zip code 81621 sorted by distance curl -s "https://findeveryshow.com/api/events/near-me?zip=81621&limit=5" # Find shows near Aspen coordinates within 15 miles this weekend curl -s "https://findeveryshow.com/api/events/near-me?lat=39.1911&lng=-106.8175&radius_miles=15&preset=weekend" ``` ### `GET /api/events` Full calendar query endpoint. Supports all traditional filters (`town`, `venue`, `cat`, `when`, `from`, `to`, `free`, `q`) plus `location`, `zip`, `lat`, `lng`, `radius_miles`, `sort` (`date` or `distance`), `limit`, and `offset`. ```bash # Resolve zip code 81623 to Carbondale and return Carbondale events curl -s "https://findeveryshow.com/api/events?location=81623" ``` ### `GET /api/venues` and `GET /api/venues/` Returns all 29 Roaring Fork Valley venues with coordinates, zip codes, addresses, canonical URLs, free show counts, and next show. Pass `zip` or `lat`/`lng` or `location` to compute `distance_miles` and sort venues by proximity. ```bash curl -s "https://findeveryshow.com/api/venues?zip=81611" curl -s "https://findeveryshow.com/api/venues/wheeler-opera-house" ``` ### `GET /api/artists` and `GET /api/artists/` Returns all indexed performers across the 12-month horizon with verified Spotify, Apple Music, YouTube, and Instagram URLs and upcoming valley dates. ```bash curl -s "https://findeveryshow.com/api/artists?q=digable" curl -s "https://findeveryshow.com/api/artists/digable-planets" ``` --- ## 3. Web MCP Server (`POST https://findeveryshow.com/mcp`) Standards-compliant Model Context Protocol (MCP) server over Streamable HTTP JSON-RPC 2.0 (`protocolVersion: "2025-03-26"`). No API key required. ### MCP Client Configuration ```json { "mcpServers": { "findeveryshow": { "url": "https://findeveryshow.com/mcp" } } } ``` ### Available MCP Tools (7) 1. `events_near_me`: Proximity search by `zip`, `lat`/`lng`, or `location`, returning shows sorted by `distance_miles`. 2. `search_events`: Multi-filter show search by `location`, `zip`, `lat`/`lng`, `town`, `venue`, `category`, `query`, `date_preset`, `date_from`, `date_to`, `free_only`, `limit`. 3. `get_tonights_shows`: Shows happening tonight (with automatic weekend fallback) optionally filtered by `location`/`zip`/`lat,lng`. 4. `get_venue_details`: Detailed venue metadata, coordinates, and upcoming lineup by `venue` slug/name, or all 29 venues sorted by proximity. 5. `get_artist_details`: Artist streaming links (`spotify_url`, `apple_music_url`, `youtube_url`, `instagram_url`) and valley tour dates. 6. `subscribe_user`: Subscribe a user (`email`, optional `phone`, `towns` or `location`/`zip`, `categories`, `music_service`, `source_venue`, `source_artist`) to the weekly digest. 7. `manage_household_tickets`: View, add, or remove shows on a household ticket list (`action: "list" | "add" | "remove"`, `list_key`, `event_id`, `note`) with same-night conflict detection. ### Example MCP JSON-RPC 2.0 Call (`events_near_me`) ```bash curl -s -X POST https://findeveryshow.com/mcp \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "events_near_me", "arguments": { "zip": "81621", "radius_miles": 25, "limit": 5 } } }' ``` --- ## 4. Complete Directory of All 29 Roaring Fork Valley Venues - **7th St between Colorado & Cooper** (`7th-st-between-colorado-cooper`) | Town: Glenwood Springs | Zip: `81601` | Coords: `39.5484, -107.3235` | Address: 7th St & Cooper Ave, Glenwood Springs, CO 81601 | Shows: 0 (0 free) | URL: https://findeveryshow.com/v/rfv/7th-st-between-colorado-cooper - **Glenwood Caverns Adventure Park** (`glenwood-caverns-adventure-park`) | Town: Glenwood Springs | Zip: `81601` | Coords: `39.5594, -107.3211` | Address: 51000 Two Rivers Plaza Rd, Glenwood Springs, CO 81601 | Shows: 2 (0 free) | URL: https://findeveryshow.com/v/rfv/glenwood-caverns-adventure-park - **Glenwood Springs Center for the Arts** (`glenwood-springs-center-for-the-arts`) | Town: Glenwood Springs | Zip: `81601` | Coords: `39.5492, -107.3264` | Address: 601 E 6th St, Glenwood Springs, CO 81601 | Shows: 0 (0 free) | URL: https://findeveryshow.com/v/rfv/glenwood-springs-center-for-the-arts - **Glenwood Springs High School** (`glenwood-springs-high-school`) | Town: Glenwood Springs | Zip: `81601` | Coords: `39.5389, -107.3258` | Address: 1521 Grand Ave, Glenwood Springs, CO 81601 | Shows: 0 (0 free) | URL: https://findeveryshow.com/v/rfv/glenwood-springs-high-school - **Glenwood Vaudeville Revue** (`glenwood-vaudeville-revue`) | Town: Glenwood Springs | Zip: `81601` | Coords: `39.5467, -107.3245` | Address: 915 Grand Ave, Glenwood Springs, CO 81601 | Shows: 20 (0 free) | URL: https://findeveryshow.com/v/rfv/glenwood-vaudeville-revue - **Hotel Colorado** (`hotel-colorado`) | Town: Glenwood Springs | Zip: `81601` | Coords: `39.5508, -107.3228` | Address: 526 Pine St, Glenwood Springs, CO 81601 | Shows: 0 (0 free) | URL: https://findeveryshow.com/v/rfv/hotel-colorado - **Iron Mountain Hot Springs** (`iron-mountain-hot-springs`) | Town: Glenwood Springs | Zip: `81601` | Coords: `39.5567, -107.3389` | Address: 281 Centennial St, Glenwood Springs, CO 81601 | Shows: 0 (0 free) | URL: https://findeveryshow.com/v/rfv/iron-mountain-hot-springs - **Symphony in the Valley** (`symphony-in-the-valley`) | Town: Glenwood Springs | Zip: `81601` | Coords: `39.5389, -107.3258` | Address: 1521 Grand Ave, Glenwood Springs, CO 81601 | Shows: 0 (0 free) | URL: https://findeveryshow.com/v/rfv/symphony-in-the-valley - **579 Main St** (`579-main-st`) | Town: Carbondale | Zip: `81623` | Coords: `39.4005, -107.2142` | Address: 579 Main St, Carbondale, CO 81623 | Shows: 0 (0 free) | URL: https://findeveryshow.com/v/rfv/579-main-st - **Carbondale Arts** (`carbondale-arts`) | Town: Carbondale | Zip: `81623` | Coords: `39.4021, -107.2104` | Address: 76 S 4th St, Carbondale, CO 81623 | Shows: 0 (0 free) | URL: https://findeveryshow.com/v/rfv/carbondale-arts - **Crystal Theatre** (`crystal-theatre`) | Town: Carbondale | Zip: `81623` | Coords: `39.4006, -107.2122` | Address: 427 Main St, Carbondale, CO 81623 | Shows: 0 (0 free) | URL: https://findeveryshow.com/v/rfv/crystal-theatre - **El Dorado** (`el-dorado`) | Town: Carbondale | Zip: `81623` | Coords: `39.4007, -107.2128` | Address: 439 Main St, Carbondale, CO 81623 | Shows: 0 (0 free) | URL: https://findeveryshow.com/v/rfv/el-dorado - **Old Thompson Barn** (`old-thompson-barn`) | Town: Carbondale | Zip: `81623` | Coords: `39.3892, -107.221` | Address: 333 River Valley Ranch Rd, Carbondale, CO 81623 | Shows: 0 (0 free) | URL: https://findeveryshow.com/v/rfv/old-thompson-barn - **Steve's Guitars** (`steves-guitars`) | Town: Carbondale | Zip: `81623` | Coords: `39.4005, -107.2131` | Address: 19 N 4th St, Carbondale, CO 81623 | Shows: 4 (0 free) | URL: https://findeveryshow.com/v/rfv/steves-guitars - **Thunder River Theatre** (`thunder-river-theatre`) | Town: Carbondale | Zip: `81623` | Coords: `39.4018, -107.2144` | Address: 67 Promenade, Carbondale, CO 81623 | Shows: 42 (0 free) | URL: https://findeveryshow.com/v/rfv/thunder-river-theatre - **Townline Trucks** (`townline-trucks`) | Town: Carbondale | Zip: `81623` | Coords: `39.4045, -107.2162` | Address: 824 Hwy 133, Carbondale, CO 81623 | Shows: 0 (0 free) | URL: https://findeveryshow.com/v/rfv/townline-trucks - **Basalt Regional Library** (`basalt-regional-library`) | Town: Basalt | Zip: `81621` | Coords: `39.3672, -107.0345` | Address: 14 Midland Ave, Basalt, CO 81621 | Shows: 0 (0 free) | URL: https://findeveryshow.com/v/rfv/basalt-regional-library - **Heather's** (`heathers`) | Town: Basalt | Zip: `81621` | Coords: `39.3683, -107.0315` | Address: 166 Midland Ave, Basalt, CO 81621 | Shows: 10 (10 free) | URL: https://findeveryshow.com/v/rfv/heathers - **TACAW** (`tacaw`) | Town: Basalt | Zip: `81621` | Coords: `39.3875, -107.0835` | Address: 400 Robinson St, Basalt, CO 81621 | Shows: 33 (0 free) | URL: https://findeveryshow.com/v/rfv/tacaw - **The Hoffmann** (`the-hoffmann`) | Town: Basalt | Zip: `81621` | Coords: `39.3865, -107.0825` | Address: 900 E Valley Rd, Basalt, CO 81621 | Shows: 0 (0 free) | URL: https://findeveryshow.com/v/rfv/the-hoffmann - **Snowmass Town Park** (`snowmass-town-park`) | Town: Snowmass | Zip: `81615` | Coords: `39.2166, -106.9325` | Address: 2909 Brush Creek Rd, Snowmass Village, CO 81615 | Shows: 1 (0 free) | URL: https://findeveryshow.com/v/rfv/snowmass-town-park - **The Collective Snowmass** (`the-collective-snowmass`) | Town: Snowmass | Zip: `81615` | Coords: `39.2084, -106.9491` | Address: 45 Village Square, Snowmass Village, CO 81615 | Shows: 15 (15 free) | URL: https://findeveryshow.com/v/rfv/the-collective-snowmass - **Belly Up Aspen** (`belly-up-aspen`) | Town: Aspen | Zip: `81611` | Coords: `39.1886, -106.8175` | Address: 450 S Galena St, Aspen, CO 81611 | Shows: 41 (0 free) | URL: https://findeveryshow.com/v/rfv/belly-up-aspen - **Christ Episcopal Church** (`christ-episcopal-church`) | Town: Aspen | Zip: `81611` | Coords: `39.1916, -106.8253` | Address: 536 W North St, Aspen, CO 81611 | Shows: 0 (0 free) | URL: https://findeveryshow.com/v/rfv/christ-episcopal-church - **Harris Hall** (`harris-hall`) | Town: Aspen | Zip: `81611` | Coords: `39.1997, -106.8267` | Address: 960 N 3rd St, Aspen, CO 81611 | Shows: 0 (0 free) | URL: https://findeveryshow.com/v/rfv/harris-hall - **Mawa's Kitchen** (`mawas-kitchen`) | Town: Aspen | Zip: `81611` | Coords: `39.2189, -106.8519` | Address: 305 Aspen Airport Business Center, Aspen, CO 81611 | Shows: 0 (0 free) | URL: https://findeveryshow.com/v/rfv/mawas-kitchen - **MOLLIE Aspen** (`mollie-aspen`) | Town: Aspen | Zip: `81611` | Coords: `39.1908, -106.8236` | Address: 111 S Garmisch St, Aspen, CO 81611 | Shows: 0 (0 free) | URL: https://findeveryshow.com/v/rfv/mollie-aspen - **Paul JAS Center** (`paul-jas-center`) | Town: Aspen | Zip: `81611` | Coords: `39.1904, -106.8206` | Address: 300 E Hyman Ave, Aspen, CO 81611 | Shows: 54 (8 free) | URL: https://findeveryshow.com/v/rfv/paul-jas-center - **Wheeler Opera House** (`wheeler-opera-house`) | Town: Aspen | Zip: `81611` | Coords: `39.1897, -106.8189` | Address: 320 E Hyman Ave, Aspen, CO 81611 | Shows: 71 (1 free) | URL: https://findeveryshow.com/v/rfv/wheeler-opera-house