MCP Assemblée nationale
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HOST | No | Hôte d'écoute en mode --http (ou option --host). | 127.0.0.1 |
| PORT | No | Port d'écoute en mode --http (ou option --port). | 8000 |
| CIVIX_TIMEOUT | No | Délai max d'un appel à l'API CIVIX, en secondes. | 15 |
| CIVIX_BASE_URL | No | Adresse de l'API CIVIX. | https://www.civix.fr/api/v1 |
| CIVIX_CACHE_TTL | No | Durée du cache des réponses CIVIX, en secondes. | 600 |
| CIVIX_USER_AGENT | No | En-tête User-Agent envoyé à CIVIX. | mcp-assemblee-nationale (+https://github.com/Toumi-Elyes/mcp-assemblee-nationale) |
| CIVIX_CACHE_MAX_ENTRIES | No | Nombre max de réponses CIVIX gardées en cache. | 500 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| rechercherA | 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. |
| rechercher_scrutinsA | 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 |
| obtenir_scrutinA | 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. |
| votes_scrutinA | 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 |
| declarations_groupesA | 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. |
| rechercher_deputesA | Cherche des députés par nom, groupe, département ou législature (17e par défaut). À utiliser pour retrouver l'identifiant ( |
| obtenir_deputeA | Fiche d'un député : groupe, circonscription, législature, liens officiels. Indiquer |
| comment_a_voteA | Répond à « Comment a voté le député X sur le sujet Y ? ». Indiquer |
| lister_groupesA | 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. |
| obtenir_groupeB | Fiche d'un groupe parlementaire : nom complet, effectif, législature. |
| tendances_scrutinsA | Tendances générales des scrutins de l'Assemblée sur une période récente. Pour une législature close ( À 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. |
| textes_les_plus_votesA | 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. |
| scrutins_par_periodeA | 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. |
| statistiques_assembleeA | 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. |
| dossier_legislatifA | 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. |
| votes_serresA | 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 ; |
| suivre_sujetA | 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 |
| positions_groupesA | 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 |
| accords_entre_groupesA | 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 |
| cohesion_groupesA | 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 ( |
| bilan_deputeA | 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 |
| comparer_deputesA | 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 |
| accords_entre_deputesA | 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 |
| exporter_scrutinsA | 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 |
| exporter_votesA | 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. |
| searchA | Cherche scrutins, dossiers législatifs, députés et groupes (données CIVIX). Renvoie un JSON |
| fetchA | Récupère le contenu complet d'un résultat de Un scrutin, un député, un groupe ou un dossier législatif (chronologie de ses scrutins).
Renvoie un JSON |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| resumer_scrutin | Résumer le scrutin le plus pertinent sur un sujet. |
| mon_depute | Présenter un député et proposer de regarder ses votes. |
| comparer_groupes | Comparer la position des groupes sur un sujet. |
| tendances_du_mois | Faire le point sur l'activité de l'Assemblée ces 30 derniers jours. |
| bilan_groupe | Dresser un bilan factuel d'un groupe parlementaire. |
| comparer_deux_deputes | Comparer factuellement les votes de deux députés. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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.