io.github.iQuesta/MCP-iQuesta
Recherche d'offres de stage et d'alternance en France via le réseau iQuesta.com
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http mcp-iquesta 'https://mcp.iquesta.com/api/mcp'
{
"mcpServers": {
"mcp-iquesta": {
"type": "http",
"url": "https://mcp.iquesta.com/api/mcp"
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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
Questions fréquentes
Qu'est-ce que io.github.iQuesta/MCP-iQuesta ?
Recherche d'offres de stage et d'alternance en France via le réseau iQuesta.com
Comment installer io.github.iQuesta/MCP-iQuesta ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http mcp-iquesta 'https://mcp.iquesta.com/api/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.iQuesta/MCP-iQuesta ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
io.github.iQuesta/MCP-iQuesta est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.iQuesta/MCP-iQuesta ?
Il est publié par iQuesta. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.