# Frolic — Denver Event Discovery (Full Context)
> Frolic aggregates and curates events happening in Denver, Colorado.
> Updated daily from 12+ local sources. Covers concerts, festivals,
> outdoor activities, food & drink, family events, and more.
> Generated: 2026-09-08T16:28:00.446Z

## Capabilities
- Search events by keyword, category, date, price, accessibility
- Get event details with venue, pricing, dates, accessibility info
- Browse by category: outdoor, music, food-drink, family, free, etc.
- Filter: dog-friendly, family-friendly, wheelchair accessible, free

## API Access
- Public API: https://frolic.town/api/v1/
- OpenAPI Spec: https://frolic.town/openapi.json
- Agent Manifest: https://frolic.town/.well-known/agent.json
- MCP Server: https://frolic.town/mcp (streamable HTTP transport)

## Key Pages
- All Denver events: https://frolic.town/denver
- This weekend: https://frolic.town/denver/this-weekend
- Free events: https://frolic.town/denver/free
- Outdoor events: https://frolic.town/denver/outdoor
- Live music: https://frolic.town/denver/live-music
- Food & drink: https://frolic.town/denver/food-drink
- Family events: https://frolic.town/denver/family

## Categories
  - Live Music (5350 events)
  - Community (3769 events)
  - Arts & Culture (3748 events)
  - Nightlife (2101 events)
  - Family & Kids (1925 events)
  - Food & Drink (1375 events)
  - Sports & Fitness (1231 events)
  - Classes & Workshops (1221 events)
  - Film & Media (869 events)
  - Markets & Shopping (828 events)
  - Outdoor & Nature (750 events)
  - Festival (741 events)
  - Wellness (699 events)
  - Comedy (427 events)
  - Holiday & Seasonal (298 events)
  - Music (238 events)
  - Activities & Entertainment (155 events)
  - Support Groups (99 events)
  - Arts & Theatre (71 events)
  - Sports (46 events)
  - Games (32 events)
  - Health & Fitness (26 events)
  - Karaoke/Trivia/Open Mics (23 events)
  - Writing & Literature (16 events)
  - Youth & Young Adult (16 events)
  - History (12 events)
  - Transgender (10 events)
  - Theatre & Performing Arts (9 events)
  - Tourism (9 events)
  - Career & Business (8 events)
  - Other (8 events)
  - Miscellaneous (7 events)
  - Special Events (6 events)
  - Tours (6 events)
  - Technology (5 events)
  - Lectures (5 events)
  - Young Adults and Adults Program (4 events)
  - Leadership (2 events)
  - Policy (2 events)
  - Visual Arts (2 events)
  - Talks (2 events)
  - Food (2 events)
  - Travel & Outdoor (2 events)
  - Older Adults (2 events)
  - Performances and Screenings (2 events)
  - Games & Activities (2 events)
  - Book Clubs & Storytime (1 events)
  - Talks & Performances (1 events)
  - Immersive Experiences (1 events)
  - Resources (1 events)
  - Writing (1 events)
  - Home & Garden (1 events)
  - Dancing (1 events)
  - Social & Nightlife (1 events)
  - Young Adult & Adults Program (1 events)
  - Pets & Animals (1 events)
  - Identity & Language (1 events)
  - Music and nightlife (1 events)

## API Documentation

### List Events
```bash
curl "https://frolic.town/api/v1/events?pageSize=10&sort=date"
curl "https://frolic.town/api/v1/events?category=outdoor&dateKeyword=this-weekend"
curl "https://frolic.town/api/v1/events?isFree=true&isFamilyFriendly=true"
```

Query parameters:
- page (int, default 1) — page number
- pageSize (int, default 20, max 100) — results per page
- category (string) — filter by category name (e.g. "outdoor", "music", "food")
- dateKeyword (string) — "today", "this-weekend", "this-week", "this-month"
- isFree (boolean) — free events only
- isDogFriendly (boolean) — dog-friendly events
- isFamilyFriendly (boolean) — family-friendly events
- isOutdoor (boolean) — outdoor events
- sort (string) — "date" (default) or "relevance"
- lat, lon (float) — search origin coordinates
- radius (float) — search radius in miles

### Search Events (Natural Language)
```bash
curl "https://frolic.town/api/v1/events/search?q=live+music+this+weekend"
curl "https://frolic.town/api/v1/events/search?q=free+family+activities+outdoors"
curl "https://frolic.town/api/v1/events/search?q=beer+festivals+near+downtown"
```

Query parameters:
- q (string, required) — natural language search query
- All parameters from List Events also apply

### Get Event Details
```bash
curl "https://frolic.town/api/v1/events/{eventId}"
```

Returns full event with venue, pricing, accessibility, dates, contact, organizer, and upcoming occurrences.

### Convenience Endpoints
```bash
curl "https://frolic.town/api/v1/events/this-weekend"
curl "https://frolic.town/api/v1/events/free"
```

### Get Categories
```bash
curl "https://frolic.town/api/v1/categories"
```

Returns all event categories with counts: { name, slug, count }

## Response Format
All endpoints return:
```json
{
  "data": [...],
  "pagination": { "total": 142, "page": 1, "pageSize": 20, "totalPages": 8 },
  "_meta": {
    "api_version": "v1",
    "generated_at": "2026-03-09T12:00:00Z",
    "coverage": "Denver, CO"
  }
}
```

## Event Data Schema
Each event includes:
- id (string) — unique identifier (MongoDB ObjectId)
- title (string) — event name
- description (string) — full description
- category (string) — primary category
- tags (string[]) — additional tags
- url (string) — original event source URL
- imageUrl (string) — event image
- isFree (boolean) — whether the event is free
- priceMin, priceMax (number) — price range in USD
- venue.name, venue.address, venue.city — location details
- venue.coordinates.latitude, venue.coordinates.longitude — GPS coordinates
- startAt, endAt (ISO 8601) — next occurrence dates
- accessibility.isOutdoor, isDogFriendly, isFamilyFriendly, isWheelchairAccessible
- contact.website, contact.phone, contact.email
- organizer.name, organizer.type, organizer.website

## Upcoming Events (Top 20)
  - Strolling Stories at Chatfield Farms: Busy Birds | 2026-09-08 | Denver Botanic Gardens – Chatfield Farms | https://frolic.town/denver/events/6a9a8e37e92b4eb2a193b870
  - Family Storytime | 2026-09-08 | Ross-Phyllis Bigpond Main Community Room | https://frolic.town/denver/events/6a9d2f7f04ab264802859eea
  - Clases de Computación para Adultos en la Biblioteca Davies | 2026-09-08 | Davies Library | https://frolic.town/denver/events/6a9fe88b306e9a4a5b35b8c0
  - All Seasons Intergenerational Choir Fall Session | 2026-09-08 | Sam Gary, Study Room A: Beverly & Hal Haddon | https://frolic.town/denver/events/6a9d2f7d04ab264802859eb3
  - Men’s Coffee Group (SAGE) | 2026-09-08 | The Center on Colfax | https://frolic.town/denver/events/6a916ad367cc5a9af20de837
  - Tech Tutoring | 2026-09-08 | Broomfield Library and Auditorium | https://frolic.town/denver/events/6a9fe88c306e9a4a5b35b8d3
  - School Cents at FlatIron Crossing | 2026-09-08 | FlatIron Crossing | https://frolic.town/denver/events/6a9fe88d306e9a4a5b35b8de
  - Determined to Fly | 2026-09-08 | Wings Over the Rockies Air & Space Museum | https://frolic.town/denver/events/6a9fe88d306e9a4a5b35b8e9
  - Drop-In Tech Help | 2026-09-08 | Bob Ragland Library | https://frolic.town/denver/events/6a9d2f7d04ab264802859ebe
  - Celestial Seasonings Tea Factory Tour | 2026-09-08 | Celestial Seasonings | https://frolic.town/denver/events/6a9aa4f3e92b4eb2a193df39
  - Visit Mines Museum of Earth Science | 2026-09-08 | Colorado School of Mines Geology Museum | https://frolic.town/denver/events/6a9aa4f3e92b4eb2a193df44
  - AMC Theatres Offers Discounted Matinée Pricing | 2026-09-08 | AMC Theatres – Multiple Locations | https://frolic.town/denver/events/6a9aa4f4e92b4eb2a193df4f
  - Resource Navigation | 2026-09-08 | Central Library | https://frolic.town/denver/events/6a9d2f7e04ab264802859ec9
  - Get 50% Off Tickets at AMC Theatres | 2026-09-08 | AMC Theatres – Multiple Locations | https://frolic.town/denver/events/6a9aa4f4e92b4eb2a193df5a
  - Market at the Center | 2026-09-08 | Main Campus Plaza at the National Western Center | https://frolic.town/denver/events/6a9fdacf306e9a4a5b35acac
  - Preschool Storytime | 2026-09-08 | Decker, Decker Basement Community Room | https://frolic.town/denver/events/6a9d2f7e04ab264802859ed4
  - Toddler Storytime | 2026-09-08 | Rodolfo "Corky" Gonzales Branch Library — Lena Archuleta Community Room | https://frolic.town/denver/events/6a9d2f7f04ab264802859ef5
  - Garden Guides | 2026-09-08 | Denver Art Museum Sensory Garden | https://frolic.town/denver/events/6a9d2f3d04ab2648028599d9
  - Baby Storytime | 2026-09-08 | Ross-Cherry Creek, Ross-Cherry Creek Basement Community Room | https://frolic.town/denver/events/6a9d2f7f04ab264802859edf
  - Tour Central Library | 2026-09-08 | Athmar Park Branch Library, Athmar Park Community Room | https://frolic.town/denver/events/6a42320c5ad992f8e8d34df5

## MCP Server (Model Context Protocol)
Connect AI agents natively via MCP at https://frolic.town/mcp (streamable HTTP transport).

Available tools:
- search_events — Search events by keyword, category, date, budget, accessibility
- get_event — Get full event details by ID
- list_categories — List all event categories with counts
- get_events_this_weekend — Events happening this Friday-Sunday
- get_free_events — Free events in Denver
- get_events_nearby — Events near a lat/lon location

## Rate Limits
- 100 requests per hour per IP
- No authentication required
- CORS enabled for all origins