IQuesta MCP server

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

Note : le tool getsimilarjobs est 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

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 :

Shortened. The full README is on GitHub.