MCP-Tools-Referenz
Vollständige Referenz aller MCP-Tools für KI-Assistenten — Parameter, Rückgabedaten und erforderliche Berechtigungen.
Warum es wichtig ist
Wenn sich ein KI-Assistent mit Ihrem Kit-Konto verbindet, erhält er Zugriff auf eine Reihe von Tools. Jedes Tool erfüllt eine Aufgabe — Ihre Stellenanzeigen auflisten, Vorlagendetails abrufen, ein Teammitglied einladen. Diese Seite dokumentiert jedes Tool, damit Sie wissen, was Ihr KI-Assistent kann und was nicht.
Erste Schritte
Jeder verbundene KI-Assistent sieht zuerst diese Anweisung:
Beginnen Sie mit
hiring_get_setup_guide, um die Einstellungsfähigkeiten dieses Kontos, verfügbare Vorlagen und den aktuellen Status zu verstehen.
Das Guide-Tool gibt Ihre Kontostatistiken und verfügbaren Phasentypen zurück und gibt dem Assistenten Kontext, bevor er Aktionen ausführt.
Einstellungs-Tools
Einrichtung & Vorlagen
hiring_get_setup_guide
Gibt einen Überblick über Ihre Einstellungseinrichtung zurück: Vorlagenanzahl, aktive Stellenanzeigen, Gesamtkandidaten und alle verfügbaren Phasentypen.
Parameter: Keine
Gibt zurück: Kontoname, Schnellstatistiken, Beschreibungen der Phasentypen, vorgeschlagene nächste Schritte.
hiring_list_templates
Listet alle für Ihr Konto verfügbaren Einstellungsprozessvorlagen auf — sowohl Systemvorlagen als auch benutzerdefinierte, die Sie erstellt haben.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
tag |
string | Nein | Vorlagen nach Tag filtern |
published_only |
boolean | Nein | Nur veröffentlichte Vorlagen (Standard: true) |
Gibt zurück: Array von Vorlagen mit ID, Name, Tags, Phasenanzahl, Phasentypen und Verwendungsanzahl.
hiring_get_template
Gibt vollständige Details einer bestimmten Vorlage zurück, einschließlich jeder Phase und ihrer Konfiguration.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
template_id |
integer | Ja | Vorlagen-ID aus hiring_list_templates |
Gibt zurück: Vorlagen-Metadaten, geordnete Phasen mit Typ/Konfiguration und zugehörige E-Mail-Vorlagen.
hiring_create_process_template
Erstellt eine Einstellungsprozessvorlage mit den angegebenen Phasen. Gibt den Vorlagennamen, die Phasenanzahl und die Bearbeitungs-URL zurück.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
name |
string | Ja | Vorlagenname (z. B. „Software Engineer Hiring”) |
stages |
array | Ja | Array von Phasenobjekten, jeweils mit name (string), type (string), optionalem config (object) und optionalen reviewers (array von {email, role}) |
description |
string | Nein | Kurze Beschreibung dieser Vorlage |
tags |
array | Nein | Tags zur Kategorisierung |
Gibt zurück: Vorlagen-ID, Name, Phasenanzahl und Bearbeitungs-URL.
Erfordert: Aktives Abonnement.
Stellenanzeigen
hiring_list_job_postings
Listet alle Stellenanzeigen mit Status und Bewerbungsanzahl auf. Nach Status filtern, um Ergebnisse einzugrenzen.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
status |
string | Nein | draft, published, paused, closed oder active |
Gibt zurück: Array von Anzeigen mit ID, Titel, Abteilung, Standort, Status, Phasenanzahl, Bewerbungsaufschlüsselung (gesamt/aktiv/abgelehnt/zurückgezogen) und öffentlicher URL, wenn veröffentlicht.
hiring_get_job_posting
Gibt alles über eine bestimmte Stellenanzeige zurück: Phasen mit Prüferzuweisungen, Teammitglieder und Pipeline-Statistiken.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
job_posting_id |
integer | Ja | Stellenanzeigen-ID aus hiring_list_job_postings |
Gibt zurück: Vollständige Anzeigendetails, Phasen mit Prüfernamen, Teammitglieder mit Rollen, Pipeline-Anzahlen (gesamt/aktiv/abgelehnt/zurückgezogen/angeboten).
hiring_create_job_posting
Erstellt eine neue Stellenanzeige im Entwurfsstatus. Gibt die Bearbeitungs-URL zurück, damit Sie sie im Browser prüfen und veröffentlichen können.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
title |
string | Ja | Berufsbezeichnung |
description |
string | Ja | Stellenbeschreibung in Markdown (Titel nicht einschließen) |
department |
string | Nein | Abteilungsname |
location |
string | Nein | Stellenstandort |
employment_type |
string | Nein | full_time, part_time, contract oder internship |
remote |
boolean | Nein | Remote-Position? |
process_template_id |
integer | Nein | Vorlagen-ID zur Anwendung von Einstellungsphasen |
salary_min |
integer | Nein | Mindestgehalt |
salary_max |
integer | Nein | Höchstgehalt |
salary_currency |
string | Nein | Währungscode (z. B. USD, EUR) |
salary_period |
string | Nein | Zeitraum (z. B. year, month) |
Gibt zurück: Neue Anzeigen-ID, Titel, Status (immer „draft”) und Bearbeitungs-URL.
Erfordert: Aktives Abonnement.
Hinweis: Dieses Tool ist derzeit nur über den integrierten KI-Chatbot verfügbar, nicht über externe MCP-Clients.
Bewerbungen & Pipeline
hiring_list_applications
Listet eingereichte Bewerbungen mit optionalen Datums-, Status- und Stellenanzeigenfiltern auf. Verwenden Sie es, um neue Bewerber zu sehen, die Pipeline-Aufschlüsselung nach Phase anzuzeigen oder nach Datumsbereich zu filtern.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
date_range |
string | Nein | this_week, last_week, this_month, last_month, last_7_days oder last_30_days |
since |
string | Nein | Benutzerdefiniertes Startdatum (ISO 8601, z. B. 2025-01-01) |
until |
string | Nein | Benutzerdefiniertes Enddatum (ISO 8601, z. B. 2025-01-31) |
status |
string | Nein | active, rejected, withdrawn, offered oder all (Standard: all) |
job_posting_id |
integer | Nein | Auf eine bestimmte Stellenanzeige filtern |
Gibt zurück: Anzahlen nach Status, Aufschlüsselung nach Stellenanzeige und Phase sowie ein Array von Bewerbungen mit Kandidatenname, E-Mail, Stellentitel, aktueller Phase, Status und Einreichungszeit.
hiring_get_application_summary
Gibt Bewerbungskontext für das Screening zurück: Kandidateninformationen, aktuelle Phase, vollständige Phasenhistorie mit Einreichungen, Formularantworten und Schnellfeldwerte.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
application_id |
integer | Ja | Bewerbungs-ID aus hiring_list_reviews oder hiring_list_applications |
Gibt zurück: Kandidatendetails, Stellenanzeige, Bewerbungsstatus, aktuelle Phase, chronologische Phasenhistorie mit Einreichungszusammenfassungen, Formularantworten und Schnellfeldwerte.
hiring_get_stage_details
Gibt detaillierte, phasentypspezifische Informationen für einen einzelnen Phasenfortschritt zurück. Umfasst Angebotsdetails, Interviewplanung, Code-Assignment-Status, Bewertungsaggregate, Videoaufnahme-Informationen und umfangreiche Einreichungsdaten. Verwenden Sie es nach hiring_get_application_summary, um in eine bestimmte Phase einzutauchen.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
stage_progress_id |
integer | Ja | Phasenfortschritts-ID aus der Phasenhistorie von hiring_get_application_summary |
Gibt zurück: Phasen-Metadaten mit Status und Timing, Kandidaten- und Stellenanzeigenkontext, alle Einreichungen und phasentypspezifische Felder — Angebotskonditionen, Interviewdetails, Code-Assignment-Konfiguration, Bewertungsaggregate, Videoaufnahme-Konfiguration, Fragebogenfragen oder Portfolio-Konfiguration je nach Phasentyp.
hiring_advance_application
Rückt eine Bewerbung zur nächsten Phase in der Einstellungspipeline vor, oder zu einer bestimmten Phase, wenn stage_id angegeben ist. Benachrichtigungen an den Kandidaten und das Team werden automatisch gesendet.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
application_id |
integer | Ja | Die vorzurückende Bewerbung |
stage_id |
integer | Nein | Zu einer bestimmten Phase vorrücken (überspringt Zwischenphasen). Wenn weggelassen, wird zur nächsten Phase in der Reihenfolge vorgerückt. |
Gibt zurück: Bewerbungs-ID, Kandidatenname, vorherige Phase, neuer Phasenname und Typ.
Erfordert: mcp_write-Bereich.
hiring_reject_application
Lehnt eine Bewerbung ab. Der Kandidat wird per E-Mail benachrichtigt (abhängig von der konfigurierten Ablehnungs-E-Mail-Verzögerung des Kontos). Bestätigen Sie immer mit dem Benutzer, bevor Sie ablehnen.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
application_id |
integer | Ja | Die abzulehnende Bewerbung |
reason |
string | Nein | Interner Grund für die Ablehnung (dem Kandidaten nicht angezeigt) |
Gibt zurück: Bewerbungs-ID, Kandidatenname, Stellentitel, Grund und wer abgelehnt hat.
Erfordert: mcp_write-Bereich.
Überprüfungen
hiring_list_reviews
Gibt Ihren Überprüfungs-Posteingang in drei Abschnitten zurück: Bewerbungen, die Screening benötigen, Überprüfungen in Ihrer Warteschlange und Ihre abgeschlossenen Überprüfungen.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
section |
string | Nein | screening, my_queue oder completed |
Gibt zurück: Drei Arrays (needs_screening, my_queue, completed_reviews) mit Kandidatennamen, Stellentiteln, Phaseninformationen und Wartezeiten. Enthält Anzahlen pro Abschnitt.
hiring_get_review_details
Gibt alles zurück, was ein Prüfer benötigt, um einen Kandidaten in einer bestimmten Phase zu bewerten: Kandidateninfo, Einreichungen, Bewertungskriterien und andere Überprüfungen (unter Berücksichtigung der Sichtbarkeitsregeln für Blind-Reviews).
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
stage_progress_id |
integer | Ja | Phasenfortschritts-ID aus hiring_list_reviews |
Gibt zurück: Kandidateninfo, Stellenanzeige, Phasendetails, alle Einreichungen (Formularantworten, Code, Dateien, Video usw.), Bewertungskriterien mit Gewichtungen, Überprüfungsfortschritt, Ihre Überprüfung (falls vorhanden) und andere Überprüfungen (wenn sichtbar).
Talent-Pool
hiring_list_talent_pool
Listet verifizierte Talent-Pool-Einträge mit kompakten Lebenslauf-Extraktionszusammenfassungen auf. Paginiert mit 25 Einträgen pro Seite. Verwenden Sie hiring_search_talent_pool zum Filtern nach Fähigkeiten oder Erfahrung.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
page |
integer | Nein | Seitennummer (Standard: 1, 25 Einträge pro Seite) |
Gibt zurück: Gesamtanzahl, Paginierungsinfo und ein Array von Einträgen mit E-Mail, Verifizierungsdatum, Lebenslauf-Extraktionszusammenfassung und Erstellungsdatum.
hiring_search_talent_pool
Durchsucht den Talent-Pool nach Fähigkeiten, Erfahrung oder E-Mail mithilfe semantischer und Textsuche. Gibt detaillierte Lebenslaufextraktionen für übereinstimmende Einträge zurück.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
query |
string | Ja | Suchanfrage (Fähigkeiten, Erfahrungsschlüsselwörter oder E-Mail) |
limit |
integer | Nein | Maximale Ergebnisse (Standard: 10, max: 25) |
Gibt zurück: Übereinstimmende Einträge mit E-Mail, Verifizierungsdatum, detaillierter Lebenslaufextraktion und Erstellungsdatum.
hiring_invite_talent_pool
Lädt einen Talent-Pool-Kandidaten ein, sich für eine bestimmte Stellenanzeige zu bewerben. Sendet eine E-Mail mit einem vorausgefüllten Bewerbungslink.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
talent_pool_entry_id |
integer | Ja | Talent-Pool-Eintrags-ID aus hiring_list_talent_pool oder hiring_search_talent_pool |
job_posting_id |
integer | Ja | Stellenanzeigen-ID aus hiring_list_job_postings |
Gibt zurück: Einladungs-ID, Kandidaten-E-Mail, Stellentitel, wer eingeladen hat und die Einladungs-URL.
Erfordert: mcp_write-Bereich.
Video
hiring_search_video_transcripts
Durchsucht Video-Interview-Transkripte nach Schlüsselwörtern mithilfe semantischer und Textsuche. Gibt Kandidateninfo, Videodetails und relevante Transkriptausschnitte zurück.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
query |
string | Ja | Schlüsselwörter, die in Transkripten gesucht werden sollen |
job_posting_id |
integer | Nein | Ergebnisse auf eine bestimmte Stellenanzeige filtern |
limit |
integer | Nein | Maximale Ergebnisse (Standard: 10, max: 20) |
Gibt zurück: Übereinstimmende Video-Transkripte mit Kandidateninfo, Videodetails und relevanten Ausschnitten.
Team-Tools
team_list_members
Listet alle Mitglieder des aktuellen Kontos mit ihren Rollen auf.
Parameter: Keine
Gibt zurück: Array von Mitgliedern mit Name, E-Mail, Rollen und Inhaber-Flag.
team_list_invitations
Listet alle ausstehenden Einladungen für das aktuelle Konto auf.
Parameter: Keine
Gibt zurück: Array von Einladungen mit Name, E-Mail, zugewiesenen Rollen, wer eingeladen hat und wann.
team_invite_member
Sendet eine Einladungs-E-Mail zum Beitritt zu Ihrem Konto. Nur Kontoadministratoren können dieses Tool verwenden.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
email |
string | Ja | Einzuladende E-Mail-Adresse |
name |
string | Ja | Vollständiger Name des Eingeladenen |
admin |
boolean | Nein | Admin-Rolle gewähren (Standard: false) |
Gibt zurück: Bestätigung mit E-Mail, Name, zugewiesener Rolle und Status.
Erfordert: mcp_write-Bereich, Admin-Rolle und aktives Abonnement.
Outreach-Tools
Diese Tools erfordern das Outreach-Add-on und ein aktives Abonnement.
outreach_list_campaigns
Listet Outreach-Kampagnen mit optionalem Statusfilter auf. Gibt bis zu 25 Kampagnen zurück.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
status |
string | Nein | Filtern nach draft, active, paused oder completed |
Gibt zurück: Array von Kampagnen mit ID, Name, Status, prospect_count, message_count, pending_draft_count und created_at.
outreach_get_campaign
Gibt vollständige Details für eine bestimmte Kampagne zurück, einschließlich Konfiguration, Interessenten-Anzahlen nach Status, Nachrichtenzusammenfassung und Antwortanzahl.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
campaign_id |
string | Ja | Kampagnen-ID aus outreach_list_campaigns |
Gibt zurück: Kampagnen-ID, Name, Status, vollständige Konfiguration (Zielvolumen, KI-Anweisungen, Sequenzschritte), Interessenten-Anzahlen nach Status, Nachrichtenzusammenfassung (gesamt, ausstehende Entwürfe, gesendet), Antwortanzahl und created_at.
outreach_add_prospect
Fügt einen Interessenten zu einer Kampagne hinzu. Prüft auf Duplikate und unterdrückte E-Mails, sofern nicht force gesetzt ist.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
campaign_id |
string | Ja | Kampagne, zu der der Interessent hinzugefügt werden soll |
email |
string | Ja | E-Mail-Adresse des Interessenten |
first_name |
string | Nein | Vorname des Interessenten |
last_name |
string | Nein | Nachname des Interessenten |
company_name |
string | Nein | Unternehmensname |
title |
string | Nein | Berufsbezeichnung |
source_url |
string | Nein | LinkedIn-Profil oder Unternehmens-URL für KI-Recherche |
notes |
string | Nein | Freitextkontext für den KI-Agenten |
force |
boolean | Nein | Duplikat- und Unterdrückungsprüfungen überspringen (Standard: false) |
Gibt zurück: Interessenten-ID, E-Mail und Status.
Erfordert: mcp_write-Bereich.
outreach_draft_email
Stellt KI-Recherche und -Entwurf für einen bestimmten Interessenten in die Warteschlange. Der Interessent muss sich in einem entwurfsfähigen Status befinden (nicht bereits entworfen oder aktiv).
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
prospect_id |
string | Ja | Interessent, für den recherchiert und ein Entwurf erstellt werden soll |
Gibt zurück: Bestätigung, dass die Recherche in die Warteschlange gestellt wurde.
Erfordert: mcp_write-Bereich.
outreach_list_pending_drafts
Listet entworfene Nachrichten auf, die auf Genehmigung warten, optional nach Kampagne gefiltert. Gibt bis zu 25 Entwürfe zurück.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
campaign_id |
string | Nein | Auf eine bestimmte Kampagne filtern |
Gibt zurück: Array von Entwürfen mit ID, Kampagnenname, Interessentenname, Betreff, Text-Vorschau (200 Zeichen) und created_at.
Hilfs-Tools
echo
Testet die MCP-Konnektivität. Gibt Ihre Nachricht mit Kontokontext zurück.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
message |
string | Ja | Nachricht zum Zurücksenden |
Gibt zurück: Ihre Nachricht, Kontoname, Benutzer-E-Mail, Bereiche und Zeitstempel.
search_docs
Durchsucht die Kit-Produktdokumentation. Nützlich, wenn Sie den Assistenten fragen, wie eine Funktion funktioniert.
Parameter:
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
query |
string | Ja | Wonach gesucht werden soll |
Gibt zurück: Übereinstimmende Dokumentationsseiten mit Titel, Kategorie und Inhalt.
get_plans
Ruft aktuelle Preismodelle mit Funktionen, Preisdetails und Abrechnungsinformationen ab.
Parameter: Keine
Gibt zurück: Array von Plänen mit Name, Beschreibung, Preis, Währung, Intervall, Pro-Sitz-Flag, Testtagen und Funktionsliste.
Berechtigungsübersicht
| Tool | Erforderlicher Bereich | Schreibzugriff? | Hinweise |
|---|---|---|---|
echo |
— | Nein | |
search_docs |
— | Nein | |
get_plans |
— | Nein | |
hiring_get_setup_guide |
mcp |
Nein | |
hiring_list_templates |
mcp |
Nein | |
hiring_get_template |
mcp |
Nein | |
hiring_create_process_template |
mcp |
Ja | Erfordert aktives Abonnement |
hiring_list_job_postings |
mcp |
Nein | |
hiring_get_job_posting |
mcp |
Nein | |
hiring_create_job_posting |
— | Ja | Nur integrierter Chatbot; erfordert aktives Abonnement |
hiring_list_applications |
mcp |
Nein | |
hiring_get_application_summary |
mcp |
Nein | |
hiring_get_stage_details |
mcp |
Nein | |
hiring_advance_application |
mcp_write |
Ja | |
hiring_reject_application |
mcp_write |
Ja | |
hiring_list_reviews |
mcp |
Nein | |
hiring_get_review_details |
mcp |
Nein | |
hiring_list_talent_pool |
mcp |
Nein | |
hiring_search_talent_pool |
mcp |
Nein | |
hiring_invite_talent_pool |
mcp_write |
Ja | |
hiring_search_video_transcripts |
mcp |
Nein | |
team_list_members |
mcp |
Nein | |
team_list_invitations |
mcp |
Nein | |
team_invite_member |
mcp_write |
Ja | Nur Admin; erfordert aktives Abonnement |
outreach_list_campaigns |
mcp |
Nein | Erfordert Outreach-Add-on |
outreach_get_campaign |
mcp |
Nein | Erfordert Outreach-Add-on |
outreach_add_prospect |
mcp_write |
Ja | Erfordert Outreach-Add-on |
outreach_draft_email |
mcp_write |
Ja | Erfordert Outreach-Add-on |
outreach_list_pending_drafts |
mcp |
Nein | Erfordert Outreach-Add-on |
Alle Tools sind auf Ihr verbundenes Konto beschränkt. Ein Assistent kann niemals Daten eines anderen Kontos sehen oder ändern.