{"openapi":"3.1.0","info":{"title":"FindEveryShow.com Public & Agentic API","version":"1.2.0","description":"Live music, comedy, theater, and arts discovery across the Roaring Fork Valley, CO (Glenwood Springs, Carbondale, Basalt, Snowmass, Aspen). Includes 'Near Me' coordinate and 5-digit zip code proximity resolution, live box-office seat inventory, venue & artist directories, and a Streamable HTTP Model Context Protocol (MCP) server at /mcp.","contact":{"name":"FindEveryShow","url":"https://findeveryshow.com/agents"}},"servers":[{"url":"https://findeveryshow.com","description":"Production"}],"paths":{"/api/events/near-me":{"get":{"operationId":"getEventsNearMe","summary":"Find upcoming shows near a zip code, GPS coordinates, or town sorted by proximity","parameters":[{"name":"zip","in":"query","schema":{"type":"string"},"description":"5-digit US zip code (e.g. 81621, 81611, 81623, 81601, 81615)"},{"name":"lat","in":"query","schema":{"type":"number"},"description":"Latitude in decimal degrees (e.g. 39.1911)"},{"name":"lng","in":"query","schema":{"type":"number"},"description":"Longitude in decimal degrees (e.g. -106.8175)"},{"name":"location","in":"query","schema":{"type":"string"},"description":"Zip code, 'lat,lng', town name, or 'near_me'"},{"name":"radius_miles","in":"query","schema":{"type":"number","default":35},"description":"Radius in miles"},{"name":"preset","in":"query","schema":{"type":"string","enum":["tonight","weekend","7d","month"]}},{"name":"category","in":"query","schema":{"type":"string","enum":["music","comedy","theater"]}},{"name":"free","in":"query","schema":{"type":"boolean"}},{"name":"sort","in":"query","schema":{"type":"string","enum":["distance","date_then_distance"],"default":"distance"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50}}],"responses":{"200":{"description":"Upcoming events sorted by proximity with resolved_location metadata"}}}},"/api/events":{"get":{"operationId":"searchEvents","summary":"Search upcoming live music, comedy, and theater events with location/zip/coordinate resolution","parameters":[{"name":"location","in":"query","schema":{"type":"string"},"description":"Town name, 5-digit zip code, 'lat,lng', or 'near_me'"},{"name":"zip","in":"query","schema":{"type":"string"}},{"name":"lat","in":"query","schema":{"type":"number"}},{"name":"lng","in":"query","schema":{"type":"number"}},{"name":"radius_miles","in":"query","schema":{"type":"number"}},{"name":"town","in":"query","schema":{"type":"string"}},{"name":"venue","in":"query","schema":{"type":"string"}},{"name":"cat","in":"query","schema":{"type":"string","enum":["music","comedy","theater"]}},{"name":"when","in":"query","schema":{"type":"string","enum":["tonight","weekend","7d","month"]}},{"name":"from","in":"query","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","schema":{"type":"string","format":"date"}},{"name":"free","in":"query","schema":{"type":"boolean"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string","enum":["date","distance"]}},{"name":"limit","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"Filtered upcoming events"}}}},"/api/venues":{"get":{"operationId":"listVenues","summary":"List all 29 Roaring Fork Valley venues with coordinates, zip codes, and show counts","parameters":[{"name":"location","in":"query","schema":{"type":"string"}},{"name":"zip","in":"query","schema":{"type":"string"}},{"name":"lat","in":"query","schema":{"type":"number"}},{"name":"lng","in":"query","schema":{"type":"number"}},{"name":"town","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Venue directory"}}}},"/api/venues/{slug}":{"get":{"operationId":"getVenueBySlug","summary":"Get full venue details and upcoming shows by venue slug","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Venue details and upcoming shows"}}}},"/api/artists":{"get":{"operationId":"listArtists","summary":"List all indexed performers with streaming links and upcoming valley dates","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"town","in":"query","schema":{"type":"string"}},{"name":"location","in":"query","schema":{"type":"string"}},{"name":"zip","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Artist directory"}}}},"/api/artists/{slug}":{"get":{"operationId":"getArtistBySlug","summary":"Get artist streaming links and upcoming Roaring Fork Valley tour dates","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Artist details and shows"}}}},"/mcp":{"post":{"operationId":"mcpJsonRpc","summary":"Model Context Protocol (MCP) Streamable HTTP JSON-RPC 2.0 endpoint","responses":{"200":{"description":"JSON-RPC 2.0 response"}}}}}}