ara-rgaa-mcp
Summary: This MCP server drives RGAA 4.1 accessibility audits on the Ara platform (ara.numerique.gouv.fr) via its REST API, letting an MCP client authenticate, create/fill/duplicate/publish audits, and read results and reports.
Authenticate: sign in with an Ara email/password to obtain a JWT used for subsequent requests.
Create audits: start a new audit (FULL = 106 criteria, FAST = 25, COMPLEMENTARY = 50) with pages, auditor info and page-element flags.
Read audits: fetch a full audit (metadata, pages, environments, notes) by its
editUniqueId.Update audits: fully replace metadata (procedure, auditor, contact, environments, tools, technologies, transverse elements, notes) and renumber pages.
Patch notes: update only the audit's rich-text notes field.
Duplicate audits: clone an existing audit (metadata, pages, results, example images) into a new one with fresh IDs, e.g. for a retest.
Fill results: set per-criterion, per-page results (COMPLIANT / NOT_COMPLIANT / NOT_APPLICABLE / NOT_TESTED) with comments, user impact and quick-win flags.
Read results: retrieve all criterion results for an audit, or results for a single page via its slug.
Draft the statement: update the accessibility statement (déclaration d'accessibilité) fields for an audit.
Publish: mark a fully evaluated audit as published/completed (409 if incomplete) — irreversible on Ara.
Delete: soft-delete an audit (subsequent requests return 410 Gone); does not unpublish the report.
Export & report: export results as CSV, and fetch the read-only report (conformity rate, counts, distributions) using the
consultUniqueId.
Note vs. README: the schema is out of sync with the documented 2.x server — it still exposes auth_signin (removed in 2.0 for leaking credentials through model context) and get_page_results (a route the README lists as not exposed, since page slugs aren't returned by the API), while missing the README's auth_refresh, get_audit_method, list_rgaa_criteria, get_rgaa_criterion, get_audit_progress and compare_audits.
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., "@ara-rgaa-mcp Create a full audit for www.example.com with 5 pages"
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.
Ara MCP Server — Audits RGAA via IA
Serveur MCP (Model Context Protocol) qui expose les opérations CRUD sur les audits d'accessibilité RGAA de la plateforme Ara. Permet de piloter un audit Ara entièrement depuis Claude Code, Codex ou tout client MCP compatible — sans login manuel dans le navigateur.
Projet communautaire, non officiel. Ce serveur est un client tiers de l'API d'Ara, le service d'audit d'accessibilité de la DINUM. Il n'est ni édité ni maintenu par la DINUM.
English — An MCP server for Ara, the French government platform for RGAA 4.1 accessibility audits. It exposes 17 tools to create, fill in, publish and export accessibility audits from any MCP client. Requires an account on ara.numerique.gouv.fr. Documentation is in French, matching the audience of the RGAA. Unofficial community project.
Installation
1. Se connecter, une fois :
npx ara-rgaa-mcp loginUne page s'ouvre dans votre navigateur, sur votre propre ordinateur. Vous y saisissez vos identifiants Ara ; le jeton est enregistré dans ~/.config/ara-rgaa-mcp/credentials.json, en permissions 600. Votre mot de passe n'est jamais enregistré.
2. Déclarer le serveur — sans aucun secret dans la configuration :
{
"mcpServers": {
"ara-rgaa": {
"command": "npx",
"args": ["-y", "ara-rgaa-mcp"]
}
}
}Prérequis : Node.js ≥ 18 et un compte sur ara.numerique.gouv.fr.
Pour Claude Code, le fichier est ~/.claude/claude_desktop_config.json. Pour Codex ou Cursor, même format dans leurs réglages MCP respectifs.
Le renouvellement est automatique. Les jetons d'Ara durent 24 h, mais le serveur en demande un neuf à chaque démarrage : un usage régulier ne redemande jamais de se connecter. Après plus de 24 h sans usage, le serveur vous dit de relancer login.
Commande | |
| Se connecter et enregistrer le jeton |
| Compte, instance, âge du jeton |
| Supprimer le jeton enregistré |
Une page locale qui réclame des identifiants ressemble à du hameçonnage : le serveur prend donc quatre précautions.
Il écoute uniquement sur
127.0.0.1, jamais sur une interface réseau.L'URL comporte un jeton aléatoire qu'une autre page locale ne peut pas deviner ; toute autre adresse renvoie 404.
Elle est à usage unique : le serveur s'arrête dès la connexion réussie.
L'URL exacte est affichée dans le terminal — comparez-la à celle du navigateur avant de saisir quoi que ce soit.
Votre mot de passe ne transite que du navigateur vers ce processus local, puis vers ara.numerique.gouv.fr. Il n'est écrit nulle part.
Si vous n'avez pas lancé la commande vous-même, fermez la page.
Related MCP server: WCAG Accessibility MCP
Authentification par variables d'environnement
Alternative à login, pour l'automatisation ou les environnements sans navigateur.
Variable | Défaut | Description |
| — | Jeton JWT. ⚠️ Valable 24 h seulement |
| — | Email, pour l'authentification au démarrage |
| — | Mot de passe, pour l'authentification au démarrage |
|
| URL de base de l'API Ara |
Les identifiants ne sont jamais acceptés en paramètres d'outil. Un paramètre d'outil transite par le contexte du modèle et se retrouve conservé dans les transcripts de conversation. Ils sont donc lus uniquement depuis l'environnement du processus ou depuis le fichier écrit par login.
⚠️
ARA_AUTH_TOKENexpire au bout de 24 heures. Les jetons d'Ara sont signés avecexpiresIn: "24h": un jeton collé à la main cesse de fonctionner le lendemain. Ne l'utilisez que pour une intégration automatisée qui sait le renouveler. Pour un usage quotidien, préférezloginci-dessus, ou à défautARA_USERNAME/ARA_PASSWORD— qui suppose en revanche d'écrire un mot de passe en clair dans un fichier de configuration.
L'outil auth_refresh rejoue l'authentification en cours de session, si un jeton a expiré.
Outils
Chaque outil porte des annotations (readOnlyHint, destructiveHint, idempotentHint) qui permettent à votre client MCP de demander confirmation avant les opérations sensibles.
Outil | Nature | Description |
| 📖 référentiel | Plan de travail : quels critères exigent quoi |
| 📖 référentiel | Index des critères RGAA (numéro + intitulé), filtrable |
| 📖 référentiel | Un critère, ses tests et ce qu'il faut pour le vérifier |
| ↻ | Rejoue l'authentification depuis l'environnement |
| ✚ additif | Créer un nouvel audit |
| ✚ additif | Dupliquer un audit pour un retest, fiche comprise (la source n'est pas touchée) |
| 🔒 lecture seule | Récupérer un audit complet |
| 🔒 lecture seule | Avancement : ce qui reste à évaluer, par page |
| 🔒 lecture seule | Retest : taux avant/après, critères et résultats qui ont changé |
| 🔒 lecture seule | Résultats de critères, filtrables par page et par statut |
| 🔒 lecture seule | Rapport complet avec taux de conformité |
| 🔒 lecture seule | Export CSV des résultats |
| ⚠️ destructif | Mise à jour complète — remplace les métadonnées |
| ⚠️ destructif | Remplace les notes de l'audit |
| ⚠️ destructif | Remplace l'évaluation des critères visés |
| ⚠️ destructif | Remplace ET publie la déclaration d'accessibilité |
| ⚠️ destructif | Rend l'audit public — irréversible (voir ci-dessous) |
| ⚠️ destructif | Suppression (410 ensuite) — ne dépublie pas |
Retest après correctifs
Le cycle conseillé : audit initial, correctifs, copie de l'audit, retest des critères touchés, déclaration depuis la copie.
duplicate_auditrecopie la fiche. La duplication d'Ara laisse vides le demandeur, l'organisation de l'auditeur, l'URL, le contact, les technologies et les outils (vérifié sur l'API). Le serveur les reprend de la source, en gardant les pages dans l'ordre de la source. PassercopyMetadata: falsepour s'en tenir à la copie d'Ara. Si cette seconde étape échoue, la copie existe quand même : ses identifiants sont renvoyés avec un avertissement.update_auditrenumérote les pages dans l'ordre du tableau envoyé. Renvoyer les pages triées parorder(celui deget_audit), sinon l'échantillon est réordonné dans le rapport.compare_auditsconfronte l'audit initial et sa copie. Les pages sont appariées par nom et URL. Il renvoie le taux de chaque audit calculé selon la règle d'Ara (non conforme sur une page = non conforme ; conforme sur au moins une page et non conforme nulle part = conforme ; taux = conformes / applicables), les critères dont le statut a changé et les transitions page par page (NC→C, C→NC…).
Envoi des résultats par paquets
update_audit_results envoie les résultats à Ara par paquets de 20 (batchSize, de 1 à 100). Ara répond parfois 500 à un paquet dont chaque résultat passe seul (constaté sur des paquets de 23 à 36 résultats des thématiques 10 et 12). Le serveur coupe alors le paquet en deux, jusqu'au résultat isolé :
les résultats acceptés sont enregistrés ;
ceux qu'Ara refuse même seuls sont listés dans
echecs;une erreur 4xx arrête l'envoi et indique combien de résultats étaient déjà enregistrés.
Chaque envoi remplace l'évaluation visée : renvoyer un paquet est sans effet de bord.
Le référentiel RGAA embarqué
Le serveur embarque le référentiel RGAA 4.1 complet — 13 thématiques, 106 critères, et les tests de chacun. Sans lui, un agent ne manipule que des numéros (topic: 6, criterium: 1) sans savoir ce qu'il évalue.
list_rgaa_criteria(auditType: "FAST") → les 25 critères de l'audit rapide (~5 Ko)
get_rgaa_criterion(topic: 6, criterium: 1)
→ « Chaque lien est-il explicite (hors cas particuliers) ? » + ses 5 tests (~2 Ko)Le geste attendu pendant un audit : get_rgaa_criterion pour lire le critère et ses tests, puis update_audit_results pour poser le verdict. Juger plutôt que deviner.
Les données proviennent de rgaa.json du projet Ara, publié par la DINUM sous Licence Ouverte 2.0. Elles sont embarquées dans le paquet — le serveur fonctionne donc hors ligne, sans appel réseau pour la partie référentiel. Régénération : node scripts/build-rgaa-data.mjs.
À noter : les types d'audit
FASTetCOMPLEMENTARYcouvrent 25 critères chacun et sont disjoints ; c'est la méthodologie complète (rapide + complémentaire) qui en couvre 50.
Le code source ne suffit pas
Sur les 106 critères du RGAA, 40 seulement se tranchent en lisant le HTML — et 6 sur les 25 d'un audit rapide. Les autres exigent la page rendue, une navigation clavier réelle, l'arbre d'accessibilité, ou un jugement éditorial.
C'est le piège de l'audit assisté par IA : un agent lit du balisage, y trouve des réponses plausibles, et remplit un audit qui ne repose sur rien. Trois mécanismes s'y opposent.
get_audit_method(auditType) — le plan de travail avant de commencer : quels critères relèvent du source, du rendu, du clavier, de la restitution, du jugement.
get_rgaa_criterion joint à chaque critère un bloc verification : sourceSuffit, les besoins, et comment s'y prendre.
update_audit_results refuse un verdict non fondé. Déclarer CONFORME ou NON CONFORME sur un critère qui exige davantage, sans renseigner le champ evidence correspondant, produit une erreur explicite :
Verdict refusé sur 1 critère(s) : le code source ne suffit pas à les trancher,
et la vérification correspondante n'a pas été déclarée.
10.7 — exige : clavier (…) ; rendu (…)
Effectuez réellement ces vérifications, puis renseignez le champ "evidence".
Si vous ne pouvez pas les faire, utilisez le statut NOT_TESTED plutôt qu'un
verdict non fondé.NOT_TESTED et NOT_APPLICABLE en sont dispensés : ils n'affirment rien. Et evidence reste déclaratif — un agent peut mentir, mais plus par omission.
Cette classification est une guidance de ce serveur, déduite du vocabulaire des tests puis corrigée à la main. Le RGAA dit quoi vérifier, pas avec quel outil.
⚠️ Publier est irréversible
Ara n'offre aucune dépublication, et supprimer un audit ne retire pas son rapport publié :
Après | |
|
|
|
|
Le rapport devient alors inaccessible depuis l'interface d'Ara : vous ne pouvez plus ni le consulter, ni le corriger, ni le retirer. Seul votre nom d'auditeur disparaît du rapport public ; le contenu de l'audit demeure.
Deux conséquences pratiques :
ne traitez jamais la suppression comme un moyen d'annuler une publication ;
publier un audit portant sur un site tiers met en ligne une déclaration d'accessibilité le concernant, signée de vous — assurez-vous d'en avoir le mandat.
Citer du HTML dans un commentaire
Ara affiche les commentaires de critère en texte riche : un <th> écrit tel quel est interprété comme une balise et disparaît du commentaire rendu — l'API répond 200, le constat perd sa substance, et rien ne le signale.
Depuis la 2.2.1, update_audit_results échappe < et > dans compliantComment, notApplicableComment et le title/comment de chaque notCompliantItems. Citez donc le balisage librement :
"comment": "Le champ n'a ni <label for>, ni aria-label."
↳ affiché dans Ara : Le champ n'a ni <label for>, ni aria-label.N'échappez pas vous-même : & est laissé intact, donc un <th> déjà échappé reste correct.
Exception : le champ notes (patch_audit_notes) reste du texte riche non échappé — c'est le champ prévu pour la mise en forme. Pour y citer du balisage, écrivez <th>.
Révisions de protocole MCP
Depuis la 2.1.0, le serveur sert les deux révisions de la spécification depuis le même code, en négociant à l'ouverture de la connexion :
2025-11-25— poignée de maininitialize, comme avant.2026-07-28— sans état : plus deinitialize,server/discover,resultType, et des indices de cache (ttlMs/cacheScope) sur le catalogue d'outils.
Il n'y a rien à configurer : votre client obtient la révision qu'il sait parler.
Migration depuis la 1.x
La 2.0 supprime l'outil auth_signin, qui recevait l'e-mail et le mot de passe en paramètres — donc à travers le contexte du modèle.
Retirez tout appel à
auth_signinde vos scripts ou prompts.Mettez vos identifiants dans le bloc
envde la configuration MCP (voir Authentification) : le serveur s'authentifie tout seul au démarrage.auth_refresh, sans argument, remplace le besoin d'une reconnexion manuelle en cours de session.
Corrigé au passage : signin envoyait l'en-tête Authorization avec le jeton courant, ce qui faisait répondre 404 Cannot POST /api/auth/signin à l'API dès que ce jeton était expiré — précisément le cas où l'on cherche à se reconnecter.
Workflow typique
1. get_audit_method("FULL") # De quoi aurai-je besoin ?
2. create_audit(FULL, "MonSite", pages...) # Créer l'audit (106 critères)
3. get_audit(editUniqueId) # Récupérer les IDs de page
4. get_rgaa_criterion(topic, criterium) # Lire le critère et ses tests
5. update_audit_results(...) # Poser le verdict (envoi par paquets)
6. get_audit_progress(editUniqueId) # Que reste-t-il ?
↳ revenir en 4 tant qu'il reste des critères
7. update_statement(editUniqueId, ...) # Remplir la déclaration
8. publish_audit(editUniqueId) # Publier l'audit terminé
9. get_report(consultUniqueId) # Consulter le rapport final
Retest : duplicate_audit (fiche comprise) → update_audit_results sur la copie
→ compare_audits(initial, copie) → update_statement sur la copieL'audit complet est le cas normal : seul un audit sur les 106 critères fonde une déclaration d'accessibilité. FAST (25 critères) et COMPLEMENTARY (25 autres) servent à repérer, pas à déclarer.
Un audit complet, c'est 106 critères par page, éléments transverses compris — 318 résultats pour deux pages, près d'un millier sur un échantillon de huit. D'où la boucle 4→6 : évaluer par lots, puis demander ce qu'il reste avec get_audit_progress plutôt que de rapatrier tous les résultats.
L'authentification est faite au démarrage du serveur depuis l'environnement : aucune étape de login dans le workflow.
Enums RGAA
Types d'audit
FULL— 106 critères (audit complet)FAST— 25 critères (audit rapide)COMPLEMENTARY— 50 critères (audit complémentaire)
Statuts de critère
COMPLIANT— ConformeNOT_COMPLIANT— Non conformeNOT_APPLICABLE— Non applicableNOT_TESTED— Non testé
Impact utilisateur
MINOR— MineurMAJOR— MajeurBLOCKING— Bloquant
Thématiques RGAA (topics 1-13)
Images
Cadres
Couleurs
Multimédia
Tableaux
Liens
Scripts
Éléments obligatoires
Structuration de l'information
Présentation de l'information
Formulaires
Navigation
Consultation
Cartographie des routes Ara
Audits (/audits)
Méthode | Route | Outil MCP |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Rapports (/reports) — lecture seule
Méthode | Route | Outil MCP |
|
|
|
Authentification (/auth)
Méthode | Route | Outil MCP |
|
|
|
Routes non exposées (hors périmètre MCP)
Route | Raison |
| Le |
| Upload d'image (deprecated) |
| Upload de fichier |
| Upload d'image éditeur |
| Suppression image |
| Suppression fichier |
| Liste d'audits (nécessite auth account) |
| Création de compte |
| Vérification de compte |
| Profil utilisateur |
| Retour utilisateur |
Développement
git clone https://github.com/DavidPivert/ara-rgaa-mcp.git
cd ara-rgaa-mcp
npm install
npm run build # compile vers build/
npm run typecheck # tsc --noEmit
npm test # tests hors ligne (envoi par paquets, fiche, comparaison), après le buildPublication. Le paquet est publié sur npm par GitHub Actions (.github/workflows/publier.yml) en « publication de confiance » (OIDC), sans jeton ni clé, avec une attestation d'origine. Pour une nouvelle version : monter la version dans package.json et server.json, fusionner dans main, puis pousser le tag vX.Y.Z. Le workflow refuse un tag qui ne correspond pas à package.json et ne republie pas une version déjà en ligne. Le bouton « Run workflow » publie la version de package.json si elle manque.
Pour brancher la copie locale sur un client MCP, pointer command sur node et args sur le chemin absolu de build/index.js — ou utiliser run.sh, qui fait le cd nécessaire à la résolution des node_modules.
Licence
EUPL-1.2 — Licence Publique de l'Union Européenne, pour le code de ce dépôt.
Le référentiel RGAA embarqué (src/rgaa-data.ts) est extrait du projet Ara et reste sous Licence Ouverte 2.0 — Direction interministérielle du numérique (DINUM).
Ce serveur est un projet indépendant : il consomme l'API d'Ara sans en reprendre le code. Ara est publié par la DINUM sous licence MIT, qui n'impose aucune contrainte sur la licence de ce dépôt.
Available Tools
14 toolsauth_signinA
Authenticate to the Ara platform using email/password. Returns a JWT token that will be used for all subsequent requests. Required only if ARA_AUTH_TOKEN is not set.
Inputs: username (required), password (required).
create_auditA
Create a new RGAA accessibility audit in Ara. Returns the audit with its editUniqueId (for editing) and consultUniqueId (for viewing the report).
Audit types:
FULL: all 106 RGAA criteria
FAST: 25 key criteria (audit rapide)
COMPLEMENTARY: 50 criteria (audit complémentaire)
Inputs: auditType (required), procedureName (required), pages (required), auditorName (required), +2 more.
delete_auditA
Soft-delete an audit. The audit will return HTTP 410 Gone for future requests.
Inputs: uniqueId (required).
duplicate_auditA
Fully duplicate an existing audit (metadata, pages, RGAA results, example images). Returns a new audit with fresh IDs.
Inputs: uniqueId (required), procedureName (required).
export_csvB
Export audit results in CSV format.
Inputs: uniqueId (required).
get_auditA
Retrieve a full audit by its editUniqueId. Returns all metadata, pages, environments, and notes.
Inputs: uniqueId (required).
get_audit_resultsA
Retrieve all criterion results for an audit. Returns an array of results, each with:
topic (1-13): RGAA topic number
criterium: criterion number within the topic
pageId: ID of the audited page
status: COMPLIANT | NOT_COMPLIANT | NOT_APPLICABLE | NOT_TESTED
compliantComment / notCompliantComment / notApplicableComment
userImpact: MINOR | MAJOR | BLOCKING (when not compliant)
quickWin: whether the fix is easy
Inputs: uniqueId (required).
get_page_resultsA
Get criterion results for a specific page of an audit. The pageSlug is typically the page order number.
Inputs: uniqueId (required), pageSlug (required).
get_reportA
Get the full audit report (read-only). Includes accessibility rate, criteria counts, and result distributions by page and topic. Uses the consultUniqueId (not the editUniqueId).
Inputs: consultUniqueId (required).
patch_audit_notesA
Update only the notes field of an audit. Useful for adding audit observations without touching other metadata.
Inputs: uniqueId (required), notes (required).
publish_auditA
Mark an audit as published/completed. The audit must be fully filled in (all criteria evaluated) before publishing. Returns HTTP 409 if incomplete.
Inputs: uniqueId (required).
update_auditC
Full update of an audit's metadata (procedure info, auditor info, environments, tools, technologies, notes, etc.).
Inputs: uniqueId (required), auditType (required), procedureName (required), pages (required), +16 more.
update_audit_resultsA
Update criterion results for an audit. Send an array of result items. Each item targets one criterion on one page using (pageId, topic, criterium).
The topic/criterium must be a valid RGAA combination. Topics 1-13:
Images, 2. Cadres, 3. Couleurs, 4. Multimédia, 5. Tableaux,
Liens, 7. Scripts, 8. Éléments obligatoires, 9. Structuration,
Présentation, 11. Formulaires, 12. Navigation, 13. Consultation
Status values: COMPLIANT, NOT_COMPLIANT, NOT_APPLICABLE, NOT_TESTED User impact values: MINOR, MAJOR, BLOCKING
Inputs: uniqueId (required), results (required).
update_statementB
Update the accessibility statement (déclaration d'accessibilité) for an audit. This is used to generate the public accessibility statement.
Inputs: editUniqueId (required), initiator, auditorOrganisation, procedureUrl, +9 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Each tool targets a distinct action within the audit lifecycle: authentication, CRUD for audits, result management, export, report generation, and statement updates. No two tools have overlapping purposes, and descriptions clearly differentiate them.
All tools follow a consistent verb_noun snake_case pattern (e.g., create_audit, get_audit_results, update_statement). 'auth_signin' is slightly different but still fits the pattern. No mixing of styles.
14 tools cover the full scope of RGAA audit management: authentication, full CRUD, duplicate, publish, export, and result updates. This is well-scoped for the domain without being excessive or insufficient.
The tool set covers all major operations (create, read, update, delete, duplicate, publish, export, statement). A minor gap is the lack of a 'list_audits' tool to retrieve all audits, but core workflows are well-supported.
Maintenance
Related MCP Connectors
Governed MCP gateway: one endpoint for your tools, with credential custody and audit log.
Your Aurentia workspace — projects, CRM, tasks, deliverables — in Claude, Cursor or any MCP client.
Query, browse, and automate OmegaAI workspaces from any MCP client. Streamable HTTP with OAuth 2.0.
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables auditing web pages for WCAG violations, applying deterministic fixes and PRs, all through MCP clients like Claude Desktop.7MIT
- AlicenseAqualityBmaintenanceA WCAG accessibility testing MCP for AI agents, Codex, Claude Code, and automated UI audits.728 npm1MIT
- AlicenseAqualityBmaintenanceEnables running comprehensive website audits from any MCP client, returning actionable plain-language reports covering SEO, accessibility, performance, security, and more.662 npmMIT
- AlicenseAqualityBmaintenanceEnables AI agents to perform real accessibility audits by controlling a browser, running axe-core scans, reviewing page structure, images, tab order, and WCAG 2.2 color contrast, all over MCP with local session logging.2112 npm1Apache 2.0