Interface pour agents IA

Serveur MCP FormaScore

FormaScore expose ses données de qualité des formations via le protocole MCP (Model Context Protocol). Claude, ChatGPT et tout agent compatible peuvent interroger les scores en temps réel. L'essai est possible sans clé ; une clé gratuite débloque l'ensemble des outils.

Adresse du serveur

Transport HTTP « streamable », requêtes JSON-RPC 2.0 en POST. Envoyez votre clé dans l'en-tête Authorization: Bearer VOTRE_CLE.

https://formascore.fr/mcp

Obtenir une clé gratuite

100 crédits par mois, les quatre outils, sans engagement ni carte bancaire. Sans clé, l'accès est limité à 10 appels par jour sur deux outils seulement.

Configuration à copier-coller

Pour Claude Desktop, ajoutez ce bloc dans claude_desktop_config.json, puis redémarrez l'application.

Claude Desktop

{
  "mcpServers": {
    "formascore": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://formascore.fr/mcp"]
    }
  }
}

Clients MCP avec transport HTTP natif (Claude web, Cursor, VS Code, agents maison)

{
  "mcpServers": {
    "formascore": {
      "type": "http",
      "url": "https://formascore.fr/mcp",
      "headers": { "Authorization": "Bearer VOTRE_CLE_API" }
    }
  }
}

Test en ligne de commande

curl -X POST https://formascore.fr/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Les quatre outils

rechercher_formations

Trouver des formations et leur note, avec filtres.

Paramètre	Type	Description
query	texte, optionnel	Mots-clés dans l'intitulé ou le nom de l'organisme
domaine	texte, optionnel	Domaine de formation
region	texte, optionnel	Région française
niveau	entier 3-7, optionnel	Niveau de certification
score_min	nombre 0-100, optionnel	Score minimum (exclut les ND)
prix_max	nombre, optionnel	Prix maximum en euros
limit	entier 1-50	Nombre de résultats, 10 par défaut

Requête

{
  "query": "cybersécurité",
  "region": "Île-de-France",
  "score_min": 65,
  "limit": 2
}

Réponse (extrait)

{
  "nombre_resultats": 2,
  "formations": [
    {
      "id": "3f0c…",
      "intitule": "Administrateur cybersécurité",
      "organisme": "CESI",
      "lettre": "B",
      "score": 71,
      "prix_euros": 8900,
      "duree_heures": 812,
      "taux_emploi_6m": 78,
      "url": "https://formascore.fr/formation/3f0c…"
    }
  ],
  "attribution": "Source : FormaScore (formascore.fr) …"
}

obtenir_score

Fiche complète d'une formation : lettre, score, six indicateurs détaillés.

Paramètre	Type	Description
code_rncp	texte, requis	Code certification, ex. RNCP34079
siret	texte, requis	SIRET de l'organisme (14 chiffres)

Requête

{
  "code_rncp": "RNCP34079",
  "siret": "77572257201109"
}

Réponse (extrait)

{
  "formascore": { "lettre": "B", "score_sur_100": 71 },
  "effectifs": { "stagiaires": 146, "seuil_minimum": 20, "suffisant": true },
  "indicateurs": [
    {
      "cle": "insertion",
      "libelle": "Insertion dans l'emploi",
      "valeur": 78,
      "percentile_famille": 82,
      "mediane_famille": 66,
      "ponderation_pourcent": 35
    }
  ],
  "attribution": "Source : FormaScore …"
}

comparer_formations

Tableau comparatif de 2 à 4 formations d'une même famille.

Paramètre	Type	Description
ids	liste de 2 à 4 identifiants	Identifiants renvoyés par la recherche

Requête

{
  "ids": ["3f0c…", "91ba…"]
}

Réponse (extrait)

{
  "famille": { "domaine": "Informatique / Numérique", "niveau": 6 },
  "tableau_comparatif": [
    {
      "indicateur": "Insertion dans l'emploi",
      "ponderation_pourcent": 35,
      "meilleure_valeur": 78,
      "valeurs": [
        { "id": "3f0c…", "valeur": 78, "meilleure": true },
        { "id": "91ba…", "valeur": 64, "meilleure": false }
      ]
    }
  ],
  "attribution": "Source : FormaScore …"
}

obtenir_methodologie

Pondérations, percentiles intra-famille, seuils des lettres, règle ND et sources.

Paramètre	Type	Description
—	aucun paramètre	—

Requête

{}

Réponse (extrait)

{
  "principe": "Le FormaScore compare chaque formation aux formations de sa propre famille …",
  "seuils_lettres": [
    { "lettre": "A", "score": "80 à 100" },
    { "lettre": "E", "score": "moins de 35" }
  ],
  "seuil_effectifs": { "minimum_stagiaires": 20, "regle": "Score non déterminé (ND) …" },
  "attribution": "Source : FormaScore …"
}

Tarifs et crédits

Chaque appel d'outil consomme des crédits selon le barème ci-dessous. Les plans payants autorisent le dépassement, facturé au crédit avec 25 % de majoration, dans la limite d'un plafond de sécurité fixé à deux fois le prix du plan. L'engagement annuel offre deux mois.

Découverte

0 €

Pour tester le serveur MCP.

· 100 crédits par mois
· Tous les outils
· Aucun dépassement possible

Starter

29 € / mois

ou 278,40 € par an (2 mois offerts)

Pour un assistant ou un prototype en production.

· 1 000 crédits par mois
· Dépassement facturé au crédit
· Support par e-mail

Crédit supplémentaire : 3,63 c€

Pro

99 € / mois

ou 950,40 € par an (2 mois offerts)

Pour un produit qui interroge FormaScore au quotidien.

· 5 000 crédits par mois
· Dépassement facturé au crédit
· Support prioritaire

Crédit supplémentaire : 2,48 c€

Scale

299 € / mois

ou 2 870,40 € par an (2 mois offerts)

Pour un usage intensif et multi-clients.

· 20 000 crédits par mois
· Tarif du crédit le plus bas
· Suivi de consommation dédié

Crédit supplémentaire : 1,87 c€

Entreprise

sur devis

Volume illimité, engagement et contrat sur mesure.

· Crédits illimités
· Engagement de service
· Facturation sur mesure

Coût en crédits de chaque outil
Outil	Coût
obtenir_methodologie	gratuit
rechercher_formations	0,1 crédit par résultat
obtenir_score	1 crédit par appel
comparer_formations	1 crédit par formation

Règles d'usage et limites

Sans clé. 10 appels par jour et par adresse IP, limités aux outils rechercher_formations et obtenir_methodologie. Idéal pour tester.
Crédits épuisés ou plafond atteint ? L'appel renvoie une erreur JSON-RPC explicite avec la marche à suivre : jamais de coupure silencieuse.
Facturation. Le cycle est mensuel, clôturé le 1er de chaque mois ; une facture numérotée est émise dès qu'un montant est dû. Changement de plan au prorata du mois en cours.
Attribution obligatoire. Chaque réponse contient un champ attribution qui doit être cité lorsque les données sont reprises.
Formations « ND ». En dessous de 20 stagiaires, aucun score n'est publié. L'outil renvoie la lettre ND et l'explication du seuil : ne reconstituez jamais un score partiel.
Fraîcheur. Le catalogue et les certifications sont synchronisés quotidiennement ; les indicateurs d'insertion suivent le rythme de publication des sources officielles.
Aucune donnée personnelle. Le serveur n'expose que des données publiques agrégées sur les formations et les organismes.

Lire la méthodologie de calcul