MCP Assemblée nationale
Read-only MCP server that lets AI assistants query French National Assembly open data (via CIVIX) and answer sourced questions about votes, deputies, groups, and legislative texts.
Search globally across votes, deputies, groups, and legislative dossiers.
Find and inspect roll-call votes: results, vote counts, per-group breakdowns, and individual deputy votes.
Read group voting declarations and list/inspect parliamentary groups.
Find deputies by name, group, department, or legislature and retrieve their profiles.
Answer “How did deputy X vote on topic Y?” with source links.
Analyze trends: vote volume, adoption rates, busiest days, most-voted texts, and close votes.
Track a legislative text end-to-end or follow a topic across legislatures from 2012 onward.
Compare group positions, inter-group agreement rates, and group cohesion.
Summarize a deputy’s voting record and compare agreement between two or more deputies.
Export votes or scrutin lists as CSV/JSON.
Provide
search/fetchtools for ChatGPT deep research.Includes ready-made prompts for common tasks.
All tools are read-only, neutral, and cite official sources; coverage is the National Assembly only.
Configures Gemini CLI with the Assemblée nationale MCP server, giving Gemini read-only access to French National Assembly open data (scrutins, députés, groupes) for vote lookups, MP voting records, group comparisons, and trend analyses, all backed by cited sources.
Adds a custom MCP app/connector to ChatGPT that gives it read-only access to French National Assembly open data (scrutins, députés, groupes), letting it retrieve actual vote results, per-group breakdowns, MP voting histories, group agreement statistics, and CSV exports instead of answering from memory.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Assemblée nationale Comment ont voté les députés sur le dernier budget, avec le détail par groupe ?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Assemblée nationale
Demandez à Claude, ChatGPT ou Gemini comment ont voté les députés. Gratuit, en français, avec les sources.
Voir la démo en direct
Ajouter à mon assistant · Exemples de questions · Signaler un problème · English
Voir en une minute
▶ Cliquez sur l'image pour lire la vidéo. Elle explique le service en langage simple, montre un exemple de réponse construit avec les données réelles du scrutin n° 9203, puis les trois étapes pour ajouter le connecteur. Version verticale pour les réseaux sociaux : presentation-verticale.mp4. Musique originale composée pour la vidéo.
Related MCP server: Poligraph MCP Server
C'est quoi ?
Un connecteur à ajouter à votre assistant IA. Il lui donne accès aux données publiques de l'Assemblée nationale : scrutins, députés, groupes. L'IA va chercher les vrais chiffres au lieu de répondre de mémoire, et elle cite le lien de chaque scrutin.
Gratuit : pas de compte, pas de clé, pas d'abonnement à ce service.
En lecture seule : l'IA consulte, elle ne modifie rien.
Neutre : les chiffres sont transmis tels quels, sans analyse politique.
Sourcé : chaque vote cité porte le lien exact de sa page sur assemblee-nationale.fr, pour vérifier.
Un connecteur, c'est un petit service que l'IA peut appeler pour trouver une information. Celui-ci repose sur MCP, un standard ouvert que Claude, ChatGPT et Gemini CLI savent utiliser.
Les données viennent de l'API publique CIVIX (data.gouv.fr), qui republie les données ouvertes de l'Assemblée nationale.
Ajouter en 2 minutes
1. Copiez cette adresse (le bouton de copie apparaît en survolant le cadre) :
https://mcp-assemblee-nationale.vercel.app/mcp2. Collez-la dans votre assistant. Ouvrez le bloc qui correspond au vôtre :
Sur claude.ai, ouvrez Customize (Personnaliser), puis Connectors (Connecteurs).
Cliquez sur + Add, puis Add custom connector (ajouter un connecteur personnalisé).
Nom :
Assemblée nationale. Collez l'adresse copiée, puis cliquez sur Continue deux fois.Pour la connexion, choisissez No sign in (aucune connexion), puis cliquez sur Add.
Dans une conversation, cliquez sur le bouton + en bas à gauche, puis Connectors, et activez Assemblée nationale.
Le connecteur est ensuite disponible sur ordinateur et sur téléphone. Les menus s'affichent en français ou en anglais selon votre langue.
La formule gratuite autorise un connecteur personnalisé, les formules payantes en autorisent plusieurs. Sur un compte Team ou Enterprise, c'est un propriétaire du compte qui l'ajoute pour l'organisation (Organization settings → Connectors), puis chacun l'active.
Étapes tirées de l'aide officielle de Claude (octobre 2026).
Il faut une formule Pro, Business ou Enterprise/Edu : les formules gratuite et Plus ne permettent pas d'ajouter un connecteur. Sur Business, seul un administrateur peut l'ajouter. Tout se fait sur chatgpt.com, pas dans l'application mobile.
Ouvrez Plugins.
Cliquez sur +, puis Add custom MCP server (c'est le nom technique d'un connecteur).
Nom :
Assemblée nationale. Sous Connection, collez l'adresse copiée. Authentification : aucune.Cochez I understand and want to continue, puis cliquez sur Create as a plugin.
Dans une nouvelle conversation, tapez @ dans la zone de saisie et choisissez Assemblée nationale.
ChatGPT affiche un avertissement pour tout connecteur ajouté soi-même : c'est normal. Ce connecteur ne fait que lire des données publiques.
Étapes tirées de l'aide officielle d'OpenAI (octobre 2026). Le « Mode développeur » n'est plus nécessaire.
L'application Gemini (gemini.google.com) ne permet pas, à notre connaissance, d'ajouter son propre connecteur. Dès que ce sera possible, la même adresse fonctionnera. En attendant, vous pouvez utiliser Gemini CLI, qui s'utilise dans un terminal :
Ouvrez (ou créez) le fichier
~/.gemini/settings.json.Ajoutez ce bloc :
{ "mcpServers": { "assemblee-nationale": { "httpUrl": "https://mcp-assemblee-nationale.vercel.app/mcp" } } }Relancez Gemini CLI, puis tapez
/mcp:assemblee-nationaledoit apparaître dans la liste.
Le plus simple reste l'adresse ci-dessus : Claude Desktop reprend vos connecteurs claude.ai. Pour faire tourner le service chez vous :
Installez uv.
Collez cette configuration :
{ "mcpServers": { "assemblee-nationale": { "command": "uvx", "args": ["--from", "git+https://github.com/Toumi-Elyes/mcp-assemblee-nationale", "mcp-assemblee-nationale"] } } }Où la coller : Claude Desktop : Paramètres → Développeur → Modifier la configuration, puis redémarrez l'application. Cursor :
~/.cursor/mcp.json. Gemini CLI :~/.gemini/settings.json.
Partout
Le connecteur doit être activé dans la conversation en cours (bouton + sur Claude, @ sur ChatGPT). L'ajouter dans les réglages ne suffit pas.
Demandez-le explicitement : « Utilise le connecteur Assemblée nationale pour… ». Sans cela, l'IA répond parfois de mémoire.
Les noms des menus changent d'une version à l'autre. Si vous ne trouvez pas Connectors (Claude) ou Plugins (ChatGPT), cherchez « connecteur », « connector », « plugin » ou « MCP » dans les paramètres.
Vérifiez l'adresse : elle doit se terminer par
/mcp, sans espace ni guillemet.
Claude : le plan gratuit n'autorise qu'un seul connecteur personnalisé. Retirez-en un autre pour ajouter celui-ci. Sur un compte d'organisation, seul l'administrateur peut en ajouter.
ChatGPT : il faut une formule Pro, Business ou Enterprise, depuis le navigateur (pas l'application mobile). Avec la formule Plus, l'option n'existe pas. Sur Business, seul un administrateur peut ajouter le connecteur. Il n'est utilisé que dans les messages où vous l'avez choisi avec @.
Gemini : l'application grand public ne prend pas en charge les connecteurs personnalisés, à notre connaissance. Utilisez Gemini CLI. Si /mcp ne liste rien, vérifiez que le texte collé est valide et relancez Gemini CLI.
Sur votre ordinateur (uvx) : installez uv, puis redémarrez l'application pour qu'elle retrouve la commande uvx.
Exemples de questions
Posez vos questions normalement, en français.
Votre besoin | Demandez par exemple |
Retrouver un vote | « Quels sont les derniers scrutins sur l'immigration ? » |
« Retrace tous les votes sur le budget 2027. » | |
« Quels votes se sont joués à quelques voix ce mois-ci ? » | |
Comprendre un résultat | « Résume-moi le scrutin sur l'aide à mourir, avec le détail par groupe. » |
« Qu'ont déclaré les groupes avant le vote sur [sujet] ? » | |
Suivre un député | « Comment a voté [nom du député] sur la loi de finances ? » |
« Donne-moi le bilan des votes de [député] ce mois-ci. » | |
« [Député A] et [député B] votent-ils souvent pareil ? » | |
« Qui sont les députés de la Gironde ? » | |
Comparer les groupes | « Quels groupes ont voté contre le dernier budget ? » |
« Sur les 30 derniers jours, quels groupes votent le plus souvent ensemble ? » | |
Voir les tendances | « Quels textes ont été le plus votés cette semaine ? » |
« Quelles ont été les tendances des votes ce mois-ci ? » | |
Récupérer les données | « Exporte en CSV les scrutins du 1er au 15 octobre. » |
Astuce : si l'IA ne trouve rien, reformulez avec un mot-clé du titre officiel (« retraites » plutôt que « la réforme de Borne »).
Chaque analyse (tendances, accords entre groupes, bilan d'un député…) se termine par un bloc Méthode : période, taille de l'échantillon et limites. Le serveur ne classe jamais les députés : il décrit, il ne note pas.
Six questions prêtes à l'emploi sont aussi proposées dans le menu des prompts de Claude : Résumer un scrutin, Mon député, Comparer les groupes, Tendances du mois, Bilan d'un groupe, Comparer deux députés.
Exemple de réponse
Illustration : le texte et les valeurs entre crochets sont inventés pour montrer la forme d'une réponse. Les vraies réponses reprennent les données de l'Assemblée.
Vous : Comment a voté la députée [Prénom Nom] sur [sujet] ?
Assistant : Sur [sujet], il existe plusieurs scrutins (amendements, articles, vote sur l'ensemble du texte). Voici sa position sur chacun :
Scrutin | Date | Position |
[Titre du scrutin 1] | [date] | Pour |
[Titre du scrutin 2] | [date] | Contre |
Ce sont les positions enregistrées par l'Assemblée nationale, sans interprétation. Source : [lien vers la page du scrutin]
Comment ça marche
flowchart LR
A[Vous] --> B[Claude / ChatGPT / Gemini]
B --> C[Ce connecteur]
C --> D[API CIVIX]
D --> E[(Données de l'Assemblée nationale)]Vous posez une question en français à votre assistant.
L'assistant appelle ce connecteur pour obtenir les scrutins, députés ou groupes concernés.
Le connecteur interroge CIVIX et renvoie les chiffres tels quels. L'assistant rédige la réponse et cite la source.
Ce que l'IA peut faire
27 fonctions, rangées par besoin. Toutes sont en lecture seule et sourcées. Les analyses portent sur un échantillon limité, annoncé dans leur bloc Méthode. Le nom entre accents graves est celui de la fonction, utile surtout si vous voulez la demander explicitement.
Suivre un vote
Vous voulez… | Fonction |
Chercher sans savoir si c'est un vote, un député ou un groupe |
|
Trouver les votes sur un thème : date, résultat, titre |
|
Voir le résultat d'un vote : adopté ou rejeté, pour, contre, abstentions, détail par groupe |
|
Savoir qui a voté quoi, filtré par groupe, position ou nom |
|
Lire les explications de vote des groupes (souvent aucune) |
|
Savoir comment UN député a voté sur un sujet, avec les sources |
|
Suivre un texte de loi de bout en bout |
|
Suivre un sujet d'une législature à l'autre, depuis 2012 |
|
Lister les scrutins entre deux dates (90 jours au plus), par type ou résultat |
|
Repérer les votes récents joués à quelques voix |
|
Comprendre une tendance
Vous voulez… | Fonction |
Voir le nombre de scrutins par semaine, la part de textes adoptés, les jours les plus chargés (7 à 90 jours) |
|
Savoir quels textes ont donné lieu au plus de scrutins |
|
Avoir les chiffres de la législature : totaux, sièges par groupe, taux d'adoption estimé |
|
Voir la position majoritaire de chaque groupe sur un sujet |
|
Savoir à quelle fréquence deux groupes votent pareil |
|
Mesurer la part des votes d'un groupe qui suivent sa position majoritaire |
|
Un député, un groupe
Vous voulez… | Fonction |
Trouver un député par nom, groupe, département ou législature |
|
Voir la fiche d'un député : groupe, circonscription, liens officiels |
|
Connaître les groupes parlementaires : sigles, effectifs |
|
Voir la fiche d'un groupe |
|
Résumer les votes d'UN député et son alignement avec son groupe, avec les limites |
|
Comparer deux députés : part de votes identiques |
|
Comparer de 3 à 5 députés, deux à deux |
|
Récupérer les données
Vous voulez… | Fonction |
Une liste de scrutins en CSV ou JSON, prête pour un tableur |
|
Les votes de chaque député sur un scrutin, en CSV ou JSON |
|
Pour la recherche approfondie de ChatGPT
Vous voulez… | Fonction |
Les mêmes données, dans le format attendu par la recherche approfondie de ChatGPT |
|
Neutralité : rien ne classe les députés ni les groupes. Les chiffres décrivent un échantillon, jamais une qualité.
D'où viennent les données
Source : les données ouvertes de l'Assemblée nationale, mises à disposition par CIVIX, une initiative indépendante, non officielle et neutre (API sur data.gouv.fr).
Licence des données : Licence Ouverte Etalab 2.0.
Neutralité : les chiffres sont transmis tels quels, sans analyse politique, et chaque réponse renvoie vers la source.
Fraîcheur : les réponses sont gardées en mémoire 10 minutes pour ménager l'API CIVIX. Un vote du jour peut mettre un peu de temps à apparaître, selon la mise à jour des données de l'Assemblée.
Ce projet n'est affilié ni à l'Assemblée nationale, ni à CIVIX.
Vie privée et limites
Vie privée
Le connecteur ne reçoit que la recherche envoyée par l'IA (par exemple « retraites » ou un nom de député), jamais votre conversation.
Ces mots-clés sont transmis à l'API CIVIX pour faire la recherche.
Il n'enregistre pas les conversations, n'utilise aucun cookie et ne demande aucun compte.
Les réponses de CIVIX (données publiques, jamais votre question) sont gardées 10 minutes, ou 24 h pour un scrutin ancien, en mémoire et dans le cache partagé de Vercel, puis oubliées.
Votre assistant applique sa propre politique de confidentialité. L'hébergeur (Vercel) peut tenir des journaux techniques d'accès : ce code n'y écrit pas vos questions.
La page de démo compte ses visites avec Vercel Web Analytics : mesure anonyme, sans cookie, qui ne garde que le chemin de la page. Elle respecte le signal Global Privacy Control et se refuse en un clic sur sa page Confidentialité. Le connecteur, lui, ne mesure rien.
Limites
Assemblée nationale uniquement : pas de Sénat, pas de Parlement européen.
Fraîcheur : elle dépend de la publication des données par l'Assemblée et de leur reprise par CIVIX.
Disponibilité : si CIVIX est indisponible, le connecteur le dit et il faut réessayer plus tard.
Couverture : les scrutins et les votes nominatifs sont disponibles de la 14e législature (2012) à la 17e (en cours). Les députés des 14e, 15e et 16e législatures viennent d'un index tiré des données ouvertes de l'Assemblée nationale, embarqué dans le connecteur. Pour les 14e et 15e législatures, CIVIX ne fournit ni le titre, ni le résultat officiel, ni le décompte par groupe des scrutins : le connecteur les reprend des archives de scrutins de l'Assemblée, embarquées elles aussi, et la recherche par mots-clés y porte sur ces titres. Pour 710 scrutins de juillet 2012 à février 2014, l'Assemblée n'a publié que les noms des députés ayant voté autrement que leur groupe : le connecteur le signale et les écarte des analyses de députés. Rien n'est disponible avant 2012.
Plusieurs scrutins par texte : un texte donne souvent plusieurs votes (amendements, articles, ensemble). Vérifiez toujours lequel est cité.
Sécurité
Le connecteur est en lecture seule et sans compte. Il est protégé ainsi :
Plafond de requêtes et délai maximal : chaque question est limitée en nombre de requêtes vers CIVIX (de 10 pour une recherche simple à 45 pour une analyse, les réponses déjà en mémoire ne comptent pas) et en durée. Au-delà, il répond par exemple « Demande trop large : précisez le nom, le groupe ou le sujet ».
Protection contre les abus : des règles de limitation de débit sont appliquées sur le pare-feu de Vercel.
Citations signalées : les déclarations des groupes sont citées telles quelles et marquées comme texte de tiers, pas comme consignes.
Liens contrôlés : seuls les liens https vers
civix.fr,assemblee-nationale.fretdata.assemblee-nationale.frsont repris.
Vous avez trouvé une faille ? Ne l'ouvrez pas en issue publique : suivez SECURITY.md.
Signaler un problème
Vous avez repéré un bug, une donnée qui semble fausse, ou vous avez une idée ? Ouvrez une issue avec le formulaire qui correspond : il pose les bonnes questions et range automatiquement votre signalement dans le tableau du projet. Il faut un compte GitHub (gratuit).
Vous voulez… | Formulaire |
Signaler un bug (le connecteur ou la page ne marche pas comme prévu) | |
Signaler une donnée incorrecte (un vote, un député ou un chiffre différent de la source officielle) | |
Proposer une amélioration (une question à couvrir, un nouvel outil, une idée pour la page) |
Pour que l'on puisse vous aider vite :
Indiquez la question posée à votre assistant et la réponse obtenue (une capture suffit).
Pour une donnée, ajoutez le lien vers la page officielle du scrutin sur assemblee-nationale.fr.
Retirez toute information personnelle avant de publier : les issues sont publiques.
Une faille de sécurité ne se signale pas en issue publique : utilisez le signalement privé (voir SECURITY.md).
Questions fréquentes
Oui. Le connecteur, l'API CIVIX et l'hébergement sont gratuits. Seul l'abonnement à votre assistant peut être payant : Claude fonctionne même en formule gratuite, ChatGPT demande une formule Pro, Business ou Enterprise.
Non. C'est un projet personnel, indépendant de l'Assemblée nationale. Les données viennent de l'Assemblée, via CIVIX, qui est lui aussi indépendant.
Le connecteur ne reçoit que la recherche envoyée par l'IA, jamais votre conversation. Il ne garde aucun historique et n'utilise aucun cookie. Voir Vie privée et limites.
Vérifiez que le connecteur est activé dans la conversation (bouton +), puis demandez explicitement : « Utilise le connecteur Assemblée nationale pour… ».
« Le service CIVIX est momentanément indisponible » : réessayez dans quelques minutes.
« Aucune donnée trouvée » : l'identifiant ou le nom est inconnu. Reformulez.
« Demande trop large » : précisez le nom, le groupe ou le sujet.
Ouvrez le lien « Source » de la réponse : il mène à la page du scrutin. Les chiffres viennent du connecteur, mais c'est l'IA qui rédige la phrase : elle peut mal les résumer.
Les données elles-mêmes semblent fausses (vote ou député mal enregistré) : utilisez le formulaire Signaler une donnée incorrecte ; nous transmettrons à CIVIX si l'erreur vient de la source.
Le connecteur se comporte mal (erreur, réponse mal formée) : utilisez le formulaire Signaler un bug (voir Signaler un problème).
Une faille de sécurité : voir SECURITY.md.
Pas pour l'instant : l'API CIVIX couvre uniquement l'Assemblée nationale.
Pour les développeurs
Serveur MCP en Python, construit avec FastMCP 4. Les réponses de l'API CIVIX sont validées par des modèles Pydantic v2, les appels passent par httpx, et les dépendances sont gérées avec Poetry. Il faut Python 3.14 ou plus récent (développé en 3.15).
poetry install
poetry run mcp-assemblee-nationale # stdio
poetry run mcp-assemblee-nationale --http --port 8000 # HTTP sur http://127.0.0.1:8000/mcp
npx @modelcontextprotocol/inspector poetry run mcp-assemblee-nationale # tester les outilsOptions : --http (HTTP streamable sans état, chemin /mcp), --host (défaut 127.0.0.1, ou variable HOST), --port (défaut 8000, ou variable PORT). Sans --http, le serveur parle en stdio.
poetry run ruff check . && poetry run ruff format --check .
poetry run mypy src tests api
poetry run pytest # tests hors ligne, sur des réponses CIVIX enregistrées
CIVIX_LIVE=1 poetry run pytest tests/live # tests contre la vraie API CIVIXLes réponses enregistrées sont dans tests/fixtures/, avec la spécification OpenAPI de CIVIX (civix-openapi.json).
src/assemblee_mcp/
├── civix/ client HTTP async de l'API CIVIX : caches, budget d'appels, erreurs en français
│ └── models/ modèles Pydantic des réponses CIVIX (enveloppe, scrutins, députés, groupes)
├── analytics/ analyses pures : échantillons (gather), calculs (stats/), rendu avec bloc « Méthode » (render/), exports CSV/JSON
├── tools/ outils MCP, une classe par famille d'outils (ToolSet) ; analyses/ regroupe les outils de tendance
├── formatting/ mise en forme des réponses en français (scrutins, votes, députés, déclarations, sources)
├── data/ index des députés des 14e à 16e et scrutins des 14e et 15e, embarqués
├── links.py liens publics vers CIVIX et l'Assemblée nationale (un lien exact par scrutin cité)
├── urls.py liste des domaines autorisés pour les liens repris de CIVIX
├── limits.py budgets, délais, tailles de page et plafonds de période, chacun commenté
├── prompts.py questions prêtes à l'emploi
├── config.py réglages lus dans les variables d'environnement
├── server.py assemble le serveur (`mcp`) et la route /health
├── __main__.py lancement en stdio ou en HTTP
└── README.md plan détaillé du code et parcours d'une requête
api/index.py point d'entrée Vercel (ASGI)
web/ page de démo (Next.js)Dossier src/assemblee_mcp/civix/models/ (un module par famille). Tous héritent de CivixModel : champs inconnus ignorés, modèles immuables.
Enveloppe générique
CivixResponse[AttributesT]:answer,summary,canonical_url,meta(avecPagination),source,citationetdata(Data[AttributesT], dont le blocattributes).Modèles par point d'accès, en alias :
ScrutinListResponse,ScrutinResponse,ScrutinVotesResponse,StatementsResponse,DeputeListResponse,DeputeDetailResponse,GroupeListResponse,GroupeDetailResponse,SearchResponse.Objets métier :
ScrutinSummary,ScrutinDetail,Scrutin,Vote,VoteCounts,GroupVoteCounts,Depute,Groupe,GroupeStatement, et les résultats de recherche (DeputeSearchHit,ScrutinSearchHit,GroupeSearchHit,DossierSearchHit).Position:StrEnum(pour,contre,abstention,non_votant,unknown). Toute valeur inconnue devientunknown.
Une réponse qui ne respecte pas le modèle devient un message d'erreur lisible, jamais une trace d'appel.
Tous les outils sont annotés readOnlyHint, idempotentHint et openWorldHint à vrai, destructiveHint à faux. Ils renvoient du markdown français, sauf search et fetch qui renvoient du JSON. Une erreur CIVIX devient une ToolError au message clair. Taille de page par défaut : 10 (20 pour scrutins_par_periode).
Budgets par appel d'outil (limits.py) : nombre maximal d'appels réseau vers CIVIX (les réponses en cache ne comptent pas) et délai maximal. Dépassement : message d'erreur en français, jamais de trace d'appel.
Famille | Appels CIVIX max | Délai max | Outils |
Recherche et fiches | 10 | 25 s |
|
Annuaire | 20 | 25 s |
|
Analyses sur listes | 30 | 45 s |
|
Analyses sur détails de scrutins | 45 | 45 s |
|
Types partagés : page entier de 1 à 500 (défaut 1) ; legislature entier de 1 à 30 ; uid de scrutin : 3 à 64 caractères [A-Za-z0-9_-] ; groupe / abbr : sigle de 1 à 32 caractères ; position : pour, contre, abstention ou non_votant ; type_scrutin / type : tous, texte, article, amendement ou autre ; dates au format AAAA-MM-JJ ; dossier : référence DLR… (3 à 30 caractères alphanumériques après DLR).
Outil | Paramètres (type, défaut) | Rôle |
|
| Recherche globale ; jusqu'à 8 résultats par catégorie |
|
| Scrutins par sujet ; sans mots-clés, les plus récents |
|
| Détail et décomptes, global et par groupe |
|
| Votes individuels ; liste limitée à 60 noms, totaux officiels toujours indiqués ; pour une législature close, |
|
| Explications de vote publiées par les groupes |
|
| Députés par nom, groupe, département ou législature ; par département, triés par circonscription, avec des suggestions si le nom est mal orthographié |
|
| Fiche d'un député ; un ancien député est retrouvé par son |
|
| Position d'un député ; exactement un de |
| aucun | Groupes, sigles et effectifs |
|
| Fiche d'un groupe |
|
| JSON |
|
| JSON |
|
| Chronologie des scrutins d'un texte ; amendements comptés mais non listés ; si plusieurs dossiers correspondent, le plus voté est détaillé |
|
| Par législature, de la 14e à la 17e : scrutins dont le titre correspond, nature, adoptés et rejetés, derniers votes sur l'ensemble avec la position majoritaire de chaque groupe ; 100 scrutins lus au plus par législature |
|
| 20 scrutins par page, du plus récent au plus ancien |
|
| Scrutins dont l'écart entre pour et contre est faible |
|
| Volume par semaine, taux d'adoption par type et contexte, jours les plus chargés ; pour une législature close, la période finit à son dernier scrutin |
|
| Dossiers classés par nombre de scrutins ; ce nombre reflète surtout celui des amendements |
| aucun | Totaux de la législature en cours, effectifs par groupe, taux d'adoption estimé sur un échantillon |
|
| Position majoritaire de chaque groupe, scrutin par scrutin |
|
| Taux d'accord entre groupes, deux à deux ; un seul de |
|
| Part des votes conformes à la position majoritaire du groupe ; un seul de |
|
| Répartition des positions d'UN député et alignement sur son groupe ; un seul de |
|
| Part de positions identiques sur les scrutins où les deux ont voté ; un seul de |
|
| Matrice d'accord deux à deux entre plusieurs députés, avec le nombre de scrutins communs de chaque paire ; un seul de |
|
| Export de scrutins ; par sujet, 100 scrutins au plus ; les cellules CSV commençant par |
|
| Votes nominatifs d'un scrutin |
Prompts MCP (src/assemblee_mcp/prompts.py) :
Prompt | Paramètre | Enchaînement demandé à l'IA |
|
|
|
|
|
|
|
|
|
| aucun |
|
|
|
|
|
|
|
Le serveur expose aussi GET /health, qui répond {"status": "ok"}.
Variable | Défaut | Rôle |
|
| Adresse de l'API |
|
| Délai max d'un appel, en secondes |
|
| Durée du cache, en secondes |
|
| Nombre max de réponses gardées en cache |
|
| En-tête |
| actif sur Vercel |
|
|
| Hôte d'écoute en mode |
|
| Port d'écoute en mode |
En cas d'échec réseau ou d'erreur 5xx, le client refait un seul essai après 0,3 s. Il limite aussi les appels simultanés vers CIVIX (4 au maximum).
Caches : réponses gardées CIVIX_CACHE_TTL secondes (10 minutes par défaut). Le détail et les votes d'un scrutin vieux de plus de 2 jours, qui ne change plus, sont gardés 24 h. Ces durées et les tailles des caches de votes et de détails ne sont pas réglables par variable d'environnement.
Deux niveaux de cache, lus dans cet ordre :
Niveau | Où | Durées | Rôle |
L1 | mémoire de chaque instance ( | listes et recherches 10 min ; détail et votes d'un scrutin de plus de 2 jours, annuaire des députés : 24 h | réponse immédiate, aucune copie sérialisée |
L2 | Runtime Cache de Vercel ( | mêmes durées qu'en L1 | une instance froide relit L2 au lieu de CIVIX ; persistant entre instances et déploiements |
Lecture : L1, puis L2 si L1 est vide, puis CIVIX ; une réponse venue de CIVIX est écrite dans L1 et dans L2. Une réponse lue dans L2 ne coûte aucun appel du budget, comme en L1. Précautions :
L2 n'existe que sur Vercel (variables
RUNTIME_CACHE_ENDPOINTetRUNTIME_CACHE_HEADERSposées par la plateforme) ; ailleurs, il est inactif.CIVIX_SHARED_CACHE=offle coupe.Une panne ou un délai (2 s) de L2 n'échoue jamais une demande : on lit CIVIX, et L2 est ignoré 60 s.
Les clés sont préfixées par
SHARED_CACHE_SCHEMA_VERSION(limits.py) : le changer après une modification de modèle ignore toutes les anciennes entrées. Une entrée de forme ancienne est aussi ignorée à la lecture.Chaque élément porte les étiquettes
civixetcivix:<ressource>(scrutin-detail,scrutin-votes,scrutins,deputes,directory…) pour une expiration ciblée.Un élément de plus de 2 Mo (limite du Runtime Cache) reste en mémoire seule. En pratique : l'annuaire fait environ 260 Ko, une liste de 50 scrutins 50 Ko, les votes d'un scrutin 45 Ko.
Le SDK
vercel-cacheenvoie de la télémétrie à Vercel ; elle est coupée par défaut (VERCEL_TELEMETRY_DISABLED=1, sauf si vous la définissez autrement).
Le serveur public tourne sur Vercel (région de Paris, cdg1), gratuitement (plan Hobby) et sans compte à créer pour les utilisateurs. Le dépôt contient déjà tout le nécessaire : api/index.py expose l'application ASGI sur /mcp et vercel.json y redirige toutes les requêtes.
Forkez ce dépôt et importez-le dans Vercel (Add New → Project). Gardez la racine du dépôt comme dossier racine et laissez le framework sur Other.
Déployez. Vercel lit les dépendances et la version de Python dans
pyproject.toml.Votre adresse à partager est
https://<votre-projet>.vercel.app/mcp. Vérifiez avechttps://<votre-projet>.vercel.app/health.Ajoutez une limitation de débit sur le pare-feu de votre projet : le code limite le nombre d'appels vers CIVIX par demande, pas le nombre de demandes.
Pour votre propre copie, chaque push sur votre branche principale redéploie le serveur.
Pour un autre hébergeur (Render, Fly.io, un VPS…) :
mcp-assemblee-nationale --http --host 0.0.0.0 --port $PORTContribuer
Les issues et pull requests sont les bienvenues : nouvelle fonction, meilleure formulation des réponses, correction. La branche main est protégée : toute contribution passe par une pull request dont la CI est verte. Voir CONTRIBUTING.md.
Une règle : des faits sourcés, aucune interprétation politique.
Crédits et licences
Données : Assemblée nationale, en open data, sous Licence Ouverte Etalab 2.0.
API : CIVIX, par Arnaud Bergeret, référencée sur data.gouv.fr. CIVIX est une initiative indépendante et non officielle.
Code : licence MIT, © Elyes Toumi. Données : Licence Ouverte Etalab 2.0.
English
A connector (an MCP server) that lets Claude, ChatGPT or Gemini answer questions about French National Assembly votes, using the open CIVIX API. Free, no account, read-only, every answer links its source.
Live demo: landing page
Remote URL (Claude custom connectors on every plan including Free, ChatGPT Plugins › « Add custom MCP server » on Pro, Business and Enterprise/Edu, Gemini CLI
httpUrl):https://mcp-assemblee-nationale.vercel.app/mcpLocal:
uvx --from git+https://github.com/Toumi-Elyes/mcp-assemblee-nationale mcp-assemblee-nationale(stdio), or--httpfor streamable HTTP.Tools: 27 read-only tools and 6 prompts (vote tracking, deputies by name or department, trends, group agreement and cohesion, per-deputy summary, CSV/JSON exports). Every vote cited carries its exact link. Every analysis ends with a « Méthode » block (period, sample, limits) and nothing ranks deputies. Outputs are in French.
Scope: National Assembly only (no Senate).
Privacy: only the tool query is received; no conversation history, no cookies; CIVIX responses are cached for 10 minutes (24 h for settled votes), in memory and in Vercel's shared Runtime Cache. The landing page counts visits with cookieless Vercel Web Analytics (path only, honours Global Privacy Control, opt-out on its privacy page).
Security: per-call CIVIX request cap, rate limiting at the hosting firewall, third-party text quoted and marked, links allow-listed. Report vulnerabilities via SECURITY.md.
Stack: Python 3.14+, FastMCP 4, Pydantic v2, httpx, Poetry, hosted on Vercel (Paris).
Not official: independent project, not affiliated with the Assemblée nationale or CIVIX.
Licence: code under MIT; data under Licence Ouverte Etalab 2.0.
Bug reports: use the issue forms (bug, incorrect data, idea); security issues go through private reporting.
Available Tools
27 toolsaccords_entre_deputesAccords Entre DeputesARead-onlyIdempotent
Compare les votes de 3 à 5 députés nommés, deux à deux, sur un échantillon de scrutins.
À utiliser pour « Ces députés votent-ils pareil ? » avec plus de deux personnes : pour
chaque paire, part des scrutins votés de la même façon parmi ceux où les deux ont exprimé
un vote. Pour deux députés, préférer comparer_deputes. Indiquer sujet ou
periode_jours. Description factuelle d'un échantillon borné, sans jugement.
Inputs: deputes (required), sujet, legislature, max_scrutins, +1 more.
accords_entre_groupesAccords Entre GroupesARead-onlyIdempotent
Taux d'accord entre groupes parlementaires, deux à deux, sur un échantillon de scrutins.
À utiliser pour une vue d'ensemble des convergences entre groupes : pour chaque paire, part
des scrutins où les deux groupes ont la même position majoritaire. Indiquer sujet ou
periode_jours (30 au plus). Calculé sur un échantillon borné, annoncé dans la méthode.
Pour une législature close (legislature, 14 à 16), la période finit à son dernier scrutin.
Inputs: sujet, legislature, max_scrutins, type_scrutin, +1 more.
bilan_deputeBilan DeputeARead-onlyIdempotent
Répartition des votes d'UN député sur un échantillon et alignement sur son groupe.
Donne le nombre de pour, contre, abstentions, non-votants et scrutins absents de la liste
des votes, ainsi que la part de votes conformes à la position majoritaire de son groupe.
Indiquer sujet ou periode_jours. Sert à décrire, jamais à classer ou juger un député.
Inputs: depute (required), sujet, legislature, max_scrutins, +1 more.
cohesion_groupesCohesion GroupesARead-onlyIdempotent
Part des votes de chaque groupe qui suivent sa position majoritaire.
À utiliser pour mesurer l'homogénéité des votes au sein de chaque groupe sur un sujet ou
une période : part des votes exprimés (pour, contre, abstention) conformes à la position
majoritaire du groupe, calculée sur un échantillon borné de scrutins. Pour une
législature close (legislature, 14 à 16), la période finit à son dernier scrutin.
Inputs: sujet, legislature, max_scrutins, type_scrutin, +1 more.
comment_a_voteComment A VoteARead-onlyIdempotent
Répond à « Comment a voté le député X sur le sujet Y ? ».
Indiquer depute et soit sujet, soit scrutin_uid. Retrouve le député (si le nom est
ambigu, liste les candidats pour que l'utilisateur choisisse), puis donne sa position
(pour, contre, abstention, non-votant) sur les 5 premiers scrutins correspondant au
sujet, avec les liens sources. Un sujet donne souvent plusieurs scrutins (amendements,
articles, ensemble du texte) : citer le titre de chacun. Aucune interprétation. La
législature vaut 17 par défaut ; elle se déduit de scrutin_uid s'il est donné
(14e à 17e législature).
Inputs: depute (required), sujet, legislature, scrutin_uid.
comparer_deputesComparer DeputesARead-onlyIdempotent
Compare les votes de DEUX députés nommés : part de scrutins votés de la même façon.
À utiliser pour « X et Y votent-ils pareil ? ». Calcule, sur les scrutins où les deux ont
exprimé un vote, la part de positions identiques. Indiquer sujet ou periode_jours.
Description factuelle d'un échantillon borné, sans jugement.
Inputs: depute_a (required), depute_b (required), sujet, legislature, +2 more.
declarations_groupesDeclarations GroupesARead-onlyIdempotent
Déclarations publiques des groupes parlementaires sur un scrutin.
Reprend telles quelles les explications de vote publiées par les groupes (souvent aucune). Ne contient aucune analyse : à citer comme déclarations des groupes.
Inputs: uid (required).
dossier_legislatifDossier LegislatifARead-onlyIdempotent
Chronologie de tous les scrutins d'un texte de loi (dossier législatif).
À utiliser pour suivre un texte de bout en bout : votes sur les articles, motions et vote sur l'ensemble, avec les résultats ; les amendements sont comptés mais non listés un à un. Accepte des mots-clés ou une référence de dossier (DLR…). Si plusieurs dossiers correspondent, le plus voté est détaillé et les autres sont proposés.
Inputs: texte (required).
exporter_scrutinsExporter ScrutinsARead-onlyIdempotent
Exporte une liste de scrutins en CSV ou JSON, pour analyser les données soi-même.
À utiliser quand on veut des données brutes (tableur, script) plutôt qu'un résumé. Indiquer
soit date_debut et date_fin (90 jours au plus), soit sujet. Colonnes : uid, numero,
date, legislature, type, contexte, resultat, titre, dossier_ref, dossier_libelle,
url_civix. Les votes individuels s'exportent avec exporter_votes.
Inputs: sujet, format, date_fin, date_debut, +1 more.
exporter_votesExporter VotesARead-onlyIdempotent
Exporte les votes individuels d'un scrutin en CSV ou JSON.
À utiliser pour obtenir la liste brute des votes d'un scrutin (un député par ligne) :
scrutin_uid, depute_uid, prenom, nom, groupe, position (pour, contre, abstention,
non_votant), par_delegation. groupe est le groupe actuel du député, ce qui permet de
regrouper les votes par groupe. Les députés absents ne figurent pas dans la liste.
Inputs: scrutin_uid (required), format, max_lignes.
fetchFetchARead-onlyIdempotent
Récupère le contenu complet d'un résultat de search.
Un scrutin, un député, un groupe ou un dossier législatif (chronologie de ses scrutins).
Renvoie un JSON {"id", "title", "text", "url", "metadata"} ; text est du markdown
français avec décomptes, sources et liens.
Inputs: id (required).
lister_groupesLister GroupesARead-onlyIdempotent
Liste les groupes parlementaires de l'Assemblée nationale avec leur sigle et effectif.
À utiliser pour connaître les sigles (RN, LFI-NFP, SOC…) avant de filtrer par groupe.
Inputs: no named parameters.
obtenir_deputeObtenir DeputeARead-onlyIdempotent
Fiche d'un député : groupe, circonscription, législature, liens officiels.
Indiquer uid ou nom (si le nom est ambigu, les candidats sont listés). La
législature vaut 17 par défaut ; un ancien député (14e à 16e législature) est retrouvé
automatiquement par son uid, dans sa législature la plus récente.
Inputs: nom, uid, legislature.
obtenir_groupeObtenir GroupeBRead-onlyIdempotent
Fiche d'un groupe parlementaire : nom complet, effectif, législature.
Inputs: abbr (required).
obtenir_scrutinObtenir ScrutinARead-onlyIdempotent
Détail d'un scrutin : titre, date, type, résultat officiel et décomptes.
Donne le nombre de pour, contre et abstentions, global puis par groupe parlementaire. Pour savoir comment un député ou un groupe a voté, utiliser ensuite votes_scrutin.
Inputs: uid (required).
positions_groupesPositions GroupesARead-onlyIdempotent
Tableau des positions majoritaires de chaque groupe sur les scrutins d'un sujet.
À utiliser pour voir d'un coup d'œil comment les groupes parlementaires ont voté sur un
thème ou un texte : pour chaque scrutin correspondant, la position majoritaire de chaque
groupe (pour, contre, abstention, ou partagée). Indiquer sujet ou dossier.
legislature (14 à 17) limite la recherche à une législature.
Inputs: sujet, dossier, legislature, max_scrutins, +1 more.
rechercherRechercherARead-onlyIdempotent
Recherche globale dans les données de l'Assemblée nationale (CIVIX).
À utiliser quand on ne sait pas encore si l'on cherche un scrutin, un député, un groupe ou un dossier législatif. Renvoie jusqu'à 8 résultats par catégorie avec leurs identifiants, à réutiliser dans les autres outils. Pour un sujet de vote précis, préférer rechercher_scrutins ; pour une personne, rechercher_deputes.
Inputs: requete (required), page.
rechercher_deputesRechercher DeputesARead-onlyIdempotent
Cherche des députés par nom, groupe, département ou législature (17e par défaut).
À utiliser pour retrouver l'identifiant (uid) d'un député avant d'appeler
obtenir_depute. Les 14e, 15e et 16e législatures sont couvertes aussi. Sans nom,
liste les députés (filtrables par groupe et par département). Pour « Qui est mon
député ? », passez le département de la personne : la circonscription exacte dépend de
l'adresse, ne la devinez pas. Pour une législature close, le groupe indiqué est le
dernier du député dans cette législature.
Inputs: nom, page, groupe, departement, +1 more.
rechercher_scrutinsRechercher ScrutinsARead-onlyIdempotent
Cherche des scrutins (votes de l'Assemblée nationale) par sujet.
À utiliser pour retrouver le vote d'un texte, d'un article ou d'un amendement. Renvoie
pour chaque scrutin la date, le résultat officiel, le titre et son uid, à passer à
obtenir_scrutin ou votes_scrutin. Un même texte donne souvent plusieurs scrutins
(amendements, articles, vote sur l'ensemble).
Inputs: page, mots_cles, legislature.
scrutins_par_periodeScrutins Par PeriodeARead-onlyIdempotent
Liste filtrée des scrutins entre deux dates (90 jours au plus).
À utiliser pour parcourir les scrutins d'une période : filtrer par type (ensemble d'un texte, article, amendement) et par résultat (adopté ou rejeté). 20 scrutins par page, du plus récent au plus ancien. Pour des chiffres agrégés, préférer tendances_scrutins.
Inputs: date_fin (required), date_debut (required), page, type, +1 more.
searchSearchARead-onlyIdempotent
Cherche scrutins, dossiers législatifs, députés et groupes (données CIVIX).
Renvoie un JSON {"results": [{"id", "title", "url"}]} ; les identifiants
(scrutin:<uid>, depute:<uid>, groupe:<sigle>, dossier:<DLR…>) se passent à fetch.
Inputs: query (required).
statistiques_assembleeStatistiques AssembleeARead-onlyIdempotent
Chiffres d'ensemble de la législature en cours : scrutins, groupes, députés.
À utiliser pour une vue générale de l'Assemblée : nombre total de scrutins depuis le début de la législature, part de scrutins adoptés (estimée sur un échantillon réparti sur toute la législature), effectifs de chaque groupe parlementaire et nombre de députés.
Inputs: no named parameters.
suivre_sujetSuivre SujetARead-onlyIdempotent
Suit un sujet d'une législature à l'autre, de 2012 (14e) à aujourd'hui (17e).
À utiliser pour « Depuis quand l'Assemblée vote-t-elle sur X ? », « Qu'a-t-on voté sur
X sous chaque législature ? ». Donne, par législature, le nombre de scrutins dont le
titre correspond, leur nature, adoptés et rejetés, et les derniers votes sur l'ensemble
d'un texte avec leur uid et la position majoritaire de chaque groupe. Relevé factuel :
un nombre de scrutins ne mesure pas l'importance d'un sujet.
Inputs: sujet (required).
tendances_scrutinsTendances ScrutinsARead-onlyIdempotent
Tendances générales des scrutins de l'Assemblée sur une période récente.
Pour une législature close (legislature), la période se termine à son dernier scrutin.
À utiliser pour les questions d'ensemble (« que s'est-il passé à l'Assemblée ce mois-ci ? », « combien de votes, quelle part d'adoption ? ») plutôt que pour un vote précis. Donne le volume de scrutins par semaine, la part de scrutins adoptés au total, par type (amendements, articles, ensembles de textes) et par contexte (PLF, PLFSS, propositions de loi), et les jours les plus chargés.
Inputs: legislature, periode_jours.
textes_les_plus_votesTextes Les Plus VotesARead-onlyIdempotent
Textes (dossiers législatifs) ayant donné lieu au plus de scrutins sur une période.
À utiliser pour savoir quels textes ont occupé l'Assemblée récemment. Pour chaque dossier : nombre de scrutins (dont amendements, articles et votes sur l'ensemble), adoptés/rejetés, date du dernier vote. Un grand nombre de scrutins reflète surtout le nombre d'amendements.
Inputs: limite, periode_jours.
votes_scrutinVotes ScrutinARead-onlyIdempotent
Votes individuels des députés sur un scrutin, regroupés par position.
Les totaux officiels sont toujours indiqués ; la liste de noms est limitée à 60 noms
(utiliser groupe, position ou nom pour affiner). Pour savoir comment UN député a
voté sur un sujet, préférer comment_a_vote.
Inputs: uid (required), nom, groupe, position.
votes_serresVotes SerresARead-onlyIdempotent
Scrutins au résultat serré (faible écart entre pour et contre) sur une période récente.
À utiliser pour repérer les votes qui se sont joués à quelques voix. Par défaut, ne
regarde que les votes sur l'ensemble d'un texte ; type_scrutin permet d'inclure les
articles, amendements ou tous les scrutins.
Inputs: ecart_max, max_scrutins, type_scrutin, periode_jours.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 27 tools
Most tools carve out distinct niches (comment_a_vote vs votes_scrutin vs bilan_depute; cohesion_groupes vs accords_entre_groupes; comparer_deputes vs accords_entre_deputes are explicitly split by arity). However `rechercher` and `search` appear to be near-duplicate global CIVIX searches differing mainly in output shape and language, and `fetch` only makes sense paired with `search`, leaving an agent unsure which search path to take. The aggregate cluster (tendances_scrutins, statistiques_assemblee, scrutins_par_periode) is only separable by reading long descriptions.
Most tools use French verb_noun or noun phrases (rechercher_scrutins, obtenir_depute, lister_groupes) which read predictably, but a large second family is bare noun phrases with no verb (votes_scrutin, dossier_legislatif, cohesion_groupes, bilan_depute). The two English outliers `search` and `fetch` break the French convention entirely and mix languages within the same surface.
At 27 tools the server sits just past the heavy threshold, and several could be merged (search/rechercher, comparer_deputes/accords_entre_deputes, exporter_scrutins/exporter_votes). Still, the domain is genuinely broad — search, deputies, groups, votes, dossiers, analytics, exports — and most tools map to a real analytical question rather than padding.
The surface covers discovery (search/rechercher), detail retrieval (scrutin, député, groupe, dossier), voting behaviour, cross-legislature tracking, aggregates, and raw CSV/JSON export — a full investigative lifecycle. Minor gaps remain: amendments are counted but never listable, and there is no tool for the legislative text/dossier content itself beyond its vote chronology.
Maintenance
Related MCP Connectors
U.S. civic data for AI agents: reps, votes, bills, finance, lobbying, cited gov sources. 47 tools.
French case law (Judilibre) and codes (Légifrance) from official sources, with citation checking.
NosDéputés.fr MCP — civic-tech mirror of the French Assemblée nationale
Official French and EU legal sources (Légifrance, Judilibre, BOFiP, EUR-Lex) for Claude and ChatGPT
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables querying the French National Assembly data, including deputies, interventions, questions, and votes, through natural language.79 npmMIT
- AlicenseAqualityCmaintenanceExposes French political data from Poligraph as MCP tools, allowing journalists and citizens to query politicians, votes, fact-checks, elections, and more via natural language.191MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to query official Polish Sejm data and the ELI legal acts database for deputies, clubs, committees, votes, interpellations, bills, proceedings, transcripts, and legal acts, with source links.2957 npm2Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to look up how each U.S. House member voted on individual House Clerk roll calls, to retrieve a member's attendance and party-line voting shares with explicit denominators and exclusions, and to list every member's position on a given roll call. Keyless, covering the 119th Congress (sessions 1 and 2), with unsupported chambers and Congresses returning a stated reason.96 npmMIT