# CleverTech API

> https://clevertech.ca

Canadian municipal data API — property assessments, census profiles, zoning & land use, building permits, telecom infrastructure, and DLS valuations across 20 cities.

CleverTech provides unified REST APIs for Canadian government open data. Each city exposes property, census, zoning, and building permit endpoints. National telecom and DLS APIs cross all jurisdictions.

## Endpoints

- `/api/status` — service health and endpoint map
- `/health` — per-database health checks
- `/api/cities` — list all cities with slugs and API types
- `/docs` — interactive OpenAPI/Swagger documentation
- `/api/calgary/...` — Calgary, Alberta (property, census, zoning, building, business_license)
- `/api/halifax/...` — Halifax, Nova Scotia (property, census, zoning, building)
- `/api/saskatoon/...` — Saskatoon, Saskatchewan (property, census, zoning, building)
- `/api/toronto/...` — Toronto, Ontario (property, census, zoning, building)
- `/api/montreal/...` — Montreal, Quebec (property, census, zoning, building)
- `/api/vancouver/...` — Vancouver, British Columbia (property, census, zoning, building, business_license)
- `/api/edmonton/...` — Edmonton, Alberta (property, census, zoning, building, business_license)
- `/api/ottawa/...` — Ottawa, Ontario (property, census, zoning, building)
- `/api/winnipeg/...` — Winnipeg, Manitoba (property, census, zoning, building, business_license)
- `/api/quebec-city/...` — Quebec City, Quebec (property, census, zoning, building)
- `/api/hamilton/...` — Hamilton, Ontario (property, census, zoning, building)
- `/api/kitchener/...` — Kitchener-Waterloo, Ontario (property, census, zoning, building)
- `/api/mississauga/...` — Mississauga, Ontario (property, census, zoning, building)
- `/api/markham/...` — Markham, Ontario (property, census, zoning, building)
- `/api/vaughan/...` — Vaughan, Ontario (property, census, zoning, building)
- `/api/london/...` — London, Ontario (property, census, zoning, building)
- `/api/regina/...` — Regina, Saskatchewan (property, census, zoning, building)
- `/api/victoria/...` — Victoria, British Columbia (property, census, zoning, building)
- `/api/st-johns/...` — St. John's, Newfoundland and Labrador (property, census, zoning, building)
- `/api/grande-prairie/...` — Grande Prairie, Alberta (property)
- `/api/high-river/...` — High River, Alberta (property)
- `/api/canada/...` — Canada Telecom, Nationwide (telecom)

## Dashboard Pages

- `https://clevertech.ca/` — Landing page — all cities, API overview, quick links
- `https://clevertech.ca/property` — Property assessment dashboard
- `https://clevertech.ca/census` — Census profiles dashboard
- `https://clevertech.ca/building` — Building permits dashboard
- `https://clevertech.ca/registry` — Federal corporation registry dashboard
- `https://clevertech.ca/city/{slug}` — City detail page (e.g., /city/calgary)
- `https://clevertech.ca/telecom` — Telecom tower dashboard (proxied)
- `https://clevertech.ca/mw` — Microwave link dashboard (proxied)
- `https://clevertech.ca/dls` — DLS valuation dashboard (proxied)
- `https://clevertech.ca/zones` — Zoning map dashboard (proxied)
- `https://clevertech.ca/pricing` — Pricing tiers and API key management
- `https://clevertech.ca/hub` — Developer dashboard (manage API keys)

## Authentication

### Device Authorization (recommended for CLI / AI agents)

```bash
# One-command install and authenticate:
uvx clevertech-mcp-server --login
# → Opens a browser URL — sign in with Google (no password in terminal)
# → API key saved to ~/.clevertech/config.json
# → Server starts with authentication active
```

This uses RFC 8628 device flow — the same method as `gh auth login`.
The MCP server wraps the full CleverTech REST API into 11 AI-callable tools.

### Manual API Key Setup

Get a key from the web dashboard: https://clevertech.ca/pricing
Then set in your environment: `export CLEVERTECH_API_KEY=ctk_...`

### Rate Limit Tiers

| Tier | Daily Quota | Rate Limit |
|------|-------------|------------|
| anonymous | 50/day | 10/min |
| developer (free) | 200/day | 30/min |
| pro | 2,000/day | 120/min |
| team | 10,000/day | 600/min |
| enterprise | Custom | Custom |

Full details: https://clevertech.ca/llms-full.txt