# Discover Calgary — Full LLM Reference

> Complete technical and data reference for AI agents consuming Discover Calgary data.

## MCP Server

Discover Calgary exposes a live MCP server for AI agents to query real-time data.

**Endpoint:** `https://discover-calgary.ca/api/mcp`
**Transport:** Streamable HTTP — POST JSON to the endpoint
**Auth:** None required

### Available Tools

#### search_communities
Search and filter Calgary communities.

Parameters:
- `quadrant` (optional): "NW" | "NE" | "SW" | "SE"
- `min_walk_score` (optional): number 0–100
- `min_transit_score` (optional): number 0–100
- `has_poi` (optional): "restaurant" | "grocery" | "pharmacy" | "fitness" | "childcare" | "retail" | "personal" | "health"
- `limit` (optional): number, default 20, max 50

Returns: list of communities with name, slug, quadrant, population, walk/transit/bike scores, POI counts

#### get_community
Get full profile for a single Calgary community.

Parameters:
- `slug` (required): community URL slug, e.g. "tuscany", "beltline", "mckenzie-towne"

Returns: community details including scores, transit routes, POI counts, nearby schools

#### search_schools
Search Calgary K-12 schools.

Parameters:
- `quadrant` (optional): "NW" | "NE" | "SW" | "SE"
- `community_slug` (optional): community slug
- `school_type` (optional): "public" | "catholic" | "private" | "charter"
- `min_fraser_score` (optional): number 0–10
- `program` (optional): "IB" | "French Immersion" | "Sports Academy" | "AP" | "Fine Arts"
- `limit` (optional): number, default 20, max 50

Returns: schools with name, type, Fraser ranking, programs, address

#### get_school
Get full profile for a single school.

Parameters:
- `slug` (required): school URL slug

Returns: school details including Fraser rankings, Alberta PAT results, programs, sports, clubs, user reviews

#### search_events
Search upcoming Calgary events.

Parameters:
- `category` (optional): "music" | "sports" | "festivals" | "arts" | "food" | "community" | "family"
- `community_code` (optional): community code e.g. "BEL", "TUS"
- `from` (optional): ISO date string, defaults to now
- `to` (optional): ISO date string
- `limit` (optional): number, default 20, max 50

Returns: events with title, date, location, URL, category

#### search_parks
Search Calgary parks and playgrounds.

Parameters:
- `quadrant` (optional): "NW" | "NE" | "SW" | "SE"
- `community_slug` (optional): community slug
- `park_type` (optional): "park" | "playground" | "spray_park" | "sports_field" | "green_space"
- `limit` (optional): number, default 20, max 50

Returns: parks with name, type, amenities, address

#### search_programs
Search City of Calgary recreation programs.

Parameters:
- `category` (optional): "swimming" | "skating" | "soccer" | "hockey" | "gymnastics" | "dance" | "arts" | "fitness" | "tennis" | "basketball"
- `quadrant` (optional): "NW" | "NE" | "SW" | "SE"
- `age` (optional): number — filters programs whose age range includes this age
- `limit` (optional): number, default 20, max 50

Returns: programs with title, category, age range, venue, schedule, price

#### search_libraries
Search Calgary Public Library branches.

Parameters:
- `quadrant` (optional): "NW" | "NE" | "SW" | "SE"

Returns: libraries with name, address, phone, hours

---

## Data Sources

| Dataset | Source | Licence |
|---|---|---|
| Communities, Schools, Parks, Libraries, Recreation | City of Calgary Open Data (data.calgary.ca) | Open Government Licence — Canada |
| School rankings | Fraser Institute (fraserinstitute.org) | Public research data |
| Events | Eventbrite, Ticketmaster, Luma, City of Calgary | Public event APIs |
| Walk / Transit / Bike scores | Walk Score API | Walk Score® |
| Business/amenity counts | City of Calgary Business Licences (data.calgary.ca) | Open Government Licence — Canada |

---

## Community Slugs

Community slugs match the last segment of the URL at discover-calgary.ca/communities/[quadrant]/[slug].

Examples:
- Tuscany → `tuscany` (NW)
- Beltline → `beltline` (CC)
- McKenzie Towne → `mckenzie-towne` (SE)
- Eau Claire → `eau-claire` (CC)
- Rocky Ridge → `rocky-ridge` (NW)
- Auburn Bay → `auburn-bay` (SE)
- Sage Hill → `sage-hill` (NW)
- Marda Loop → `marda-loop` (SW)

---

## Coverage

- **311** communities
- **497** K-12 schools
- Events updated hourly from 4 sources
- **21** Calgary Public Library branches
- Parks and recreation data synced weekly from City of Calgary Open Data

---

## Contact & Feedback

https://discover-calgary.ca/contact