Skip to main content
Glama
france-travail-mcp

france-travail-mcp

đŸ‡«đŸ‡· France Travail MCP

npm version CI License: MIT Node

Serveur MCP (Model Context Protocol) pour les API officielles de France Travail : offres d'emploi, référentiel des métiers ROME 4.0, prédiction ROMEO, et entreprises qui recrutent (La Bonne Boßte).

An MCP server connecting any AI assistant (Claude, Cursor, VS Code
) to the official France Travail APIs: real-time job offers, the ROME occupational taxonomy, ROME-code prediction, and hiring-company search.

Branchez votre assistant IA sur le marchĂ© de l'emploi français : il cherche des offres en temps rĂ©el, traduit un mĂ©tier en code ROME, et cible les entreprises qui recrutent — directement dans la conversation.

C'est, à notre connaissance, le premier serveur MCP basé sur les API REST officielles de France Travail (les autres « MCP France Travail » sont des scrapers du site web, fragiles et non officiels).


⚡ Installation en 30 secondes

Dans tous les cas, il vous faut des identifiants France Travail (gratuits) — voir Obtenir vos identifiants.

đŸ–±ïž Option A — La plus simple, sans terminal (Claude Desktop)

  1. Téléchargez le fichier france-travail-mcp.mcpb depuis la page Releases.

  2. Double-cliquez dessus : Claude Desktop l'installe et vous demande votre Client ID / Client Secret dans un formulaire (le secret est stocké dans le trousseau de votre systÚme).

  3. C'est prĂȘt — aucune Ă©dition de fichier JSON.

⌚ Option B — Une ligne (Claude Code)

claude mcp add france-travail \
  -e FT_CLIENT_ID=PAR_xxxxx \
  -e FT_CLIENT_SECRET=votre_secret \
  -- npx -y france-travail-mcp

đŸ§© Option C — Copier-coller (Claude Desktop, Cursor, VS Code
)

{
  "mcpServers": {
    "france-travail": {
      "command": "npx",
      "args": ["-y", "france-travail-mcp"],
      "env": {
        "FT_CLIENT_ID": "PAR_xxxxx_xxxxxxxxxxxxxxxxxxxx",
        "FT_CLIENT_SECRET": "votre_secret"
      }
    }
  }
}

📖 Guide complet par client (Cursor, VS Code/Cline, et Ollama 100 % local) → INSTALL.md.


Related MCP server: @kula-ai/mcp-server

🔑 Obtenir vos identifiants

  1. Créez un compte sur francetravail.io.

  2. Créez une application dans votre espace.

  3. Souscrivez aux API souhaitĂ©es (au minimum Offres d'emploi v2 ; puis ROME 4.0 – MĂ©tiers, ROME 4.0 – Fiches mĂ©tiers, ROMEO 2, La Bonne BoĂźte v2 selon les outils voulus).

  4. Récupérez le Client ID (PAR_
) et le Client Secret.

PrĂ©requis : Node.js ≄ 18 (sauf l'option A, qui est autoportĂ©e).


🧰 Outils exposĂ©s

Outil

Description

API France Travail

Statut

ft_search_offres

Recherche multicritÚres d'offres (mots-clés, ROME, géo, contrat, salaire
)

Offres d'emploi v2

✅ testĂ© en live

ft_get_offre

Détail complet d'une offre

Offres d'emploi v2

✅ testĂ© en live

ft_list_referentiel

RĂ©fĂ©rentiels (communes, types de contrats
) codes ↔ libellĂ©s

Offres d'emploi v2

✅ testĂ© en live

ft_search_metiers

Trouver un métier ROME et son code par texte

ROME 4.0 – MĂ©tiers

✅ testĂ© en live

ft_get_metier

Fiche d'un métier ROME (définition, accÚs)

ROME 4.0 – MĂ©tiers

✅ testĂ© en live

ft_get_fiche_metier

Compétences & savoirs d'un métier

ROME 4.0 – Fiches mĂ©tiers

✅ testĂ© en live

ft_predict_rome

Deviner le code ROME d'un intitulé libre (IA)

ROMEO 2

✅ testĂ© en live

ft_search_entreprises

Entreprises Ă  fort potentiel d'embauche

La Bonne BoĂźte v2

⚠ dĂ©sactivĂ© par dĂ©faut

La Bonne Boßte est une API à accÚs conditionné : la simple souscription ne suffit pas, France Travail exige une habilitation validée manuellement (sans elle, l'API renvoie 403 Invalid scope). L'outil ft_search_entreprises est donc désactivé par défaut ; une fois l'accÚs accordé, activez-le avec la variable d'environnement FT_ENABLE_LABONNEBOITE=true (son endpoint exact reste à confirmer).

Les autres outils s'activent automatiquement dĂšs que l'API correspondante est souscrite, sans changement de code.


đŸ§Ș Exemple — l'agent enchaĂźne les outils tout seul

« Je suis pùtissier et je cherche un CDI vers Lyon. »

  1. ft_predict_rome("pñtissier") → code ROME D1104

  2. ft_search_offres(codeROME=["D1104"], commune="69381", typeContrat=["CDI"])

  3. ft_search_entreprises(...) pour les candidatures spontanées.

⚠ Paris, Lyon et Marseille s'indiquent par arrondissement (Lyon 1er = 69381, Paris 1er = 75101, Marseille 1er = 13201) : les codes « globaux » 69123 / 75056 / 13055 sont refusĂ©s par l'API (erreur 400). RĂ©cupĂ©rez les bons codes avec ft_list_referentiel.


🔐 Correspondance outils ↔ scopes OAuth

Chaque API a son propre scope. Le serveur demande un token par scope (mis en cache ~25 min). Pour activer un groupe d'outils, votre application doit avoir souscrit Ă  l'API correspondante :

API Ă  souscrire

Scope OAuth

Active

Offres d'emploi v2

api_offresdemploiv2 o2dsoffre

ft_search_offres, ft_get_offre, ft_list_referentiel

ROME 4.0 – MĂ©tiers

api_rome-metiersv1 nomenclatureRome

ft_search_metiers, ft_get_metier

ROME 4.0 – Fiches mĂ©tiers

api_rome-fiches-metiersv1 nomenclatureRome

ft_get_fiche_metier

ROMEO 2

api_romeov2

ft_predict_rome

La Bonne BoĂźte v2

api_labonneboitev2

ft_search_entreprises


đŸ› ïž DĂ©veloppement

git clone https://github.com/jojolabagarre/france-travail-mcp.git
cd france-travail-mcp
npm install              # installe les dépendances ET compile (script "prepare")
cp .env.example .env     # renseignez FT_CLIENT_ID / FT_CLIENT_SECRET
npm run smoke            # test de bout en bout contre l'API réelle

Commande

RĂŽle

npm run build

Compile TypeScript → dist/

npm test

Vérifie les types (tsc --noEmit)

npm run smoke

Test de bout en bout contre l'API réelle

npm start

Démarre le serveur (transport stdio)

npm run bundle

GénÚre le bundle .mcpb (Claude Desktop)

Stack : TypeScript · @modelcontextprotocol/sdk · zod · axios. Transport stdio. Architecture : src/services (auth OAuth2 + client HTTP + erreurs), src/schemas, src/tools (un fichier par domaine). Voir CONTRIBUTING.md.

📩 Publication (mainteneur)

La publication est automatique sur un tag de version (npm puis registre MCP officiel) :

npm version patch        # met à jour la version, crée le commit + le tag
git push --follow-tags   # déclenche le workflow de publication

Voir .github/workflows/publish-mcp.yml. Secret requis dans le dépÎt : NPM_TOKEN (jeton npm). L'authentification au registre MCP se fait par OIDC (aucun secret supplémentaire).

🔒 SĂ©curitĂ©

  • Le fichier .env n'est jamais committĂ© (voir .gitignore).

  • Les identifiants sont fournis au serveur via les variables d'environnement du client MCP (ou le formulaire sĂ©curisĂ© du bundle .mcpb).

  • Ne partagez jamais votre client_secret. En cas de fuite, rĂ©gĂ©nĂ©rez-le sur francetravail.io.

đŸ—ș Feuille de route

  • La Bonne Alternance (offres + formations en alternance)

  • MarchĂ© du travail (statistiques, tensions de recrutement par bassin)

  • Validation/finalisation de ft_search_entreprises (La Bonne BoĂźte)

  • Publication npm + registre MCP + bundle .mcpb

đŸ€ Contribuer

Les contributions sont bienvenues : ouvrez une issue ou une pull request. Voir CONTRIBUTING.md.

📄 Licence & avertissement

Sous licence MIT (voir LICENSE).

Projet non officiel, non affilié à France Travail. Il consomme les API publiques de France Travail ; leur usage est soumis aux conditions d'utilisation de francetravail.io. « France Travail », « ROME » et « La Bonne Boßte » sont des marques de France Travail.

Available Tools

7 tools
ft_get_fiche_metierCompétences et savoirs d'un métier ROMEA
Read-onlyIdempotent

RécupÚre la fiche métier détaillée (format Fiche ROME) pour un code ROME : groupes de compétences (savoir-faire) et groupes de savoirs associés au métier. Utile pour préparer un CV, identifier des compétences à valoriser ou comprendre les attendus d'un métier. Nécessite l'abonnement à l'API « ROME 4.0 - Fiches métiers ».

Inputs: code (required), response_format.

ft_get_metierFiche d'un métier ROMEA
Read-onlyIdempotent

RécupÚre la fiche d'un métier ROME 4.0 par son code (5 caractÚres, ex. 'M1607') : libellé, définition, accÚs au métier et arborescence (domaine professionnel, grand domaine). Nécessite l'abonnement à l'API « ROME 4.0 - Métiers ».

Inputs: code (required), response_format.

ft_get_offreDétail d'une offre d'emploiA
Read-onlyIdempotent

RécupÚre le détail complet d'une offre par son identifiant (champ 'id' renvoyé par ft_search_offres, ex. '209WHZN'). Renvoie l'intitulé, l'entreprise, le lieu, le contrat, le salaire, la description complÚte, les compétences/formations et le lien pour postuler. Erreur 404 si l'identifiant n'existe pas ou si l'offre n'est plus en ligne.

Inputs: id (required), response_format.

ft_list_referentielLister un rĂ©fĂ©rentiel (codes ↔ libellĂ©s)A
Read-onlyIdempotent

Restitue un rĂ©fĂ©rentiel de codes utilisĂ© par la recherche d'offres (codes ↔ libellĂ©s). Indispensable pour traduire un nom en code (ex. trouver le code INSEE d'une commune, ou les codes de types de contrats). Types disponibles : communes, departements, regions, metiers, appellations, themes, domaines, continents, pays, naturesContrats, typesContrats, niveauxFormations, permis, langues, secteursActivites. Astuce : pour 'communes', filtrez vous-mĂȘme par nom dans le rĂ©sultat (la liste est longue).

Inputs: type (required), limit, filtre.

ft_predict_romeDeviner le code ROME d'un intitulé (IA)A
Read-onlyIdempotent

Utilise ROMEO 2 (modÚle d'IA de France Travail) pour rapprocher un intitulé de poste en texte libre des métiers/appellations ROME les plus probables, avec un score de confiance (0 à 1). C'est le meilleur moyen de convertir « ce que dit la personne » (ex. 'je répare des vélos', 'community manager') en code ROME exploitable par ft_search_offres et ft_search_entreprises.

Renvoie les prédictions triées par score décroissant. Ajustez seuilScore pour ne garder que les prédictions fiables. Nécessite l'abonnement à l'API « ROMEO 2 » sur francetravail.io.

Inputs: intitule (required), seuilScore, nbResultats, response_format.

ft_search_metiersRechercher un métier ROMEA
Read-onlyIdempotent

Recherche un métier dans le référentiel ROME 4.0 par texte libre et renvoie les codes ROME correspondants (à 5 caractÚres, ex. M1607). Ces codes alimentent ft_search_offres (paramÚtre codeROME) et ft_search_entreprises. La recherche filtre sur le libellé des 532 métiers ROME (insensible à la casse/accents). Pour un rapprochement sémantique plus fin à partir d'un intitulé de poste, préférez ft_predict_rome.

Nécessite que l'application soit abonnée à l'API « ROME 4.0 - Métiers » sur francetravail.io.

Inputs: query (required), limit. Returns: count, metiers

ft_search_offresRechercher des offres d'emploiA
Read-onlyIdempotent

Recherche multicritÚres dans les offres d'emploi France Travail (temps réel). Renvoie une liste paginée de résumés d'offres + le total de résultats correspondants.

ParamĂštres principaux :

  • motsCles : mots-clĂ©s (ex. 'boulanger', 'dĂ©veloppeur web'). CaractĂšres autorisĂ©s : lettres, chiffres, espace, @#$%^&+./-.

  • codeROME : 1 Ă  3 codes ROME (5 caractĂšres, ex. ['D1102']). Utilisez ft_predict_rome ou ft_search_metiers pour les trouver.

  • commune / departement / region : codes INSEE (commune = 5 chiffres). RĂ©cupĂ©rables via ft_list_referentiel. ⚠ Paris, Lyon et Marseille s'indiquent par ARRONDISSEMENT (ex. Lyon 1er = 69381, Paris 1er = 75101, Marseille 1er = 13201) : les codes « globaux » 69123 / 75056 / 13055 sont rejetĂ©s (400).

  • distance : rayon en km autour de la commune (dĂ©faut 10 ; 0 = uniquement la commune).

  • typeContrat : codes (ex. ['CDI','CDD','MIS']) — voir ft_list_referentiel typesContrats.

  • experience : '1' (<1 an), '2' (1-3 ans), '3' (>3 ans).

  • qualification : '0' (non cadre), '9' (cadre).

  • tempsPlein : true/false.

  • salaireMin + periodeSalaire (M=mensuel, A=annuel, H=horaire, C=autre) : obligatoires ENSEMBLE.

  • publieeDepuis : 1, 3, 7, 14 ou 31 jours.

  • sort : '0' pertinence (dĂ©faut), '1' date, '2' distance.

  • offset (dĂ©faut 0) / limit (dĂ©faut 15, max 150) : pagination. Profondeur max ≈ 1150 rĂ©sultats ; au-delĂ , affinez.

Exemples : « offres de boulanger en CDI Ă  Lyon » → motsCles='boulanger', commune='69381' (Lyon 1er), typeContrat=['CDI']. « dĂ©veloppeurs publiĂ©s cette semaine » → motsCles='dĂ©veloppeur', publieeDepuis='7'.

Erreurs : 400 = paramÚtre/format invalide (vérifiez les codes) ; 403 = API non souscrite.

Inputs: sort, limit, offset, region, +14 more. Returns: count, total, offres, offset, +2 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog


    TDQS

    A4.1/5.0

    Scored across 7 tools

    Disambiguation4/5

    Each tool has a distinct purpose, but some slight overlap exists between ft_predict_rome and ft_search_metiers (both find ROME codes from text) and between ft_get_metier and ft_get_fiche_metier (both retrieve info for a ROME code at different depths). Descriptions clearly differentiate them, so ambiguity is minimal.

    Naming Consistency5/5

    All tools follow a consistent 'ft_verb_noun' pattern in snake_case, using verbs like get, list, predict, search. Naming is predictable and logical, making it easy for an agent to understand the action and resource.

    Tool Count5/5

    With 7 tools, the set is well-scoped for the domain of French job market data. Each tool covers a distinct need (searching, details, prediction, reference) without being overwhelming or sparse.

    Completeness4/5

    The tool set covers core workflows: searching jobs, getting offer details, retrieving job code info, converting text to codes, and listing reference data. A minor gap is the absence of a company search tool (referenced in descriptions but not implemented), but the set is largely complete for its stated purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      MCP server for Recruit CRM, enabling AI assistants to search candidates, view jobs, and manage recruiting workflows.
      53
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server enabling AI assistants to connect to Kula recruiting API for managing jobs, candidates, applications, webhooks, and more.
      84
      150 npm
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      An MCP server integrating with the BoondManager API to enable AI assistants to search, retrieve, create, and update records across 94 tools in 8 business domains.
      95
      MIT