# Canada Air Quality (AQHI)

> Canada's Air Quality Health Index for any postal code — wildfire-smoke checks, forecasts and multi-site monitoring from your AI agent.

Remote MCP server (Streamable HTTP): https://ca-air-quality-mcp.donniertf.workers.dev/mcp
Free tier: `air_quality` — no key, no sign-up, 20 calls/day per IP.
Pro: C$12/month, cancel anytime — all tools, unlimited.

## Tools
- air_quality (free): FREE. Latest Air Quality Health Index (AQHI 1–10+) and risk level at the station nearest a Canadian postal code.
- aqhi_forecast (Pro): PRO. AQHI forecasts for the nearest station (next periods), plus the current observation.
- sites_check (Pro): PRO. Current AQHI for up to 25 postal codes, worst first — e.g. wildfire smoke checks for sites, schools or crews.
- region_watch (Pro): PRO. All AQHI stations within a radius (km, max 400) of a postal code with readings at or above a threshold.

## Buying (agents)
1. POST https://ca-air-quality-mcp.donniertf.workers.dev/checkout -> {checkout_url, session_id}. A human (or a payment-capable agent) completes Stripe Checkout at checkout_url.
2. GET https://ca-air-quality-mcp.donniertf.workers.dev/token?session_id=... -> {access_token}.
3. Send Authorization: Bearer <access_token> to https://ca-air-quality-mcp.donniertf.workers.dev/mcp (or pass access_token in tool arguments).

## Pay per call (x402, USDC on Base)
No account: POST JSON args to https://ca-air-quality-mcp.donniertf.workers.dev/x402/<tool> -> HTTP 402 with payment requirements ($0.03 USDC per call, payTo 0x02226D28e0c85AE4AdDB7fe7043Dd2b1Ff710D41). Retry with an X-PAYMENT header (x402 v1, scheme exact, network base). Manifest: https://ca-air-quality-mcp.donniertf.workers.dev/.well-known/x402. MCP clients may also send X-PAYMENT on tools/call.
Machine-readable pricing: https://ca-air-quality-mcp.donniertf.workers.dev/pricing.json · Server card: https://ca-air-quality-mcp.donniertf.workers.dev/.well-known/mcp

## Sources
- Environment and Climate Change Canada AQHI via MSC GeoMet OGC API (Open Government Licence – Canada)
- Zippopotam.us postal area geocoding

## Notes
Air Quality Health Index (AQHI) from Environment and Climate Change Canada (MSC GeoMet API). Health guidance: follow official AQHI advice and local public health.
Contact: dmorrisonwebdesign@gmail.com. More UK data MCPs: https://github.com/donniertf-hub/uk-mcp-fleet