AGORA / DEVELOPERS

API & MCP

Connect your application or AI assistant to the same versioned reference data. Credentials stay on your server.

REST API

Send your API token as a Bearer token or X-API-Key. education:read grants the public projection; education:preview adds datasets under review.

curl 'https://dev-agora.css.quebec/api/v1/programmes?language=fr' \
  -H 'Authorization: Bearer $AGORA_API_TOKEN'

GET	Purpose
`/api/v1/datasets`	Authorized datasets, hashes and array pointers
`/api/v1/programmes?view=preview`	Consolidated catalogue; review scope required
`/api/v1/programmes/5388`	One published programme version
`/api/v1/centres?q=`	Registered centres and sites
`/api/v1/datasets/{id}/records`	Search, pointer, offset, limit (maximum 200)
`/api/v1/datasets/{id}/document`	Full authorized JSON, ETag, conditional request
`/api/v1/education/fp`	Reviewed projection for dep.quebec
`/api/openapi`	OpenAPI specification

MCP · OAuth 2.1

Use this endpoint in your MCP client. Dynamic registration, ZITADEL sign-in and explicit consent follow automatically in compatible clients.

https://dev-agora.css.quebec/api/mcp

Authorization Code + PKCE S256, resource-bound RS256 tokens (15 minutes), rotating refresh tokens (8 hours), revocation. API tokens are reserved for REST.

{
  "mcpServers": {
    "agora": {
      "url": "https://dev-agora.css.quebec/api/mcp"
    }
  }
}

Available tools

list_datasets · query_dataset · get_dataset_metadata · get_programme · search_programmes · search_centres · get_public_projection

Cache and freshness

Each response identifies its snapshot. A dataset exposes its source hash and import date; an import date never replaces an unknown observation date. dep.quebec keeps a local memory cache and a verified fallback.