iQuesta MCP Server
Connecteur Model Context Protocol pour iQuesta.com, plateforme de recherche d'offres de stage et d'alternance en France.
Permet à n'importe quel agent IA compatible MCP (Claude, ChatGPT, Gemini...) de rechercher des offres d'emploi directement dans la conversation.
Endpoint
https://mcp.iquesta.com/api/mcp
Protocole : MCP 2024-11-05 · Transport : Streamable HTTP · Stack : Laravel 10 / PHP 8.1
Tools disponibles
| Tool | Description |
|---|---|
search_jobs | Recherche des offres par mots-clés (titre), descriptif de l'annonce, région, discipline, matière, type de contrat |
get_job | Récupère le détail complet d'une offre par son ID |
list_filters | Liste les valeurs possibles pour les filtres (régions, disciplines, matières, types de contrat) |
Note : le tool
get_similar_jobsest temporairement désactivé — l'endpoint API correspondant n'existe pas encore côté iQuesta. Il sera réactivé une fois développé.
Paramètres de search_jobs
| Paramètre | Type | Description |
|---|---|---|
term | string | Mots-clés recherchés dans le titre de l'annonce |
description | string | Mots-clés recherchés dans le texte complet de l'annonce (missions, compétences requises...) |
disciplines | integer | ID de discipline (secteur large), obtenu via list_filters(filter='disciplines') |
matieres | integer[] | Liste d'IDs de matières (plus granulaire que disciplines), obtenue via list_filters(filter='matieres'). Ex : 27 = "Informatique - Développement" |
regions | integer | ID de région française, obtenu via list_filters(filter='regions') |
contracts | string | ID du type de contrat : 1 (Stage), 2 (Alternance), -4 (Emploi), -5 (Job étudiant) |
begin | integer | Mois de début souhaité (1-12) |
duration | integer | Durée maximale de la mission en mois |
limit | integer | Nombre maximum de résultats (défaut : 10, max recommandé : 20) |
Au moins un des paramètres term, description ou matieres est requis.
disciplines (16 valeurs, secteurs larges) et matieres (69 valeurs, plus précises) sont deux niveaux de granularité indépendants — utiliser matieres pour un filtrage fin (ex : "Développement web" plutôt que "Informatique").
Exemples d'utilisation
Initialisation
curl -X POST https://mcp.iquesta.com/api/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'
Liste des tools
curl -X POST https://mcp.iquesta.com/api/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'
Recherche d'offres par titre et région
curl -X POST https://mcp.iquesta.com/api/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "search_jobs",
"arguments": {
"term": "développeur",
"regions": 10,
"contracts": "1"
}
}
}'
Recherche par matière et descriptif
curl -X POST https://mcp.iquesta.com/api/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 5,
"method": "tools/call",
"params": {
"name": "search_jobs",
"arguments": {
"description": "Python",
"matieres": [27]
}
}
}'
Lister les filtres disponibles
curl -X POST https://mcp.iquesta.com/api/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 4,
"method": "tools/call",
"params": { "name": "list_filters", "arguments": { "filter": "all" } }
}'
Configuration côté client
Claude.ai / Claude Desktop
Ajouter dans les paramètres de connecteurs :
{
"mcpServers": {
"iquesta": {
"url": "https://mcp.iquesta.com/api/mcp"
}
}
}
À propos d'iQuesta
iQuesta.com référence des milliers d'offres de stage et d'alternance en France, à destination des étudiants et jeunes diplômés.
Licence
MIT