Installer et utiliser mcp-rncp
Tout ce qu'il faut pour connecter le RNCP et le RS à un assistant IA via le Model Context Protocol : installation, outils, exemples de prompts, format des réponses, données, limites.
InstallationOutilsPrompts & resourcesNuméros acceptésFormat des réponsesDonnéesLimitesFAQAuteur
Installation
Version hébergée (recommandée) — https://mcp-rncp.com/mcp
Transport Streamable HTTP, sans authentification, 60 requêtes/minute par IP, réponses mises en cache 1 h. Je l'héberge sur Cloudflare Workers + D1.
Claude.ai (web et mobile)
Paramètres → Connecteurs → « Ajouter un connecteur personnalisé » →
nom RNCP, URL https://mcp-rncp.com/mcp, pas d'authentification. Dans « Outils en lecture seule »,
choisissez « Autoriser » pour ne plus confirmer chaque appel.
Claude Code
claude mcp add --transport http rncp https://mcp-rncp.com/mcpCursor (.cursor/mcp.json), ChatGPT (mode développeur), Windsurf, VS Code…
{ "mcpServers": { "rncp": { "url": "https://mcp-rncp.com/mcp" } } }Version locale — npx -y mcp-rncp
Serveur stdio pour Claude Desktop et les IDE. Nécessite Node.js ≥ 22.16. Au premier lancement, la base SQLite (~90 Mo compressés) est téléchargée depuis mes releases GitHub, vérifiée (SHA-256) puis mise à jour chaque semaine en arrière-plan.
{
"mcpServers": {
"rncp": { "command": "npx", "args": ["-y", "mcp-rncp"] }
}
}Options : --db <rncp.sqlite> (base locale), --cache-dir, --update, --no-update, --help.
Outils
| Outil | Paramètres | Réponse |
|---|---|---|
search_certifications | query (texte FR), repertoire RNCP|RS, niveau 3-8, nsf, rome, actives_only (défaut true), limit ≤ 20 | Liste classée : numéro, intitulé, niveau, statut, échéance, score. Un numéro saisi en requête renvoie la fiche exacte. |
get_certification | numero, full (textes complets) | Fiche structurée : certificateurs, activités visées, compétences attestées, secteurs, emplois, prérequis, voies d'accès, NSF/ROME/Formacode, textes JO, remplace / remplacée par, correspondances de blocs, statistiques de promotions, URL officielle. |
list_blocs | numero | Blocs ordonnés : code, intitulé, compétences, modalités d'évaluation, prérequis ; liste edof_codes. |
check_validity | numero | actif, date_fin_enregistrement, jours_restants, date_limite_delivrance, remplacee_par, eligible_cpf_estime, avertissement. |
check_habilitation | numero, siret (14 chiffres) ou SIREN (9) | habilite, roles (former, evaluer), est_certificateur, partenaires trouvés avec état et dates. |
list_partenaires | numero, siret_prefix, actifs_only, limit ≤ 100, offset | Partenaires paginés avec rôles, totaux, indicateur truncated. |
compare_certifications | numero_a, numero_b | Niveaux, statuts, certificateurs, NSF/ROME communs, recouvrement lexical des blocs (Jaccard), bloc le plus proche pour chaque bloc. |
changes_since | since (AAAA-MM-JJ), type, repertoire, nsf, limit | Changements créés / modifiés / désactivés / réactivés / retirés entre deux exports. |
get_data_status | — | Date de l'export, âge en jours, identifiant du run, compteurs. |
Prompts et resources
- Prompt
rediger_offre_edof(numero, public, durée) : rédige objectifs pédagogiques, programme par bloc et liste des blocs à déclarer, uniquement à partir de la fiche. - Prompt
verifier_certification(numero, siret) : verdict de conformité validité + habilitation + blocs. - Resource
rncp://glossaire: RNCP, RS, niveaux, blocs, habilitations, CPF, EDOF, NSF, ROME. - Resource
rncp://about: source, licence, fraîcheur, couverture, limites.
Exemples de questions
Numéros acceptés
RNCP35419, 35419, rncp 35419, RNCP-35419, RS5000, ou l'URL de la fiche
sur francecompetences.fr. Un nombre seul est cherché d'abord au RNCP puis au RS.
Format des réponses
Chaque outil renvoie du JSON structuré (structuredContent) et un texte identique, avec systématiquement :
summary (une phrase), source (France compétences, licence, URL du jeu de données, data_updated_at),
url_fiche vers la fiche officielle et, quand un texte est coupé, truncated: true. Les erreurs sont
explicites (numéro inconnu avec les variantes essayées, SIRET invalide).
Données, fraîcheur, licence
Source : jeu de données « Répertoire national des certifications professionnelles et répertoire spécifique » de France compétences sur data.gouv.fr, flux XML V4.1, réutilisé sous Licence Ouverte 2.0 (mention de la source et de la date dans chaque réponse).
Je réimporte l'export automatiquement chaque semaine (et à la demande) : parse du XML, construction d'une base SQLite/FTS5, publication en release GitHub pour la version locale, chargement dans Cloudflare D1 sans interruption (deux bases blue/green). Statut en direct : /health.
Limites
- Pas de temps réel : l'âge des données est indiqué par
get_data_status(≤ 7 jours en régime normal). eligible_cpf_estimeest une estimation ; l'éligibilité réelle dépend aussi de l'habilitation et du référencement EDOF.- Recherche plein texte (pas sémantique) : préférez les termes de l'intitulé officiel ; les sigles courants (BTS, TP, RH, dev, MCO…) sont gérés.
- Non inclus en v1 : NPEC (prise en charge apprentissage), composition des jurys, référentiels PDF.
- Service hébergé limité à 60 requêtes/minute par IP ; usage intensif →
npx mcp-rncpen local.
FAQ
Qu'est-ce que mcp-rncp ?
Un serveur MCP (Model Context Protocol) open source que j'ai créé pour exposer le Répertoire national des certifications professionnelles (RNCP) et le Répertoire spécifique (RS) de France compétences sous forme d'outils utilisables par Claude, ChatGPT, Cursor ou tout client MCP. Il répond à des questions comme « le RNCP 35419 est-il actif ? » ou « mon SIRET est-il habilité ? » directement dans la conversation.
Est-ce gratuit ?
Oui. La version hébergée (https://mcp-rncp.com/mcp) est gratuite, sans compte ni clé API, limitée à 60 requêtes par minute et par adresse IP. La version locale s'installe avec « npx -y mcp-rncp » et fonctionne hors ligne après le premier téléchargement des données. Le code est sous licence MIT.
D'où viennent les données et sont-elles à jour ?
Du jeu de données ouvert « RNCP et RS » publié par France compétences sur data.gouv.fr (Licence Ouverte 2.0). Je réimporte l'export chaque semaine automatiquement ; la date de l'export en service est affichée sur ce site et renvoyée dans chaque réponse avec l'URL de la fiche officielle sur francecompetences.fr.
Comment vérifier qu'un organisme est habilité sur une certification ?
Demandez par exemple « Le SIRET 88055223700047 est-il habilité sur le RNCP 37674 ? ». L'outil check_habilitation renvoie si l'organisme est habilité, pour quel rôle (former, organiser l'évaluation ou les deux), l'état de l'habilitation et ses dates, et signale si le SIRET est le certificateur lui-même.
Comment obtenir les blocs de compétences à déclarer dans EDOF ?
Demandez « Liste les blocs de compétences du RNCP 37674 ». L'outil list_blocs renvoie les codes RNCPxxxxxBCyy dans l'ordre officiel, l'intitulé, les compétences et les modalités d'évaluation de chaque bloc. Depuis le 11 juin 2026 les organismes doivent renseigner ces blocs dans EDOF ; à partir du 22 octobre 2026 les offres non renseignées deviennent invisibles sur Mon Compte Formation.
Une certification active est-elle éligible au CPF ?
En principe oui : une certification enregistrée et active au RNCP ou au RS est éligible au CPF. L'outil check_validity renvoie une éligibilité estimée ; l'éligibilité effective dépend aussi de l'habilitation et du référencement EDOF de l'organisme de formation.
Qui a créé mcp-rncp ?
Moi, Arnaud Aldebert, développeur fullstack et systèmes IA (RAG, agents, MCP) basé à Nîmes. Le projet illustre mon travail sur les intégrations MCP en production ; mon portfolio : https://arnaud-aldebert.dev.
Auteur et contact
Bugs et idées : issues GitHub. Licence MIT.