Skip to main content
Glama
MCP Assemblée nationale

MCP Assemblée nationale

by Toumi-Elyes

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
HOSTNoHôte d'écoute en mode --http (ou option --host).127.0.0.1
PORTNoPort d'écoute en mode --http (ou option --port).8000
CIVIX_TIMEOUTNoDélai max d'un appel à l'API CIVIX, en secondes.15
CIVIX_BASE_URLNoAdresse de l'API CIVIX.https://www.civix.fr/api/v1
CIVIX_CACHE_TTLNoDurée du cache des réponses CIVIX, en secondes.600
CIVIX_USER_AGENTNoEn-tête User-Agent envoyé à CIVIX.mcp-assemblee-nationale (+https://github.com/Toumi-Elyes/mcp-assemblee-nationale)
CIVIX_CACHE_MAX_ENTRIESNoNombre 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

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": true
}
resources
{
  "subscribe": false,
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 uid, à passer à obtenir_scrutin ou votes_scrutin. Un même texte donne souvent plusieurs scrutins (amendements, articles, vote sur l'ensemble).

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 groupe, position ou nom pour affiner). Pour savoir comment UN député a voté sur un sujet, préférer comment_a_vote.

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 (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.

obtenir_deputeA

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.

comment_a_voteA

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).

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 (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.

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 ; type_scrutin permet d'inclure les articles, amendements ou tous les scrutins.

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 uid et la position majoritaire de chaque groupe. Relevé factuel : un nombre de scrutins ne mesure pas l'importance d'un sujet.

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 sujet ou dossier. legislature (14 à 17) limite la recherche à une législature.

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 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.

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 (legislature, 14 à 16), la période finit à son dernier scrutin.

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 sujet ou periode_jours. Sert à décrire, jamais à classer ou juger un député.

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 sujet ou periode_jours. Description factuelle d'un échantillon borné, sans jugement.

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 sujet ou periode_jours. Description factuelle d'un échantillon borné, sans jugement.

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 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.

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. 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.

searchA

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.

fetchA

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.

Prompts

Interactive templates invoked by user choice

NameDescription
resumer_scrutinRésumer le scrutin le plus pertinent sur un sujet.
mon_deputePrésenter un député et proposer de regarder ses votes.
comparer_groupesComparer la position des groupes sur un sujet.
tendances_du_moisFaire le point sur l'activité de l'Assemblée ces 30 derniers jours.
bilan_groupeDresser un bilan factuel d'un groupe parlementaire.
comparer_deux_deputesComparer factuellement les votes de deux députés.

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.6/5.0

Scored across 27 tools

Disambiguation3/5

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.

Naming Consistency3/5

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.

Tool Count3/5

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.

Completeness4/5

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

ActivityMaintained
ResponsivenessNo recent community issues