API publique · Serveur MCP · Clés du forfait Firm
Le registre que Clarion suit — à interroger directement.
« /api/v1 » et un serveur MCP diffusent les mêmes projets de loi, juridictions, élus et calendrier RG qui alimentent le produit — en JSON, lecture seule, sans clé pour commencer. Une clé porteur du forfait Firm ajoute une profondeur de données enrichie et des données en direct, incluse sans coût supplémentaire.
Prise en main
Une requête. Aucune clé.
Chaque appel anonyme est ouvert au CORS et mis en cache en périphérie pendant une heure — pointez-y un script, un tableau de bord ou un outil de salle de presse, directement.
Requête
curl "https://app.withclarion.com/api/v1/bills?jurisdiction=ca-on&q=housing"Réponse
{
"count": 2,
"bills": [
{
"slug": "ca-on-bill-64",
"number": "Bill 64",
"titleEn": "Housing Equity and Rental Transparency Act, 2025",
"jurisdictionCode": "ca-on",
"status": "First Reading Ordered for Second Reading",
"lastEventAt": "2025-10-28"
},
{
"slug": "ca-on-bill-28",
"number": "Bill 28",
"titleEn": "Homelessness Ends with Housing Act, 2025",
"jurisdictionCode": "ca-on",
"status": "Second Reading Vote",
"lastEventAt": "2025-10-23"
}
]
}Extrait, pour l'espace — la réponse réelle porte aussi titleFr, jurisdictionNameEn/Fr et level.
Chaque point d'accès se décrit lui-même à GET /api/v1 — le schéma complet est le descripteur OpenAPI.
Ce que contient le registre
Sept points d'accès en lecture. Une seule forme.
Projets de loi, juridictions, le répertoire des élus à qui s'adresser et le calendrier RG unifié — les mêmes corpus que les pages de référencement, servis en JSON propre.
- GET/api/v1/calendar
- Réunions de comités, échéances de consultation, fermetures d'appels d'offres et de financement, jours de séance — fusionnés du plus proche au plus loin.
- GET/api/v1/bills
- Chaque projet de loi suivi, fédéral et provincial/territorial, du plus récemment actif. Filtrez avec ?jurisdiction=, ?status=, ?q=.
- GET/api/v1/bills/{slug}
- Un projet de loi : son échéancier d'étapes et la perspective d'adoption transparente et fondée sur des règles.
- GET/api/v1/jurisdictions
- Chaque juridiction suivie et son nombre de projets de loi.
- GET/api/v1/jurisdictions/{code}
- Le nombre de projets de loi d'une juridiction et ses plus récents.
- GET/api/v1/people
- Chaque élu ou personne nommée suivie — le répertoire de qui lobbyer.
- GET/api/v1/people/{id}
- Le dossier d'un élu : fonction, parti, coordonnées, projets de loi parrainés et interventions.
Clés du forfait Firm
Incluses sans frais dans Firm. Aucun forfait mesuré séparé.
Émettez une clé porteur depuis Réglages → Clés API sur tout espace de travail au forfait Firm — jusqu'à 5 clés actives. Elle authentifie les deux surfaces de cette page : les points d'accès REST et le serveur MCP partagent une seule limite d'autorisation.
S'authentifier
curl https://app.withclarion.com/api/v1/bills \
-H "Authorization: Bearer clr_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"10 000 requêtes par jour par clé, réinitialisées à minuit UTC. Au-delà du quota : une réponse 429 avec un en-tête Retry-After et le même corps d'erreur JSON à chaque fois. Chaque réponse authentifiée porte l'en-tête X-RateLimit-Remaining.
Ce qu'une clé ajoute
- Trois limites de profondeur passent à 200 lignes : l'échéancier d'un projet de loi (de 20), les projets de loi récents d'une juridiction (de 25), les interventions d'un élu (de 10).
- Les réponses contournent le cache en périphérie et lisent la base de données à chaque appel — en direct, jamais mises en cache jusqu'à une heure comme au palier anonyme.
- Mêmes noms de champs, mêmes filtres. Une clé change la profondeur et la fraîcheur des données, jamais leur forme.
Serveur MCP
Le même registre, en trois outils MCP.
Un seul point d'accès, sans état — aucune session à ouvrir ou fermer. Pointez-y n'importe quel client MCP; ajoutez la même clé porteur si vous en avez une.
Configuration client
{
"mcpServers": {
"clarion": {
"url": "https://app.withclarion.com/api/mcp",
"headers": {
"Authorization": "Bearer clr_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}Le bloc headers est facultatif — omettez-le et le serveur répond anonymement, aux mêmes limites qu'un appel REST non authentifié.
Outils
upcoming_calendar
Aucun argument. Enveloppe GET /api/v1/calendar.
search_bills(jurisdiction?, status?, q?)
Enveloppe GET /api/v1/bills avec les trois mêmes filtres.
get_passage_outlook(slug)
Seulement la perspective — bande et raisons — tirée de GET /api/v1/bills/{slug}, pour qu'un client n'ait pas à analyser tout l'objet du projet de loi.
POST https://app.withclarion.com/api/mcp
Ce qui n'y est pas
Le registre public est à vous. L'analyse reste chez Clarion.
Cette API sert ce qui est déjà public : le statut et l'échéancier des projets de loi, le calendrier des séances, le répertoire des élus, et la même perspective d'adoption fondée sur des règles publiée sur chaque fiche de projet de loi. La dynamique des dossiers, la prévision de changement d'accès, la cartographie des positions et les regroupements de co-lobbying — la lecture que nous construisons en évaluant chacun de ces dossiers contre des dizaines de dossiers clients à la fois — restent dans le produit. Pas un point d'accès manquant. Le registre est une matière première; sa lecture évaluée et citée, c'est ce qui distingue Clarion.
Questions fréquentes
Faut-il une clé pour commencer?
Non. Chaque point d'accès /api/v1 et le serveur MCP répondent sans en-tête Authorization — ouverts au CORS, mis en cache en périphérie pendant une heure.
Que se passe-t-il au-delà du quota quotidien?
Une réponse 429 avec un en-tête Retry-After qui compte jusqu'à minuit UTC, et le même corps d'erreur JSON à chaque fois — jamais un rejet silencieux.
La version v1 changera-t-elle sous moi?
v1 est stable. Un changement incompatible sort sous une nouvelle version — v1 ne change jamais de forme en place.
Existe-t-il une bibliothèque cliente?
Aucun kit de développement logiciel. C'est du JSON brut sur HTTP et un serveur MCP standard — le client fetch ou le client MCP que vous utilisez déjà fonctionne dès aujourd'hui.
La lecture hebdomadaire
Recevez La Dépêche dans votre boîte de réception
Un courriel par semaine : les projets de loi qui prennent de l'élan, qui fait du lobbying auprès de qui, et les probabilités d'adoption qui ont bougé — du Parlement aux assemblées législatives jusqu'à l'hôtel de ville. Gratuit, en français ou en anglais.
Voir le numéro de la semaine dernière →Les clés porteur sont incluses dans Firm. Pas un forfait mesuré séparé.
1 200 $ par mois, en dollars canadiens, affiché sur le site — 15 utilisateurs, sujets illimités, et l'accès à l'API et au serveur MCP pour que vos propres outils lisent le registre directement.