france-travail-mcp
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., "@france-travail-mcp Find job offers for a baker in Lyon"
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.
đ«đ· France Travail MCP
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)
Téléchargez le fichier
france-travail-mcp.mcpbdepuis la page Releases.Double-cliquez dessus : Claude Desktop l'installe et vous demande votre
Client ID/Client Secretdans un formulaire (le secret est stockĂ© dans le trousseau de votre systĂšme).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
Créez un compte sur francetravail.io.
Créez une application dans votre espace.
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).
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 |
| Recherche multicritĂšres d'offres (mots-clĂ©s, ROME, gĂ©o, contrat, salaireâŠ) | Offres d'emploi v2 | â testĂ© en live |
| DĂ©tail complet d'une offre | Offres d'emploi v2 | â testĂ© en live |
| RĂ©fĂ©rentiels (communes, types de contratsâŠ) codes â libellĂ©s | Offres d'emploi v2 | â testĂ© en live |
| Trouver un mĂ©tier ROME et son code par texte | ROME 4.0 â MĂ©tiers | â testĂ© en live |
| Fiche d'un mĂ©tier ROME (dĂ©finition, accĂšs) | ROME 4.0 â MĂ©tiers | â testĂ© en live |
| CompĂ©tences & savoirs d'un mĂ©tier | ROME 4.0 â Fiches mĂ©tiers | â testĂ© en live |
| Deviner le code ROME d'un intitulĂ© libre (IA) | ROMEO 2 | â testĂ© en live |
| 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'outilft_search_entreprisesest donc désactivé par défaut ; une fois l'accÚs accordé, activez-le avec la variable d'environnementFT_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. »
ft_predict_rome("pĂątissier")â code ROMED1104
ft_search_offres(codeROME=["D1104"], commune="69381", typeContrat=["CDI"])
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/13055sont refusés par l'API (erreur 400). Récupérez les bons codes avecft_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 |
|
|
ROME 4.0 â MĂ©tiers |
|
|
ROME 4.0 â Fiches mĂ©tiers |
|
|
ROMEO 2 |
|
|
La Bonne BoĂźte v2 |
|
|
đ ïž 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éelleCommande | RÎle |
| Compile TypeScript â |
| Vérifie les types ( |
| Test de bout en bout contre l'API réelle |
| Démarre le serveur (transport stdio) |
| GénÚre le bundle |
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 publicationVoir .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
.envn'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 toolsft_get_fiche_metierCompétences et savoirs d'un métier ROMEARead-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 ROMEARead-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'emploiARead-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)ARead-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)ARead-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 ROMEARead-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'emploiARead-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
Scored across 7 tools
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.
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.
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.
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
Related MCP Connectors
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
Public MCP server for discovering open jobs. Search, filter, and get application links.
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for Recruit CRM, enabling AI assistants to search candidates, view jobs, and manage recruiting workflows.53MIT

@kula-ai/mcp-serverofficial
AlicenseAqualityCmaintenanceMCP server enabling AI assistants to connect to Kula recruiting API for managing jobs, candidates, applications, webhooks, and more.84150 npmMIT- AlicenseCqualityDmaintenanceAn 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.95MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that exposes French public APIs (Data Inclusion, Légifrance, La Bonne Alternance) as tools for LLMs, enabling social, legal, and employment assistance.4MIT