English Français العربية

io.github.iQuesta/MCP-iQuesta

Official registry Other

Recherche d'offres de stage et d'alternance en France via le réseau iQuesta.com

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http mcp-iquesta 'https://mcp.iquesta.com/api/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-iquesta": {
            "type": "http",
            "url": "https://mcp.iquesta.com/api/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. iQuesta MCP Server
  2. Endpoint
  3. Tools disponibles
  4. Exemples d'utilisation
  5. Configuration côté client
  6. À propos d'iQuesta
  7. Licence

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

ToolDescription
search_jobsRecherche des offres par mots-clés (titre), descriptif de l'annonce, région, discipline, matière, type de contrat
get_jobRécupère le détail complet d'une offre par son ID
list_filtersListe les valeurs possibles pour les filtres (régions, disciplines, matières, types de contrat)

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é.

Paramètres de search_jobs
ParamètreTypeDescription
termstringMots-clés recherchés dans le titre de l'annonce
descriptionstringMots-clés recherchés dans le texte complet de l'annonce (missions, compétences requises...)
disciplinesintegerID de discipline (secteur large), obtenu via list_filters(filter='disciplines')
matieresinteger[]Liste d'IDs de matières (plus granulaire que disciplines), obtenue via list_filters(filter='matieres'). Ex : 27 = "Informatique - Développement"
regionsintegerID de région française, obtenu via list_filters(filter='regions')
contractsstringID du type de contrat : 1 (Stage), 2 (Alternance), -4 (Emploi), -5 (Job étudiant)
beginintegerMois de début souhaité (1-12)
durationintegerDurée maximale de la mission en mois
limitintegerNombre 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

Frequently asked questions

What is io.github.iQuesta/MCP-iQuesta?

Recherche d'offres de stage et d'alternance en France via le réseau iQuesta.com

How do I install io.github.iQuesta/MCP-iQuesta?

It runs as a remote server. In Claude Code: claude mcp add --transport http mcp-iquesta 'https://mcp.iquesta.com/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.iQuesta/MCP-iQuesta need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.iQuesta/MCP-iQuesta open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.iQuesta/MCP-iQuesta?

It is published by iQuesta. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.