{
  "markdown": "# iQuesta MCP Server\n\n[![smithery badge](https://smithery.ai/badge/julien-yell/iquesta)](https://smithery.ai/servers/julien-yell/iquesta)\n\nConnecteur [Model Context Protocol](https://modelcontextprotocol.io) pour [iQuesta.com](https://iquesta.com), plateforme de recherche d'offres de stage et d'alternance en France.\n\nPermet à n'importe quel agent IA compatible MCP (Claude, ChatGPT, Gemini...) de rechercher des offres d'emploi directement dans la conversation.\n\n## Endpoint\nhttps://mcp.iquesta.com/api/mcp\n\n**Protocole** : MCP 2024-11-05 · **Transport** : Streamable HTTP · **Stack** : Laravel 10 / PHP 8.1\n\n## Tools disponibles\n\n| Tool | Description |\n|---|---|\n| `search_jobs` | Recherche des offres par mots-clés (titre), descriptif de l'annonce, région, discipline, matière, type de contrat |\n| `get_job` | Récupère le détail complet d'une offre par son ID |\n| `list_filters` | Liste les valeurs possibles pour les filtres (régions, disciplines, matières, types de contrat) |\n\n> **Note** : le tool `get_similar_jobs` est temporairement désactivé — l'endpoint API correspondant n'existe pas encore côté iQuesta. Il sera réactivé une fois développé.\n\n### Paramètres de `search_jobs`\n\n| Paramètre | Type | Description |\n|---|---|---|\n| `term` | string | Mots-clés recherchés dans le **titre** de l'annonce |\n| `description` | string | Mots-clés recherchés dans le **texte complet** de l'annonce (missions, compétences requises...) |\n| `disciplines` | integer | ID de discipline (secteur large), obtenu via `list_filters(filter='disciplines')` |\n| `matieres` | integer[] | Liste d'IDs de matières (plus granulaire que `disciplines`), obtenue via `list_filters(filter='matieres')`. Ex : `27` = \"Informatique - Développement\" |\n| `regions` | integer | ID de région française, obtenu via `list_filters(filter='regions')` |\n| `contracts` | string | ID du type de contrat : `1` (Stage), `2` (Alternance), `-4` (Emploi), `-5` (Job étudiant) |\n| `begin` | integer | Mois de début souhaité (1-12) |\n| `duration` | integer | Durée maximale de la mission en mois |\n| `limit` | integer | Nombre maximum de résultats (défaut : 10, max recommandé : 20) |\n\nAu moins un des paramètres `term`, `description` ou `matieres` est requis.\n\n`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\").\n\n## Exemples d'utilisation\n\n### Initialisation\n\n```bash\ncurl -X POST https://mcp.iquesta.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{}}'\n```\n\n### Liste des tools\n\n```bash\ncurl -X POST https://mcp.iquesta.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/list\",\"params\":{}}'\n```\n\n### Recherche d'offres par titre et région\n\n```bash\ncurl -X POST https://mcp.iquesta.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"id\": 3,\n    \"method\": \"tools/call\",\n    \"params\": {\n      \"name\": \"search_jobs\",\n      \"arguments\": {\n        \"term\": \"développeur\",\n        \"regions\": 10,\n        \"contracts\": \"1\"\n      }\n    }\n  }'\n```\n\n### Recherche par matière et descriptif\n\n```bash\ncurl -X POST https://mcp.iquesta.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"id\": 5,\n    \"method\": \"tools/call\",\n    \"params\": {\n      \"name\": \"search_jobs\",\n      \"arguments\": {\n        \"description\": \"Python\",\n        \"matieres\": [27]\n      }\n    }\n  }'\n```\n\n### Lister les filtres disponibles\n\n```bash\ncurl -X POST https://mcp.iquesta.com/api/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"id\": 4,\n    \"method\": \"tools/call\",\n    \"params\": { \"name\": \"list_filters\", \"arguments\": { \"filter\": \"all\" } }\n  }'\n```\n\n## Configuration côté client\n\n### Claude.ai / Claude Desktop\n\nAjouter dans les paramètres de connecteurs :\n\n```json\n{\n  \"mcpServers\": {\n    \"iquesta\": {\n      \"url\": \"https://mcp.iquesta.com/api/mcp\"\n    }\n  }\n}\n```\n\n## À propos d'iQuesta\n\n[iQuesta.com](https://iquesta.com) référence des milliers d'offres de stage et d'alternance en France, à destination des étudiants et jeunes diplômés.\n\n## Licence\n\nMIT\n",
  "bytes": 4281,
  "sha": "63d7f2c3bf92926677f46bb90f1c04b12dc490ef0dce71586b2ca3031b034e6f",
  "repo_slug": "iquesta/mcp-iquesta",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_iquesta_mcp_iquesta_18524c74/readme"
}