[ 00 ] Démarrage rapide

LIVE

Une seule clé API.
207 modules de données gouvernementales canadiennes. Chaque réponse est citée.

Obtenez une clé API, effectuez votre premier appel et découvrez le contrat de citation — en moins de 5 minutes.

// Démarrage rapide en 30 secondes

$ curl -s https://api.maplespike.ca/v1/gov/search \
  -H "X-API-Key: ms_live_..." \
  -G -d "query=housing" \
  -d "jurisdiction=federal" \
  -d "_limit=2" | jq .

{
  "success": true,
  "data": { "releases": [...] },
  "citation": {
    "source_name": "open.canada.ca",
    "data_hash": "sha256:a1f3...",
    "license": "OGL-C"
  }
}

Pas de clé ? Obtenez-en une gratuitement à l' inscription — 1 000 appels/mois inclus. Ou passez _mock=true pour des données d'exemple sans appel en amont.

[01] Authentification

Plusieurs façons de s'authentifier

Quatre méthodes d'authentification, un seul format de jeton JWT. Toutes les méthodes émettent le même JWT — choisissez celle qui convient à votre cas d'utilisation.

Clé API (recommandée pour les serveurs)

Créez une clé à partir de l' inscription, puis envoyez-la dans l'en-tête X-API-Key :

$ curl -H "X-API-Key: ms_live_..." https://api.maplespike.ca/v1/health

OAuth (recommandé pour les applications Web)

Connectez-vous avec GitHub, Google ou tout fournisseur OIDC :

# Lister les fournisseurs configurés
$ curl https://api.maplespike.ca/v1/auth/oauth/providers

Portefeuille Web3

Signez un message SIWE (EIP-4361) avec votre portefeuille :

POST /v1/auth/web3/challenge { "address": "0x..." }

Clé d'accès / FIDO2

Enregistrez une clé d'accès (Touch ID, Windows Hello, YubiKey) :

POST /v1/auth/passkey/register/begin { "userId": "..." }

Toutes les méthodes émettent des JWT au même format. Utilisez le jeton comme en-tête Bearer ou cookie de session. Les clés sont hachées avec SHA-256 au repos.

[02] Requête + réponse

Une seule enveloppe. Chaque point de terminaison.

Chaque réponse possède la même structure — données, score de qualité, métadonnées de citation et informations d'utilisation. Votre agent sait toujours d'où vient la réponse.

{
  "success": true,
  "data": { /* structured payload */ },
  "quality": {
    "freshness_seconds": 47,
    "confidence": "high",
    "certainty_score": 0.923
  },
  "citation": {
    "source_name": "open.canada.ca",
    "source_url": "https://...",
    "data_hash": "sha256:a1f3...",
    "license": "OGL-C"
  }
}

[03] Référence API

Points de terminaison REST

Méthode	Chemin	Description
GET	/v1/health	[object Object]
GET	/v1/openapi.json	[object Object]
GET	/v1/me	[object Object]
GET	/v1/usage	[object Object]
GET	/v1/gov/releases	[object Object]
GET	/v1/gov/search?query=	[object Object]
GET	/v1/citation/:hash	[object Object]
GET	/v1/signals	[object Object]
POST	/v1/ai/ask	[object Object]
POST	/v1/ai/search	[object Object]
GET	/v1/ai/models	[object Object]
POST	/v1/ai/analyze	[object Object]
POST	/v1/register	[object Object]
GET	/v1/verify/:token	[object Object]
POST	/v1/auth/refresh	[object Object]
POST	/v1/auth/logout	[object Object]
GET	/v1/keys	[object Object]
POST	/v1/keys	[object Object]
DELETE	/v1/keys/:id	[object Object]
POST	/v1/keys/:id/rotate	[object Object]
POST	/v1/billing/checkout	[object Object]
GET	/v1/billing/plans	[object Object]
GET	/v1/extraction/tasks	[object Object]
POST	/v1/extraction/results	[object Object]
GET	/v1/extraction/cached/:source_id	[object Object]

[04] Points de terminaison IA

EDGE

IA de périphérie — questionnez, recherchez, analysez

Les points de terminaison IA s'exécutent sur la périphérie Cloudflare (Llama 3.3 70B) avec repli automatique vers le cluster du laboratoire maison (Qwen 3.5 27B). Acheminement selon le palier : le palier gratuit utilise la périphérie en premier, pro/affaires utilise le laboratoire maison en premier, entreprise utilise BYOK s'il est configuré.

POST /v1/ai/ask

Posez une question en langage naturel sur les données gouvernementales canadiennes. La réponse inclut la réponse, le modèle utilisé, la source d'inférence (périphérie/laboratoire maison/byok) et l'utilisation de jetons.

$ curl -s -X POST https://api.maplespike.ca/v1/ai/ask \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ms_live_..." \
  -d '{
    "question": "What did the ethics commissioner investigate in 2024?",
    "model": "fast"
  '} | jq .

// Response
{
  "success": true,
  "data": {
    "answer": "The Ethics Commissioner investigated...",
    "model": "@cf/meta/llama-3.1-8b-instruct",
    "source": "edge",
    "tokens": { "prompt": 142, "completion": 89 },
    "cached": false
  },
  "meta": { "tier": "free", "rate_limit_remaining": 9 }
}

Champ facultatif context qui injecte jusqu'à 2 000 caractères de données MapleSpike dans l'invite système. Utilisez model: "fast" pour Llama 3.1 8B (latence réduite), omettez-le pour Llama 3.3 70B (qualité supérieure).

POST /v1/ai/search

Recherche sémantique utilisant des plongements générés en périphérie (BGE base) acheminés vers la base vectorielle Qdrant du laboratoire maison. Repli sur la recherche par mots-clés si la génération de plongements échoue.

$ curl -s -X POST https://api.maplespike.ca/v1/ai/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ms_live_..." \
  -d '{
    "query": "regulatory impacts on small business",
    "limit": 10
  '} | jq .

// Response
{
  "success": true,
  "data": { "results": [...] },
  "meta": { "source": "vector-edge-embedding" }
}

La valeur maximale de limit est 50. Si le service de plongements est indisponible, l'API revient à la recherche par mots-clés via /v1/gov/search et renvoie meta.source: "keyword-fallback".

POST /v1/ai/analyze (Pro tier+)

Submit a document or transcript for LLM-powered analysis. The model extracts key topics, notable entities, and an overall summary. Optionally specify a mode (e.g. "general", "legal", "financial") to hint the analysis focus. Defaults to "general" if omitted.

$ curl -s -X POST https://api.maplespike.ca/v1/ai/analyze \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ms_live_..." \
  -d '{
    "text": "Mr. Speaker, today I am pleased to table Bill C-59...",
    "mode": "general"
  '} | jq .

// Response
{
  "success": true,
  "data": {
    "analysis": "Key Topics: 1) Budget implementation 2) Competition Act amendments...\n\nEntities: Bill C-59, Competition Bureau, Innovation Ministry...\n\nSummary: The speech introduces amendments to...",
    "model": "qwen3.5-4b-local",
    "mode": "general"
  }
}

Unlike /v1/ai/ask and /v1/ai/search which run directly on the Cloudflare edge, this endpoint is proxied to the homelab API server (Qwen 3.5). Requires Pro tier or higher (returns 402 UPGRADE_REQUIRED on Free). Max text length: 50,000 chars (first 8,000 chars are sent to the LLM). If the AI Gateway is unreachable, returns 503 AI_UNAVAILABLE.

GET /v1/ai/models

List available models and tier-aware routing rules. Public endpoint — no API key required.

$ curl -s https://api.maplespike.ca/v1/ai/models | jq .

// Response
{
  "success": true,
  "data": {
    "edge": {
      "chat": "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
      "chatFast": "@cf/meta/llama-3.1-8b-instruct",
      "embedding": "@cf/baai/bge-base-en-v1.5"
    },
    "homelab": "qwen3.5-27b",
    "routing": {
      "free": "edge (within budget) → homelab fallback",
      "pro": "homelab primary → edge fallback",
      "enterprise": "byok (if configured) → homelab fallback"
    }
  }
}

[05] Extraction navigateur

Extraire des données des portails gouvernementaux sans API

Certains portails gouvernementaux (T.N.-O., Nunavut) n'ont pas d'API lisible par machine. Le système d'extraction permet au client du portail de rendre les pages dans le navigateur de l'utilisateur, d'extraire les liens de téléchargement et de mettre en cache les résultats côté serveur pour que les outils MCP les utilisent en repli.

Flux : 1. Le client récupère les tâches d'extraction → 2. Le navigateur visite les URL sources → 3. Le client envoie les résultats extraits → 4. Les outils MCP récupèrent les résultats en cache en repli

GET /v1/extraction/tasks

Lister les tâches d'extraction pour les sources nécessitant un rendu navigateur. Filtrer facultativement par compétence via un paramètre de chemin ou de requête.

# Toutes les tâches d'extraction
$ curl -s -H "X-API-Key: ms_live_..." \
  https://api.maplespike.ca/v1/extraction/tasks | jq .

# Filtrer par compétence (paramètre de chemin)
$ curl -s -H "X-API-Key: ms_live_..." \
  https://api.maplespike.ca/v1/extraction/tasks/nunavut | jq .

// Response
{
  "success": true,
  "data": {
    "tasks": [{
      "source_id": "nunavut-bureau-statistics",
      "jurisdiction": "nunavut",
      "name": "Nunavut Bureau of Statistics",
      "url": "https://www.gov.nu.ca/en/...",
      "extract_type": "link_list",
      "selector": "a[href*='/sites/default/files/']",
      "cached": false,
      "cache_ttl_hours": 168
    }]
  }
}

POST /v1/extraction/results

Soumettre les données extraites depuis le client navigateur. Le serveur valide le source_id, bloque les tentatives SSRF (IP privées, localhost) et met en cache les résultats avec un horodatage.

$ curl -s -X POST https://api.maplespike.ca/v1/extraction/results \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ms_live_..." \
  -d '{
    "source_id": "nunavut-bureau-statistics",
    "results": [{
      "title": "Population Estimates 2024",
      "url": "https://www.gov.nu.ca/sites/default/files/pop-2024.xlsx",
      "format": "xlsx"
    }]
  '} | jq .

// Response
{
  "success": true,
  "data": {
    "stored": true,
    "source_id": "nunavut-bureau-statistics",
    "count": 1,
    "rejected": 0,
    "cached_at": "2026-07-01T12:00:00.000Z"
  }
}

Protection SSRF : les URL pointant vers localhost, 127.x, 10.x, 192.168.x, ou 172.16.x sont filtrées silencieusement. Le champ rejected indique combien ont été bloquées.

GET /v1/extraction/cached/:source_id

Récupérer les résultats d'extraction en cache s'ils sont frais (dans cache_ttl_hours). Les outils MCP utilisent ce mécanisme en repli lorsque les sources en direct sont indisponibles.

$ curl -s -H "X-API-Key: ms_live_..." \
  https://api.maplespike.ca/v1/extraction/cached/nunavut-bureau-statistics | jq .

// Réponse (cache frais)
{
  "success": true,
  "data": {
    "source_id": "nunavut-bureau-statistics",
    "results": [...],
    "cached_at": "2026-07-01T12:00:00.000Z",
    "age_hours": 3.2,
    "fresh": true,
    "source_name": "Nunavut Bureau of Statistics",
    "jurisdiction": "nunavut"
  }
}

// Réponse (cache expiré → 404)
{
  "success": false,
  "error": {
    "code": "STALE",
    "message": "Cache expired (age: 172h, ttl: 168h)"
  }
}

Sources actuellement suivies : Produit Open Government des T.N.-O., Bureau de statistiques du Nunavut (3 sous-sources : démographie, économie, principale). TTL du cache : 168 heures (7 jours).

[ 06] Optimisation des jetons

Réduire les réponses pour les agents IA

Chaque jeton économisé est de l'argent gagné. Ces paramètres vont dans le même corps de requête — ils sont extraits avant la validation.

Paramètre	Type	Effet
_fields	string[]	Ne renvoyer que les champs nommés
_format	"full" \| "compact"	Compact supprime les valeurs nulles/vides
_limit	number	Plafonner les résultats des tableaux
_page	number	Décalage de pagination
_summary	boolean	Renvoyer des agrégats, pas des lignes
_mock	true	Données d'exemple, gratuites, sans appel en amont

[ 07] Contrat de citation

Chaque réponse. Chaque point de terminaison. Vérifiable.

Chaque point de terminaison MapleSpike renvoie le même bloc de citation — que vous utilisiez l'API REST, les outils MCP ou le moteur de recoupement.

{
  "citation": {
    "source_name": "open.canada.ca",
    "source_url": "https://open.canada.ca/...",
    "retrieved_at": "2026-05-13T12:00Z",
    "data_hash": "sha256:a1f3...",
    "license": "OGL-C",
    "citation_text": "open.canada.ca, retrieved 2026-05-13. OGL-C."
  }
}

data_hash est le SHA-256 de la charge utile de la réponse au moment de la récupération. Re-téléchargez la source vous-même et comparez — si les hachages correspondent, vous avez vu ce que nous avons vu, octet pour octet.

[ 08] Outils MCP

184OUTILS

Outils de données pour agents IA

Tous les outils renvoient la même enveloppe { data, quality, citation }.

{
  "mcpServers": {
    "maplespike": {
      "command": "npx",
      "args": ["@maplespike/mcp"],
      "env": { "QUILL_API_KEY": "ms_live_..." }
    }
  }
}

184 outils

Catégorie	Outil	Description
Général	query_gov_data	Interroger les données gouvernementales provenant de multiples sources canadiennes, dont Statistique Canada, le portail CKAN ouvert.canada.ca et les portails de données ouvertes provinciaux (ON, BC, AB, QC). Prend en charge la recherche par mot-clé, juridiction et catégorie.
Général	fact_check	Vérifier une affirmation en la comparant aux données officielles du gouvernement canadien. Idéal pour vérifier les données économiques, les statistiques de l'emploi, les chiffres du PIB et d'autres indicateurs gouvernementaux publiés par Statistique Canada et les sources fédérales.
Général	get_citation	Récupérer et vérifier un hachage de citation SHA-256 pour un enregistrement de données spécifique. Permet de vérifier l'intégrité des données en recomputant le hachage à partir de la source originale.
Général	latest_releases	Obtenir les plus récentes publications de données gouvernementales canadiennes, y compris les communiqués de Statistique Canada, les mises à jour de données du portail ouvert et les annonces provinciales. Filtrer par juridiction et catégorie.
Parlement	search_committees	Rechercher des témoignages, transcriptions et procès-verbaux de comités de la Chambre des communes et du Sénat. Couvre les comités permanents (FINA, OGGO, ETHI), spéciaux et mixtes.
Entreprises	search_corporate	Rechercher dans les registres de lobbying fédéraux, les données d'approvisionnement et les déclarations de dirigeants d'entreprises. Couvre 17 dirigeants suivis dans les secteurs bancaire, télécoms et médias.
Influence	search_influence	Rechercher les acteurs d'influence suivis par MapleSpike — organisations internationales, groupes de réflexion, cabinets de conseil et ONG. Retourne le financement et les liens transversaux.
Réglementation	search_gazette	Rechercher les règlements proposés et définitifs dans la Gazette du Canada. Couvre les Parties I, II et III avec les analyses d'impact et les ministères responsables.
Réglementation	search_gic	Rechercher les nominations du gouverneur en conseil (GIC), y compris les titulaires de charge, les échelles salariales et les affiliations ministérielles.
Élections	search_elections	Rechercher les données d'Élections Canada, y compris le registre des publicités électorales par des tiers et les dépenses électorales.
Entreprises	search_provincial_lobbying	Rechercher les registres de lobbying provinciaux (Ontario, Québec). Normalise au schéma fédéral pour une vue combinée fédérale-provinciale.
Surveillance	search_oversight	Rechercher les rapports et enquêtes des organismes de surveillance fédéraux : Bureau du vérificateur général, directeur parlementaire du budget, commissaire à l'éthique, Commissariat au lobbying, Bureau de la concurrence et CRTC.
Surveillance	search_canlii	Rechercher des décisions judiciaires canadiennes via CanLII. Couvre les cours fédérales et provinciales, y compris la Cour suprême, les cours d'appel et les cours supérieures.
Immigration	search_lmia	Rechercher les données trimestrielles sur les études d'impact sur le marché du travail (EIMT). Retourne les données par employeur, profession, province et résultats.
Immigration	search_immigration	Rechercher des données sur l'immigration canadienne — admissions de résidents permanents d'IRCC, Entrée express, décisions de la CISR et statistiques d'exécution de l'ASFC.
Autochtones	search_indigenous_relations	Rechercher des données sur les relations avec les Autochtones — revendications particulières de RCAANC, transparence financière des Premières Nations, suivi des appels à l'action de la CVR.
Sécurité publique	search_criminal_justice	Rechercher des données sur la justice pénale et les services correctionnels canadiens, y compris les statistiques sur la population carcérale du SCC, les décisions de la Commission des libérations conditionnelles et les crimes haineux.
Transport	search_transport_safety	Rechercher les données d'accidents et d'incidents du Bureau de la sécurité des transports (BST), les rappels de Transports Canada et les décisions de l'OTC.
Défense	search_defence	Rechercher des données sur la défense et les anciens combattants canadiens, y compris les effectifs de la Force régulière du MDN par grade, les données d'approvisionnement du Plan des capacités de défense et les temps d'attente d'ACC.
Science	search_science	Rechercher des données sur la science, l'espace et la recherche au Canada — missions de l'ASC, subventions Mitacs, observations d'Ocean Networks Canada et données du Catalogue de données polaires.
Surveillance	search_tribunals	Rechercher les nominations et décisions des tribunaux administratifs fédéraux du Canada. Couvre les décisions et la composition des tribunaux.
Affaires mondiales	search_lode	Interroger la Base nationale d'adresses (LODE) : 12 bases de données de Statistique Canada avec plus de 10 millions d'adresses civiques canadiennes.
Défense	search_veterans	Rechercher les données d'Anciens Combattants Canada : prestations d'invalidité, temps d'attente et services aux vétérans.
Influence	search_ngo_rss	Rechercher les publications d'ONG et de groupes de réflexion via leurs flux RSS. Couvre 31 organisations suivies par MapleSpike.
Influence	ngo_narrative_tracker	Analyser les publications d'ONG et de groupes de réflexion pour détecter l'alignement narratif, les messages coordonnés et les campagnes d'influence. Repère lorsque plusieurs organisations utilisent un cadrage ou un langage similaires.
Santé	search_health	Rechercher des données sur la santé canadienne — temps d'attente, dépenses de santé, volumes chirurgicaux, surveillance des maladies, crise des opioïdes et rappels alimentaires.
International	search_ilo	Rechercher les statistiques du travail de l'OIT par indicateur ou pays. Couvre l'emploi, le chômage, les salaires et les conditions de travail.
Approvisionnement	search_proactive_disclosure	Rechercher les divulgations proactives de contrats par fournisseur ou ministère. Couvre les contrats de plus de 10 000 $ du gouvernement fédéral.
Approvisionnement	search_ati	Rechercher les demandes d'accès à l'information par mot-clé, ministère ou numéro de dossier. Couvre les demandes complétées et publiées par le gouvernement fédéral.
Approvisionnement	search_federal_budget	Rechercher le budget fédéral par programme, ministère et exercice financier. Retourne les montants alloués, les descriptions de programme et les Justificatifs.
Économie	search_statcan	Rechercher les jeux de données de Statistique Canada par mot-clé ou sujet. Accès au catalogue en ligne du Système de diffusion de données.
Parlement	search_legislation	Rechercher les lois fédérales par nom, mot-clé ou juridiction. Couvre les lois codifiées du Canada avec historique des modifications.
Approvisionnement	search_goc_spending	Rechercher les dépenses gouvernementales par fournisseur, ministère et programme. Couvre les données ouvertes du gouvernement du Canada.
Municipal	search_municipal	Rechercher les données ouvertes municipales des grandes villes canadiennes. Couvre les budgets, services, permis et infrastructures municipales.
Affaires mondiales	search_global_canada	Rechercher les données d'Affaires mondiales Canada : accords commerciaux, climat, émissions, aide internationale et relations diplomatiques.
Santé	search_health_canada	Rechercher les rappels de drogues et d'aliments, les licences de dispositifs médicaux et les règlements de Santé Canada.
Environnement	search_impact_assessment	Rechercher les évaluations d'impact environnemental par projet ou secteur. Couvre les évaluations fédérales et les examens réglementaires.
Environnement	search_species_at_risk	Rechercher les espèces en péril par nom ou statut. Couvre le registre public des espèces en péril du gouvernement du Canada.
Environnement	search_fisheries	Rechercher les données sur les pêches : espèces, régions, aquaculture, permis et quotas. Couvre les données du MPO et de Pêches et Océans Canada.
Environnement	search_agriculture	Rechercher des données agricoles canadiennes — production par province, revenus agricoles, prix des commodités et données du Recensement de l'agriculture.
Communauté	search_crown_corporations	Rechercher les sociétés d'État fédérales — CBC, Postes Canada, EDC et autres. Retourne les états financiers, rapports annuels et données de rémunération.
Organismes de bienfaisance	search_charity_t3010	Rechercher les déclarations T3010 des organismes de bienfaisance par nom ou catégorie. Retourne les revenus, dépenses et activités caritatives par année.
Économie	search_bank_of_canada	Rechercher les taux directeurs, discours et perspectives politiques de la Banque du Canada. Inclut le taux cible du financement à un jour et les taux directeurs historiques.
Général	datastore_query	Query the cross-module datastore — search previously fetched results across tools. Useful for combining data from multiple Quill tools (e.g., committees + lobbying + procurement). Results are cached with TTL; expired entries are auto-cleaned.
Général	discover_tools	Search all available Quill MCP tools by intent or topic. Returns ranked tool names and descriptions so you know which tool to call next. Use this FIRST when unsure which tool fits.
Environnement	search_weather	Search Canadian weather data from Environment Canada — current conditions, forecasts, severe weather alerts, air quality health index (AQHI), radar, marine forecasts, and climate normals. Powered by MSC GeoMet (OGC API).
Santé	search_nutrient_file	Search the Canadian Nutrient File — food composition data from Health Canada. Find nutrient values (calories, protein, fat, carbs, vitamins, minerals) for Canadian food products.
Économie	search_valet_api	Search Bank of Canada Valet API — official exchange rates, interest rates, commodity prices, and economic indicators. More granular than the general Bank of Canada search (this uses the Valet REST API directly).
Logement	search_housing_cmhc	Rechercher les données de la SCHL : mises en chantier, taux d'inoccupation, logements abordables et prix moyens par ville.
Médias	search_crtc_decisions	Rechercher les numéros de décisions du CRTC et les ordonnances de radiodiffusion. Référence croisée avec la base de données de décisions du Conseil.
Social	search_social_programs	Rechercher les données sur l'assurance-emploi, les paiements de l'Allocation canadienne pour enfants et les taux de pauvreté par province.
Social	search_education_research	Rechercher les données du CRSNG et du CRSH, les chaires de recherche du Canada par établissement. Couvre les subventions de recherche et les bourses.
Surveillance	search_a2aj	Rechercher dans les décisions de justice via A2AJ. Couvre plus de 116 000 décisions des tribunaux canadiens avec métadonnées et extraits.
Provincial	search_ab_data	Rechercher des données ouvertes du gouvernement de l'Alberta — données de santé, d'éducation, d'immigration, de tribunaux et plus. Interroge le portail CKAN albertain.
Transport	search_arcgis_layers	Rechercher des services de fonctionnalités ArcGIS pour le Manitoba, la Saskatchewan et l'Île-du-Prince-Édouard. Retourne les couches géospatiales disponibles et leurs métadonnées.
Provincial	search_bc_data	Rechercher des données ouvertes du gouvernement de la Colombie-Britannique — données de santé, d'éducation, d'immigration, de tribunaux et plus. Interroge le portail CKAN britanno-colombien.
Parlement	search_bills	Rechercher les projets de loi fédéraux via le Parlement ouvert avec identifiants LEGISinfo. Couvre les projets de loi déposés, en cours et adoptés.
Entreprises	search_cipo	Rechercher les brevets et marques de commerce via l'Office de la propriété intellectuelle du Canada (OPIC). Couvre les demandes par inventeur, catégorie technique ou année.
Logement	search_cmhc	Rechercher les données de la SCHL par ville, province ou année. Inclut les mises en chantier, taux d'inoccupation et prix moyens des logements.
Parlement	search_committees_op	Rechercher les comités via l'API du Parlement ouvert. Accès aux données des comités de la Chambre des communes et du Sénat.
Entreprises	search_corporate_filings	Rechercher les documents SEDAR+ et rapports d'initiés par entreprise ou symbole boursier. Couvre les dépôts de sociétés ouvertes canadiennes.
Organismes de bienfaisance	search_cra_charity	Rechercher les organismes de bienfaisance enregistrés auprès de l'ARC par nom ou numéro de BN. Vérifie le statut d'enregistrement et les documents déposés.
Médias	search_crtc	Rechercher les décisions, licences et ordonnances de neutralité du Net du CRTC. Couvre les télécommunications, la radiodiffusion et les décisions réglementaires.
Social	search_culture	Rechercher les subventions du Conseil des arts du Canada, le financement du patrimoine et les programmes artistiques. Couvre les données culturelles fédérales.
Parlement	search_debates	Rechercher les débats de la Chambre des communes (Hansard). Couvre les transcriptions intégrales depuis 1994 avec recherche par député, date et sujet.
Transport	search_geospatial	Rechercher les cartes topographiques, imagerie satellitaire et jeux de données géospatiales. Couvre les données de Ressources naturelles Canada.
Immigration	search_ircc-citizenship	Rechercher les statistiques de citoyenneté IRCC par province. Couvre les octrois, les refus et les demandes en cours.
Immigration	search_ircc_entry_exit	Rechercher les données d'entrée-sortie par nationalité et trimestre. Couvre les statistiques de passages frontaliers.
Immigration	search_ircc_express_entry	Rechercher les résultats des tirages Entrée express : scores RCR, programmes et sélections basées sur les catégories.
Immigration	search_ircc_family_sponsorship	Rechercher les données de parrainage familial par bureau de visa. Couvre les demandes de parents et de conjoints.
Immigration	search_ircc_pr_admissions	Rechercher les admissions de résidents permanents par province, catégorie ou année. Couvre les données détaillées d'IRCC.
Immigration	search_ircc_processing_times	Rechercher les délais de traitement par type de demande et pays. Retourne les délais estimés pour les demandes d'immigration.
Immigration	search_ircc_study_permits	Rechercher les permis d'études par établissement, province ou pays d'origine. Couvre les données du programme d'étudiants étrangers.
Immigration	search_ircc_work_permits	Rechercher les permis de travail par code CNP, province ou pays. Couvre les données du Programme des travailleurs étrangers temporaires.
Science	search_knowledge_fabric	Rechercher dans le portail Knowledge Fabric. Interroge les jeux de données académiques et de connaissances interconnectés.
Communauté	search_libraries	Rechercher les bibliothèques publiques dans 15 villes canadiennes. Retourne les horaires, services et coordonnées.
Municipal	search_municipal_data	Rechercher les jeux de données municipaux dans 10 villes canadiennes. Accès aux portails de données ouvertes municipaux.
Environnement	search_npri	Rechercher l'Inventaire national des rejets de polluants (INRP) par installation ou substance. Données environnementales sur les rejets industriels.
Environnement	search_nrcan	Rechercher les données de Ressources naturelles Canada : commodités, régions, minéraux, forêts et énergie.
Provincial	search_nunavut_data	Rechercher les données du Nunavut à partir du CKAN fédéral et de Statistique Canada. Couvre les statistiques territoriales et les données ouvertes.
Provincial	search_on_data	Rechercher des données ouvertes du gouvernement de l'Ontario — données de santé, d'éducation, d'immigration, de tribunaux et plus. Interroge le portail CKAN ontarien.
Provincial	search_yukon_data	Rechercher les données ouvertes du Yukon à partir du portail CKAN open.yukon.ca. Couvre les données territoriales et statistiques.
Communauté	search_parks	Rechercher les parcs et installations récréatives dans 12 villes canadiennes. Retourne les équipements, horaires et localisations.
Provincial	search_provincial_data	Rechercher les données des 13 provinces et territoires via CKAN et Socrata. Accès unifié aux portails de données provinciales et territoriales.
Provincial	search_provincial_legislatures	Rechercher les transcriptions des débats des législatures provinciales et territoriales. Couvre les hansards de l'Assemblée législative.
Provincial	search_provincial_regulators	Rechercher les organismes de réglementation provinciaux par profession ou province. Couvre 273 organismes de réglementation dans 21 catégories.
Provincial	search_qc_data	Rechercher des données ouvertes du gouvernement du Québec — données de la RAMQ, de l'immigration, de la Cour du Québec et du ministère de l'Éducation.
Transport	search_real_time_feeds	Rechercher les alertes en temps réel : météo, avis sanitaires, alertes AMBER. Couvre les flux de données en continu.
Transport	search_regional_authorities	Rechercher les autorités régionales de transport et de services. Couvre les organismes régionaux canadiens.
Entreprises	search_sedi	Rechercher les rapports d'initiés SEDI par émetteur ou initié. Couvre les opérations d'initiés déclarées à la SEDI.
International	search_un	Rechercher les données SDMX de l'ONU par clé de dimension. Accès aux bases de données statistiques des Nations Unies.
Communauté	search_unions	Rechercher les syndicats par nom, secteur ou province. Couvre les organisations syndicales canadiennes et leurs affiliations.
Communauté	search_universities	Rechercher les universités par établissement, programme ou indicateur. Couvre les universités canadiennes avec données d'inscription.
Environnement	search_energy_data	Rechercher les données sur la production et la consommation d'énergie du portail CKAN. Couvre l'électricité, le pétrole, le gaz et les énergies renouvelables.
Environnement	search_climate_data	Rechercher les données sur les changements climatiques et la météo provenant du portail CKAN fédéral. Couvre les données historiques, projections et émissions.
Sécurité publique	search_public_safety	Rechercher les données sur la sécurité publique et la gestion des urgences du portail CKAN fédéral.
Approvisionnement	search_federal_contracts	Rechercher les contrats fédéraux par fournisseur ou ministère. Couvre les données d'approvisionnement du gouvernement du Canada.
Approvisionnement	search_federal_grants	Rechercher les subventions et contributions fédérales. Retourne les montants, bénéficiaires et programmes de financement.
Social	search_gender_stats	Rechercher les statistiques basées sur le genre et les données d'égalité du portail CKAN fédéral.
Logement	search_housing_data	Rechercher les données sur le logement et les marchés locatifs du portail CKAN fédéral. Couvre les prix, l'offre et la demande.
Science	search_mining_data	Rechercher les données sur l'exploitation minière et la production minérale du portail CKAN. Couvre les minéraux, les métaux et les actifs miniers.
Social	search_official_languages	Rechercher les données sur les langues officielles du Canada. Couvre les données de Patrimoine canadien et les statistiques linguistiques.
Science	search_technology_data	Rechercher les données sur la technologie, l'innovation et les télécoms du portail CKAN fédéral.
Entreprises	search_patents	Rechercher les données de brevets canadiens de l'OPIC via CKAN. Couvre les demandes de brevet par inventeur et catégorie technologique.
Entreprises	search_trademarks	Rechercher les données de marques de commerce canadiennes de l'OPIC via CKAN. Couvre les demandes de marque par catégorie et demandeur.
Santé	search_pharmaceuticals	Rechercher les données sur les prix des médicaments, les pénuries et les données du PMPRB. Couvre la surveillance des produits pharmaceutiques.
Médias	search_telecommunications	Rechercher les données sur les télécommunications : large bande, enchères de spectre et fournisseurs de télécoms.
Logement	search_real_estate	Rechercher les données et tendances du marché immobilier. Couvre les prix, les ventes et les analyses de marché par région.
Sécurité publique	search_emergency_management	Rechercher les données sur la gestion des urgences et la réponse aux catastrophes. Couvre les plans d'urgence, les interventions et les ressources.
Autochtones	search_indigenous_services_directory	Rechercher dans le répertoire des services aux Autochtones. Couvre les services de santé, d'éducation, de logement et de développement communautaire.
Sécurité publique	search_policing_security	Rechercher les données sur les services de police et la sécurité publique. Couvre les effectifs policiers, la criminalité et les programmes de sécurité.
Entreprises	search_financial_regulation	Rechercher les données de réglementation financière et de surveillance. Couvre le BSIF, l'ACFC, CANAFE et d'autres organismes de réglementation financière.
Médias	search_media_broadcasting	Rechercher les données sur les médias et la radiodiffusion. Couvre les licences de radiodiffusion, la propriété des médias et la couverture.
Municipal	search_municipal_long_tail	Rechercher des requêtes de données municipales de niche et des jeux de données spécialisés. Couvre les sources municipales moins connues.
Provincial	search_provincial_orgs	Rechercher les organisations et agences provinciales. Couvre les ministères, agences et commissions provinciales.
Entités	search_cross_reference	Effectuer un référencement croisé entre tous les modules à la fois. Produit une chronologie unifiée des activités d'une entité à travers les sources.
Environnement	search_nrcan_renewable	Rechercher les données sur les énergies renouvelables de RNCan. Couvre l'éolien, le solaire, l'hydroélectricité et la biomasse.
Environnement	search_nrcan_fires	Rechercher les données sur les incendies de forêt et la surveillance des feux de RNCan. Couvre les foyers actifs, superficies brûlées et dangers.
Environnement	search_nrcan_forests	Rechercher les données forestières et l'inventaire forestier national de RNCan. Couvre les essences, la biomasse et la santé des forêts.
Environnement	search_nrcan_minerals	Rechercher les données minières et minérales de RNCan. Couvre la production, les réserves et l'exploration par minéral.
International	search_oecd_stat	Rechercher les statistiques de l'OCDE par indicateur ou pays. Accès aux bases de données économiques et sociales de l'OCDE.
International	search_undp_hdi	Rechercher les données de l'Indice de développement humain du PNUD. Couvre l'IDH par pays avec les composantes santé, éducation et revenu.
International	search_unhcr_refugees	Rechercher les statistiques du HCR sur les réfugiés et les déplacements forcés. Données par pays d'origine, d'accueil et année.
International	search_us_cia	Rechercher les données du CIA World Factbook par pays. Profils complets : géographie, démographie, économie et gouvernement.
International	search_au_abs	Rechercher des données du Bureau australien des statistiques (ABS). Couvre la démographie, l'économie, l'emploi et d'autres indicateurs australiens.
International	search_nz_stats	Rechercher les données de Statistique Nouvelle-Zélande (Stats NZ). Couvre la démographie, l'économie et les indicateurs sociaux.
International	search_uk_ons	Rechercher les données de l'Office for National Statistics du Royaume-Uni. Couvre la démographie, l'économie et la société britanniques.
International	search_who_gho	Rechercher les données de l'Observatoire de la santé mondiale de l'OMS. Couvre les indicateurs de santé par pays et région.
International	search_eurostat	Rechercher les statistiques européennes d'Eurostat. Couvre l'économie, la démographie, l'environnement et la société des pays membres de l'UE.
Transport	search_utilities	Rechercher les services d'hydroélectricité, de gaz et d'eau par province. Couvre les sociétés de services publics canadiennes.
Système	cache_clear	Vider le cache des réponses d'outils MCP. Utile pour forcer une récupération fraîche des données après une mise à jour des sources.
Système	cache_status	Vérifier l'état du cache et les taux de succès. Retourne les statistiques d'utilisation du cache par outil et par module.
Économie	compare_regions	Comparer des indicateurs économiques entre provinces et territoires canadiens. Inclut le PIB, l'emploi, la population et d'autres mesures provenant de Statistique Canada.
Entités	get_annotations	Obtenir les annotations et métadonnées d'entités par type. Retourne les étiquettes, catégories et relations d'une entité spécifique.
Entités	get_entity_profile	Obtenir un profil complet d'une personne ou organisation en croisant les données des modules lobbying, nominations GIC, comités parlementaires et approvisionnement.
Parlement	get_member_info	Obtenir les informations détaillées d'un député : nom, parti, circonscription, adresse photo. Couvre les députés de la Chambre des communes.
Système	get_module_health	Vérifier l'état de santé d'un module de données spécifique. Retourne la fraîcheur des données, le taux de succès des récupérations et l'état du pipeline.
Système	get_pipeline_health	Vérifier l'état de santé du pipeline d'ingestion. Retourne le statut de chaque extracteur, la latence et les taux d'erreur.
Parlement	get_politician_influence	Obtenir le profil d'influence d'un élu : activités de lobbying, votes, nominations GIC, présence aux comités et affiliations.
Système	qa_schema	Interroger les schémas des modules par nom. Retourne les noms de champs, leurs types, les champs requis et les descriptions.
Système	qa_validate_module	Valider la qualité et l'intégrité des données d'un module. Vérifie la cohérence, l'exhaustivité et la fraîcheur des données.
Économie	query_bridges	Interroger les données sur l'état des ponts et infrastructures au Canada. Retourne les évaluations structurelles par province et par type d'infrastructure.
Économie	query_cpi	Interroger l'Indice des prix à la consommation (inflation) de Statistique Canada. Retourne les séries chronologiques par catégorie de dépenses et par province.
Économie	query_gdp	Interroger le PIB du Canada par industrie et par province. Retourne les séries chronologiques avec dates de référence et variations trimestrielles.
Économie	query_labour	Interroger les données sur la population active de Statistique Canada. Retourne les taux d'emploi, de chômage et de participation par province et par secteur.
Économie	query_population	Interroger les estimations démographiques par province et territoire. Retourne la population par âge, sexe et région.
Économie	query_trade	Interroger les données du commerce international de marchandises de Statistique Canada. Retourne les exportations et importations par pays partenaire et catégorie de produits.
Parlement	search_votes	Rechercher les votes de la Chambre des communes via le Parlement ouvert. Couvre les votes par député, session et projet de loi.
Environnement	search_agriculture_data	Rechercher des données agricoles et agroalimentaires du portail CKAN fédéral. Couvre la production, les marchés et la sécurité alimentaire.
Immigration	search_citizenship_data	Rechercher les statistiques de citoyenneté canadienne provenant du portail CKAN. Inclut les octrois de citoyenneté par province et pays d'origine.
Entreprises	search_corporate_registry	Rechercher les données du registre des sociétés fédérales via CKAN. Retourne les informations de base des entreprises constituées au niveau fédéral.
Social	search_culture_data	Rechercher les données sur la culture, les arts et le patrimoine du portail CKAN fédéral.
Social	search_education_stats	Rechercher les statistiques d'inscription scolaire et les données sur l'éducation du portail CKAN. Couvre les niveaux primaire, secondaire et postsecondaire.
Réglementation	search_gazette_part1	Rechercher dans la Partie I de la Gazette du Canada — avis et règlements proposés. Couvre les consultations publiques et les prépublications.
Réglementation	search_gazette_part2	Rechercher dans la Partie II de la Gazette du Canada — textes réglementaires et décrets en vigueur.
Réglementation	search_gazette_part3	Rechercher dans la Partie III de la Gazette du Canada — lois du Parlement telles qu'adoptées.
Immigration	search_immigration_refugees	Rechercher les données sur l'immigration et les réfugiés du portail CKAN fédéral. Couvre les statistiques d'immigration et d'asile.
Autochtones	search_indigenous_stats	Rechercher les statistiques sur les peuples autochtones du portail CKAN fédéral. Couvre la démographie, la santé, l'éducation et l'emploi.
Transport	search_transportation_data	Rechercher les données sur le transport et l'infrastructure du portail CKAN fédéral.
Système	searxng_health	Vérifier l'état de santé du moteur SearXNG : échecs, suspensions et erreurs. Utilisé pour diagnostiquer les problèmes de recherche web.
Général	smart_search	Intelligent search across all Canadian government data. Understands intent, expands synonyms, detects time-series queries, and summarizes recent changes. Sources: Parliament (debates, bills, votes, MPs, committees), Gazette (regulations), Government open data (health, economy, environment, immigration, spending, etc.)
Parlement	track_bill	Suivre un projet de loi tout au long du processus parlementaire. Retourne l'état actuel, l'historique des étapes et les votes.
International	get_wdi_indicator	Obtenir un indicateur de développement de la Banque mondiale (WDI) pour un pays spécifique. Couvre plus de 1 400 indicateurs économiques, sociaux et environnementaux.
International	compare_wdi_countries	Compare a World Bank indicator across multiple countries
International	get_country_wdi_profile	Get comprehensive country profile with key development indicators
International	analyze_indicator_trend	Analyze trend for a World Bank indicator over time
International	fetch_topic_indicators	Fetch all indicators for a specific topic (economy, health, social, etc.)
International	get_indicator_metadata	Get metadata for a World Bank indicator
International	get_comtrade_by_partner	Obtenir les données d'échanges internationaux de l'ONU (Comtrade) filtrées par pays partenaire. Retourne les valeurs d'exportation et d'importation avec ventilation par catégorie de marchandise.
International	get_comtrade_by_commodity	Fetch UN Comtrade trade data for a specific commodity
International	get_comtrade_trends	Get UN Comtrade trade trends over time
IA	ai_ask	Poser une question en langage naturel sur les données gouvernementales canadiennes. Obtient une réponse sourcée avec citations, modèle utilisé et provenance de l'inférence.
IA	ai_analyze	Analyser un document ou une transcription pour en extraire les sujets, entités et résumé. Utilise l'inférence IA en périphérie (Llama 3.3 70B) avec secours vers le cluster local (Qwen 3.5 27B).
IA	ai_search_semantic	Effectuer une recherche sémantique avec plongements vectoriels (embeddings) en périphérie. Retourne les résultats les plus pertinents selon la similarité contextuelle plutôt que par mot-clé exact.
Général	explore_catalog	Parcourir les modules de données et catégories disponibles dans MapleSpike. Retourne la liste complète des 206 modules avec descriptions et métadonnées de source.
Système	signal_check	Vérifier les signaux surveillés pour détecter des changements ou des nouvelles publications. Utile pour la veille automatisée des sources.
Système	system_health	Effectuer une vérification complète de l'état du système et des diagnostics. Retourne la santé de tous les composants et services.
Entités	resolve_entity	Résoudre un nom de personne ou d'organisation en une entité canonique. Désambiguïse les variations de noms et les homonymes.
Entités	find_connections	Trouver des connexions entre entités (personnes, organisations) à travers l'ensemble des modules. Détecte les liens entre lobbying, comités, approvisionnement et nominations.
Général	linked_entities	Cross-reference an entity across every registry Quill tracks (lobbying, GIC, committees, corporate, CanLII, elections, oversight, municipal, provincial). Resolves the name to its canonical entity, then assembles per-registry evidence with confidence. Use this to answer "what does each registry say about X" in a single call.
Général	verify_claim	Verify a Quill claim bundle. Provide a sha256 hash to check it exists in the claim store, and optionally the original data to recompute the hash locally and confirm integrity. Returns { verified, matches, recomputedSha256 }. Use this to audit any hash you received from Quill.
Général	resolve_quill_id	Resolve a question about Canadian public data into canonical Quill IDs you can pass to query_quill. Returns ranked IDs (e.g. /committees, /ircc/study-permits, quill://entity) with descriptions, provenance scores, update cadence, and the underlying tool each ID routes to. You MUST call this before query_quill unless the user provided an ID directly. Do not call more than 3 times per question.
Général	query_quill	Execute a Canadian public data query by Quill ID. You MUST call resolve_quill_id first to obtain a valid ID (format: /category, /category/dataset, or quill://entity) UNLESS the user provided one directly. Every result carries the routed tool name and — for cited records — a SHA-256 claim hash with a ready verify_claim recipe so answers are independently checkable. Do not call this tool more than 3 times per question.
Général	x402-deposit	Deposit USDC on Solana to pre-fund your credit balance. Provide a verified transaction signature and the amount in USDC. Subsequent tool calls draw from this balance without per-call on-chain latency.

Affichage de 184 MCP outils. Utilisez la zone de recherche ou la liste déroulante des catégories pour filtrer. La liste complète des outils est aussi disponible dans llms.txt pour une consommation par machine.

[ 09] Limites de débit

Plafonds par forfait

Les limites de débit sont par seconde et par mois. Atteindre la limite par seconde renvoie 429 avec un en-tête Retry-After.

Forfait	Par seconde	Par mois	Dépassement
Gratuit	2/s	1,000	Plafond strict (402)
Pro	25/s	50,000	1 $/1 K (prévu)
Affaires	100/s	250,000	0,80 $/1 K (prévu)
Entreprise	Custom	Custom	Négocié

[ 10] Erreurs

Une forme. Des catégories précises.

Toutes les réponses d'erreur portent success: false, un code d'erreur stable code, un message et un message_fr en français. Chaque erreur inclut les deux langues afin que votre application puisse afficher la bonne langue sans requête distincte.

Réponse d'erreur bilingue

Chaque erreur API renvoie un message en anglais et en français. Exemple de réponse 429 :

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. Please slow down.",
    "message_fr": "Limite de débit dépassée. Veuillez ralentir."
  }
}

Lors de la création d'une interface en français, affichez message_fr à vos utilisateurs. Le champ message est toujours en anglais et convient à la journalisation.

Référence des erreurs

Code	Statut	Réessayer	Signification
auth_invalid	401	Non	Corriger la clé API ou le JWT
rate_limited	429	Oui	Respecter l'en-tête Retry-After
quota_exhausted	402	Non	Passer à un forfait supérieur ou attendre la réinitialisation
input_invalid	400	Non	Vérifier le schéma d'entrée
source_unavailable	502	Oui	Source en amont indisponible, réessayer plus tard
not_found	404	Non	La ressource n'existe pas
server_error	500	Oui	Reculer, signaler si persistant

[ 11] FAQ

Questions fréquentes

Dois-je fournir une carte de crédit pour commencer ?

Non. Forfait gratuit : 1 000 appels/mois, toutes les sources, tous les SDK, hachages de citation inclus. Pas de carte, pas de limite de temps.

Qu'est-ce qui rend les citations vérifiables ?

Chaque réponse inclut le nom de la source, l'URL en amont exacte, l'horodatage de récupération et un hachage SHA-256 du contenu. Vous pouvez re-télécharger et confirmer exactement ce que l'agent a vu.

Quels cadres IA sont pris en charge ?

MCP (Claude, Cursor, Windsurf, ChatGPT), Anthropic tool_use, OpenAI function calling. SDK TypeScript et Python.

Quelle est la fraîcheur des données ?

Cela dépend de la source. Témoignages des comités : ~24 h. Gazette du Canada : quelques heures après publication. CanLII : quotidiennement. Chaque réponse est accompagnée d'un champ freshness_seconds.

Qu'est-ce que le moteur de recoupement ?

Recherchez une personne ou une entreprise et obtenez son empreinte gouvernementale complète — réunions de lobbying, témoignages en comité, nominations aux conseils par décret, contrats d'approvisionnement, dossiers judiciaires et dons de campagne — dans une chronologie unifiée.

Ma clé API est-elle sécurisée ?

Les clés sont hachées avec SHA-256 au repos — nous ne les voyons qu'au moment de la vérification. Transit HTTPS uniquement. Rotation instantanée depuis l'espace de travail.

Une seule clé API. 207 modules de données gouvernementales canadiennes. Chaque réponse est citée.