Référence des outils MCP

Pourquoi c’est important

Lorsqu’un assistant IA se connecte à votre compte Kit, il accède à un ensemble d’outils. Chaque outil remplit une fonction précise — lister vos offres d’emploi, récupérer les détails d’un modèle, inviter un membre de l’équipe. Cette page documente chaque outil afin que vous sachiez ce que votre assistant IA peut et ne peut pas faire.

Pour commencer

Chaque assistant IA connecté voit d’abord cette instruction :

Commencez par hiring_get_setup_guide pour comprendre les capacités de recrutement de ce compte, les modèles disponibles et l’état actuel.

L’outil de guide retourne les statistiques de votre compte et les types d’étapes disponibles, donnant à l’assistant le contexte nécessaire avant toute action.

Outils de recrutement

Configuration et modèles

hiring_get_setup_guide

Retourne un aperçu de votre configuration de recrutement : nombre de modèles, offres d’emploi actives, nombre total de candidats et tous les types d’étapes disponibles.

Paramètres : Aucun

Retourne : Nom du compte, statistiques rapides, descriptions des types d’étapes, prochaines étapes suggérées.

---

hiring_list_templates

Liste tous les modèles de processus de recrutement disponibles pour votre compte — les modèles système ainsi que ceux que vous avez créés.

Paramètres :

Nom	Type	Requis	Description
tag	string	Non	Filtrer les modèles par étiquette
published_only	boolean	Non	Uniquement les modèles publiés (par défaut : true)

Retourne : Tableau de modèles avec ID, nom, étiquettes, nombre d’étapes, types d’étapes et nombre d’utilisations.

---

hiring_get_template

Retourne les détails complets d’un modèle spécifique, y compris chaque étape et sa configuration.

Paramètres :

Nom	Type	Requis	Description
template_id	integer	Oui	ID du modèle obtenu via hiring_list_templates

Retourne : Métadonnées du modèle, étapes ordonnées avec type/configuration, et modèles d’e-mails associés.

---

hiring_create_process_template

Crée un modèle de processus de recrutement avec les étapes indiquées. Retourne le nom du modèle, le nombre d’étapes et l’URL d’édition.

Paramètres :

Nom	Type	Requis	Description
name	string	Oui	Nom du modèle (par ex. « Recrutement Ingénieur Logiciel »)
stages	array	Oui	Tableau d’objets étape, chacun avec name (string), type (string), config optionnel (object) et reviewers optionnel (tableau de {email, role})
description	string	Non	Courte description de ce modèle
tags	array	Non	Étiquettes pour la catégorisation

Retourne : ID du modèle, nom, nombre d’étapes et URL d’édition.

Nécessite : Un abonnement actif.

---

Offres d’emploi

hiring_list_job_postings

Liste toutes les offres d’emploi avec leur statut et le nombre de candidatures. Filtrez par statut pour affiner les résultats.

Paramètres :

Nom	Type	Requis	Description
status	string	Non	draft, published, paused, closed ou active

Retourne : Tableau d’offres avec ID, titre, département, localisation, statut, nombre d’étapes, répartition des candidatures (total/actives/rejetées/retirées) et URL publique si publiée.

---

hiring_get_job_posting

Retourne toutes les informations sur une offre d’emploi spécifique : étapes avec affectations des évaluateurs, membres de l’équipe et statistiques du pipeline.

Paramètres :

Nom	Type	Requis	Description
job_posting_id	integer	Oui	ID de l’offre d’emploi obtenu via hiring_list_job_postings

Retourne : Détails complets de l’offre, étapes avec noms des évaluateurs, membres de l’équipe avec rôles, compteurs du pipeline (total/actifs/rejetés/retirés/offre faite).

---

hiring_create_job_posting

Crée une nouvelle offre d’emploi en statut brouillon. Retourne l’URL d’édition pour que vous puissiez la vérifier et la publier dans le navigateur.

Paramètres :

Nom	Type	Requis	Description
title	string	Oui	Titre du poste
description	string	Oui	Description du poste en markdown (ne pas inclure le titre)
department	string	Non	Nom du département
location	string	Non	Localisation du poste
employment_type	string	Non	full_time, part_time, contract ou internship
remote	boolean	Non	Poste en télétravail ?
process_template_id	integer	Non	ID du modèle pour appliquer les étapes de recrutement
salary_min	integer	Non	Salaire minimum
salary_max	integer	Non	Salaire maximum
salary_currency	string	Non	Code devise (par ex. USD, EUR)
salary_period	string	Non	Période (par ex. year, month)

Retourne : ID de la nouvelle offre, titre, statut (toujours « draft ») et URL d’édition.

Nécessite : Un abonnement actif.

Remarque : Cet outil n’est actuellement disponible que via le chatbot IA intégré, pas via les clients MCP externes.

---

Candidatures et pipeline

hiring_list_applications

Liste les candidatures soumises avec des filtres optionnels par date, statut et offre d’emploi. Utilisez cet outil pour voir les nouveaux candidats, la répartition du pipeline par étape, ou filtrer par plage de dates.

Paramètres :

Nom	Type	Requis	Description
date_range	string	Non	this_week, last_week, this_month, last_month, last_7_days ou last_30_days
since	string	Non	Date de début personnalisée (ISO 8601, par ex. 2025-01-01)
until	string	Non	Date de fin personnalisée (ISO 8601, par ex. 2025-01-31)
status	string	Non	active, rejected, withdrawn, offered ou all (par défaut : all)
job_posting_id	integer	Non	Filtrer sur une offre d’emploi spécifique

Retourne : Compteurs par statut, répartition par offre d’emploi et étape, et un tableau de candidatures avec nom du candidat, e-mail, titre du poste, étape actuelle, statut et date de soumission.

---

hiring_get_application_summary

Retourne le contexte au niveau de la candidature pour la présélection : informations sur le candidat, étape actuelle, historique complet des étapes avec soumissions, réponses aux formulaires et valeurs des champs rapides.

Paramètres :

Nom	Type	Requis	Description
application_id	integer	Oui	ID de la candidature obtenu via hiring_list_reviews ou hiring_list_applications

Retourne : Détails du candidat, offre d’emploi, statut de la candidature, étape actuelle, historique chronologique des étapes avec résumés des soumissions, réponses aux formulaires et valeurs des champs rapides.

---

hiring_get_stage_details

Retourne des informations détaillées et spécifiques au type d’étape pour une progression d’étape donnée. Inclut les détails de l’offre, la planification des entretiens, le statut de l’exercice de code, les agrégats d’évaluation, les informations d’enregistrement vidéo et les données de soumission enrichies. Utilisez cet outil après hiring_get_application_summary pour approfondir une étape spécifique.

Paramètres :

Nom	Type	Requis	Description
stage_progress_id	integer	Oui	ID de progression d’étape obtenu via l’historique des étapes de hiring_get_application_summary

Retourne : Métadonnées de l’étape avec statut et chronologie, contexte du candidat et de l’offre d’emploi, toutes les soumissions, et champs spécifiques au type d’étape — termes de l’offre, détails de l’entretien, configuration de l’exercice de code, agrégats d’évaluation, configuration de l’enregistrement vidéo, questions du questionnaire ou configuration du portfolio selon le type d’étape.

---

hiring_advance_application

Fait avancer une candidature à l’étape suivante du pipeline de recrutement, ou à une étape spécifique si stage_id est fourni. Les notifications au candidat et à l’équipe sont envoyées automatiquement.

Paramètres :

Nom	Type	Requis	Description
application_id	integer	Oui	La candidature à faire avancer
stage_id	integer	Non	Avancer vers une étape spécifique (saute les étapes intermédiaires). Si omis, avance à l’étape suivante dans l’ordre.

Retourne : ID de la candidature, nom du candidat, étape précédente, nom et type de la nouvelle étape.

Nécessite : La portée mcp_write.

---

hiring_reject_application

Rejette une candidature. Le candidat est notifié par e-mail (selon le paramètre de délai d’e-mail de rejet du compte). Confirmez toujours avec l’utilisateur avant de rejeter.

Paramètres :

Nom	Type	Requis	Description
application_id	integer	Oui	La candidature à rejeter
reason	string	Non	Motif interne du rejet (non visible par le candidat)

Retourne : ID de la candidature, nom du candidat, titre de l’offre d’emploi, motif et auteur du rejet.

Nécessite : La portée mcp_write.

---

Évaluations

hiring_list_reviews

Retourne votre boîte de réception d’évaluations en trois sections : candidatures nécessitant une présélection, évaluations dans votre file d’attente et vos évaluations terminées.

Paramètres :

Nom	Type	Requis	Description
section	string	Non	screening, my_queue ou completed

Retourne : Trois tableaux (needs_screening, my_queue, completed_reviews) avec noms des candidats, titres des postes, informations sur l’étape et délais d’attente. Inclut les compteurs par section.

---

hiring_get_review_details

Retourne tout ce dont un évaluateur a besoin pour évaluer un candidat à une étape spécifique : informations sur le candidat, soumissions, critères de notation et autres évaluations (en respectant les règles de visibilité de l’évaluation en aveugle).

Paramètres :

Nom	Type	Requis	Description
stage_progress_id	integer	Oui	ID de progression d’étape obtenu via hiring_list_reviews

Retourne : Informations sur le candidat, offre d’emploi, détails de l’étape, toutes les soumissions (réponses de formulaire, code, fichiers, vidéo, etc.), critères de notation avec pondérations, progression de l’évaluation, votre évaluation le cas échéant, et les autres évaluations (lorsqu’elles sont visibles).

---

Vivier de talents

hiring_list_talent_pool

Liste les entrées vérifiées du vivier de talents avec des résumés compacts d’extraction de CV. Paginé à 25 entrées par page. Utilisez hiring_search_talent_pool pour filtrer par compétences ou expérience.

Paramètres :

Nom	Type	Requis	Description
page	integer	Non	Numéro de page (par défaut : 1, 25 entrées par page)

Retourne : Nombre total, informations de pagination et un tableau d’entrées avec e-mail, date de vérification, résumé d’extraction du CV et date de création.

---

hiring_search_talent_pool

Recherche dans le vivier de talents par compétences, expérience ou e-mail en utilisant la recherche sémantique et textuelle. Retourne les extractions de CV détaillées pour les entrées correspondantes.

Paramètres :

Nom	Type	Requis	Description
query	string	Oui	Requête de recherche (compétences, mots-clés d’expérience ou e-mail)
limit	integer	Non	Nombre maximum de résultats (par défaut : 10, max : 25)

Retourne : Entrées correspondantes avec e-mail, date de vérification, extraction de CV détaillée et date de création.

---

hiring_invite_talent_pool

Invite un candidat du vivier de talents à postuler pour une offre d’emploi spécifique. Envoie un e-mail avec un lien de candidature prérempli.

Paramètres :

Nom	Type	Requis	Description
talent_pool_entry_id	integer	Oui	ID de l’entrée du vivier de talents obtenu via hiring_list_talent_pool ou hiring_search_talent_pool
job_posting_id	integer	Oui	ID de l’offre d’emploi obtenu via hiring_list_job_postings

Retourne : ID de l’invitation, e-mail du candidat, titre du poste, auteur de l’invitation et URL de l’invitation.

Nécessite : La portée mcp_write.

---

Vidéo

hiring_search_video_transcripts

Recherche dans les transcriptions d’entretiens vidéo par mots-clés en utilisant la recherche sémantique et textuelle. Retourne les informations du candidat, les détails de la vidéo et les extraits pertinents de la transcription.

Paramètres :

Nom	Type	Requis	Description
query	string	Oui	Mots-clés à rechercher dans les transcriptions
job_posting_id	integer	Non	Filtrer les résultats sur une offre d’emploi spécifique
limit	integer	Non	Nombre maximum de résultats (par défaut : 10, max : 20)

Retourne : Transcriptions vidéo correspondantes avec informations du candidat, détails de la vidéo et extraits pertinents.

---

Outils d’équipe

team_list_members

Liste tous les membres du compte actuel avec leurs rôles.

Paramètres : Aucun

Retourne : Tableau de membres avec nom, e-mail, rôles et indicateur de propriétaire.

---

team_list_invitations

Liste toutes les invitations en attente pour le compte actuel.

Paramètres : Aucun

Retourne : Tableau d’invitations avec nom, e-mail, rôles attribués, auteur de l’invitation et date.

---

team_invite_member

Envoie un e-mail d’invitation à rejoindre votre compte. Seuls les administrateurs du compte peuvent utiliser cet outil.

Paramètres :

Nom	Type	Requis	Description
email	string	Oui	Adresse e-mail à inviter
name	string	Oui	Nom complet de la personne invitée
admin	boolean	Non	Accorder le rôle d’administrateur (par défaut : false)

Retourne : Confirmation avec e-mail, nom, rôle attribué et statut.

Nécessite : La portée mcp_write, le rôle d’administrateur et un abonnement actif.

Outils de prospection

Ces outils nécessitent le module Outreach et un abonnement actif.

outreach_list_campaigns

Liste les campagnes de prospection avec un filtre de statut optionnel. Retourne jusqu’à 25 campagnes.

Paramètres :

Nom	Type	Requis	Description
status	string	Non	Filtrer par draft, active, paused ou completed

Retourne : Tableau de campagnes avec ID, nom, statut, prospect_count, message_count, pending_draft_count et created_at.

---

outreach_get_campaign

Retourne les détails complets d’une campagne spécifique, y compris la configuration, les compteurs de prospects par statut, le résumé des messages et le nombre de réponses.

Paramètres :

Nom	Type	Requis	Description
campaign_id	string	Oui	ID de la campagne obtenu via outreach_list_campaigns

Retourne : ID de la campagne, nom, statut, configuration complète (volume cible, directives IA, étapes de séquence), compteurs de prospects par statut, résumé des messages (total, brouillons en attente, envoyés), nombre de réponses et created_at.

---

outreach_add_prospect

Ajoute un prospect à une campagne. Vérifie les doublons et les e-mails supprimés sauf si force est activé.

Paramètres :

Nom	Type	Requis	Description
campaign_id	string	Oui	Campagne à laquelle ajouter le prospect
email	string	Oui	Adresse e-mail du prospect
first_name	string	Non	Prénom du prospect
last_name	string	Non	Nom de famille du prospect
company_name	string	Non	Nom de l’entreprise
title	string	Non	Titre du poste
source_url	string	Non	Profil LinkedIn ou URL de l’entreprise pour la recherche IA
notes	string	Non	Contexte en texte libre pour l’agent IA
force	boolean	Non	Ignorer les vérifications de doublons et de suppression (par défaut : false)

Retourne : ID du prospect, e-mail et statut.

Nécessite : La portée mcp_write.

---

outreach_draft_email

Met en file d’attente la recherche et la rédaction par l’IA pour un prospect spécifique. Le prospect doit être dans un état permettant la rédaction (pas encore rédigé ni actif).

Paramètres :

Nom	Type	Requis	Description
prospect_id	string	Oui	Prospect pour lequel effectuer la recherche et la rédaction

Retourne : Confirmation que la recherche a été mise en file d’attente.

Nécessite : La portée mcp_write.

---

outreach_list_pending_drafts

Liste les messages rédigés en attente d’approbation, avec un filtre optionnel par campagne. Retourne jusqu’à 25 brouillons.

Paramètres :

Nom	Type	Requis	Description
campaign_id	string	Non	Filtrer sur une campagne spécifique

Retourne : Tableau de brouillons avec ID, nom de la campagne, nom du prospect, objet, aperçu du corps (200 caractères) et created_at.

---

Outils utilitaires

echo

Teste la connectivité MCP. Renvoie votre message avec le contexte du compte.

Paramètres :

Nom	Type	Requis	Description
message	string	Oui	Message à renvoyer

Retourne : Votre message, nom du compte, e-mail de l’utilisateur, portées et horodatage.

---

search_docs

Recherche dans la documentation produit de Kit. Utile lorsque vous demandez à l’assistant comment fonctionne une fonctionnalité.

Paramètres :

Nom	Type	Requis	Description
query	string	Oui	Ce que vous souhaitez rechercher

Retourne : Pages de documentation correspondantes avec titre, catégorie et contenu.

---

get_plans

Récupère les plans tarifaires actuels avec les fonctionnalités, les détails de prix et les informations de facturation.

Paramètres : Aucun

Retourne : Tableau de plans avec nom, description, prix, devise, intervalle, indicateur de tarification par poste, jours d’essai et liste des fonctionnalités.

Résumé des permissions

Outil	Portée requise	Écriture ?	Remarques
echo	—	Non
search_docs	—	Non
get_plans	—	Non
hiring_get_setup_guide	mcp	Non
hiring_list_templates	mcp	Non
hiring_get_template	mcp	Non
hiring_create_process_template	mcp	Oui	Nécessite un abonnement actif
hiring_list_job_postings	mcp	Non
hiring_get_job_posting	mcp	Non
hiring_create_job_posting	—	Oui	Chatbot intégré uniquement ; nécessite un abonnement actif
hiring_list_applications	mcp	Non
hiring_get_application_summary	mcp	Non
hiring_get_stage_details	mcp	Non
hiring_advance_application	mcp_write	Oui
hiring_reject_application	mcp_write	Oui
hiring_list_reviews	mcp	Non
hiring_get_review_details	mcp	Non
hiring_list_talent_pool	mcp	Non
hiring_search_talent_pool	mcp	Non
hiring_invite_talent_pool	mcp_write	Oui
hiring_search_video_transcripts	mcp	Non
team_list_members	mcp	Non
team_list_invitations	mcp	Non
team_invite_member	mcp_write	Oui	Administrateur uniquement ; nécessite un abonnement actif
outreach_list_campaigns	mcp	Non	Nécessite le module Outreach
outreach_get_campaign	mcp	Non	Nécessite le module Outreach
outreach_add_prospect	mcp_write	Oui	Nécessite le module Outreach
outreach_draft_email	mcp_write	Oui	Nécessite le module Outreach
outreach_list_pending_drafts	mcp	Non	Nécessite le module Outreach

Tous les outils sont limités à votre compte connecté. Un assistant ne peut jamais voir ou modifier les données d’un autre compte.