Documentation 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, données, limites.

Installation Outils Prompts & resources Numéros acceptés Format des réponses Données Limites FAQ

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.

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/mcp
Cursor (.cursor/mcp.json), ChatGPT (mode développeur → connecteurs MCP), Windsurf, VS Code et tout client MCP :
```
{ "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 les 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

« Quelles certifications actives de niveau 5 en gestion de paie ? »

« Le RNCP 37674 expire quand ? Combien de jours restants ? »

« Qui est habilité sur le RS 5719 dans le Gard (SIREN commençant par 8) ? »

« Compare le RNCP 36490 et le RNCP 37873 : blocs communs ? »

« Quelles fiches informatique (NSF 326) ont été désactivées depuis le 1er juillet ? »

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). Export en service : 16 août 2026 — 30 475 fiches (25 638 RNCP, 4 837 RS), 6 989 actives, 55 761 blocs, 397 774 lignes d'habilitation. Réimport hebdomadaire, base publiée en release GitHub et chargée 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_estime est 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-rncp en local.

FAQ

Qu'est-ce que mcp-rncp ?

Un serveur MCP (Model Context Protocol) open source qui expose 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). Les données sont réimportées chaque semaine ; chaque réponse indique la date de l'export utilisé et 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 ?

Arnaud Aldebert, développeur fullstack et systèmes IA (RAG, agents, MCP) basé à Nîmes. Le projet est une vitrine de son travail sur les intégrations MCP en production ; portfolio : https://arnaud-aldebert.dev.

Auteur et contact

Créé et maintenu par Arnaud Aldebert, développeur fullstack & systèmes IA (Nîmes) — LinkedIn, GitHub. Bugs et idées : issues GitHub. Licence MIT.