MCP Tools Reference
Complete reference for all MCP tools available to AI assistants — parameters, return data, and required permissions.
Why It Matters
When an AI assistant connects to your Kit account, it gets access to a set of tools. Each tool does one thing — list your job postings, fetch template details, invite a team member. This page documents every tool so you know what your AI assistant can and cannot do.
Getting Started
Every connected AI assistant sees this instruction first:
Start with
hiring_get_setup_guideto understand this account’s hiring capabilities, available templates, and current state.
The guide tool returns your account stats and available stage types, giving the assistant context before it takes any action.
Hiring Tools
Setup & Templates
hiring_get_setup_guide
Returns an overview of your hiring setup: template count, active job postings, total candidates, and all available stage types.
Parameters: None
Returns: Account name, quick stats, stage type descriptions, suggested next steps.
hiring_list_templates
Lists all hiring process templates available to your account — both system templates and custom ones you’ve created.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
tag |
string | No | Filter templates by tag |
published_only |
boolean | No | Only published templates (default: true) |
Returns: Array of templates with ID, name, tags, stage count, stage types, and usage count.
hiring_get_template
Returns full details of a specific template including every stage and its configuration.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
template_id |
integer | Yes | Template ID from hiring_list_templates |
Returns: Template metadata, ordered stages with type/config, and associated email templates.
hiring_create_process_template
Creates a hiring process template with the given stages. Returns the template name, stage count, and edit URL.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
name |
string | Yes | Template name (e.g. “Software Engineer Hiring”) |
stages |
array | Yes | Array of stage objects, each with name (string), type (string), optional config (object), and optional reviewers (array of {email, role}) |
description |
string | No | Short description of this template |
tags |
array | No | Tags for categorization |
Returns: Template ID, name, stage count, and edit URL.
Requires: Active subscription.
Job Postings
hiring_list_job_postings
Lists all job postings with status and application counts. Filter by status to narrow results.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
status |
string | No | draft, published, paused, closed, or active |
Returns: Array of postings with ID, title, department, location, status, stage count, application breakdown (total/active/rejected/withdrawn), and public URL if published.
hiring_get_job_posting
Returns everything about a specific job posting: stages with reviewer assignments, team members, and pipeline stats.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
job_posting_id |
integer | Yes | Job posting ID from hiring_list_job_postings |
Returns: Full posting details, stages with reviewer names, team members with roles, pipeline counts (total/active/rejected/withdrawn/offered).
hiring_create_job_posting
Creates a new job posting in draft status. Returns the edit URL so you can review and publish it in the browser.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
title |
string | Yes | Job title |
description |
string | Yes | Job description in markdown (do not include title) |
department |
string | No | Department name |
location |
string | No | Job location |
employment_type |
string | No | full_time, part_time, contract, or internship |
remote |
boolean | No | Remote position? |
process_template_id |
integer | No | Template ID to apply hiring stages |
salary_min |
integer | No | Minimum salary |
salary_max |
integer | No | Maximum salary |
salary_currency |
string | No | Currency code (e.g., USD, EUR) |
salary_period |
string | No | Period (e.g., year, month) |
Returns: New posting ID, title, status (always “draft”), and edit URL.
Requires: Active subscription.
Note: This tool is currently only available through the built-in AI chatbot, not external MCP clients.
Applications & Pipeline
hiring_list_applications
Lists submitted applications with optional date, status, and job posting filters. Use to see new applicants, pipeline breakdown by stage, or filter by date range.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
date_range |
string | No | this_week, last_week, this_month, last_month, last_7_days, or last_30_days |
since |
string | No | Custom start date (ISO 8601, e.g. 2025-01-01) |
until |
string | No | Custom end date (ISO 8601, e.g. 2025-01-31) |
status |
string | No | active, rejected, withdrawn, offered, or all (default: all) |
job_posting_id |
integer | No | Filter to a specific job posting |
Returns: Counts by status, breakdown by job posting and stage, and an array of applications with candidate name, email, job title, current stage, status, and submission time.
hiring_get_application_summary
Returns application-level context for screening: candidate info, current stage, full stage history with submissions, form responses, and quick field values.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
application_id |
integer | Yes | Application ID from hiring_list_reviews or hiring_list_applications |
Returns: Candidate details, job posting, application status, current stage, chronological stage history with submission summaries, form responses, and quick field values.
hiring_get_stage_details
Returns detailed, stage-type-specific information for a single stage progress. Includes offer details, interview scheduling, code assignment status, review aggregates, video recording info, and rich submission data. Use after hiring_get_application_summary to drill into a specific stage.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
stage_progress_id |
integer | Yes | Stage progress ID from hiring_get_application_summary stage history |
Returns: Stage metadata with status and timing, candidate and job posting context, all submissions, and stage-type-specific fields — offer terms, interview details, code assignment config, review aggregates, video recording config, questionnaire questions, or portfolio config depending on stage type.
hiring_advance_application
Advances an application to the next stage in the hiring pipeline, or to a specific stage if stage_id is provided. Notifications to the candidate and team are sent automatically.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
application_id |
integer | Yes | The application to advance |
stage_id |
integer | No | Advance to a specific stage (skips intermediate stages). If omitted, advances to the next stage in sequence. |
Returns: Application ID, candidate name, previous stage, new stage name and type.
Requires: mcp_write scope.
hiring_reject_application
Rejects an application. The candidate is notified by email (subject to the account’s rejection email delay setting). Always confirm with the user before rejecting.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
application_id |
integer | Yes | The application to reject |
reason |
string | No | Internal reason for the rejection (not shown to the candidate) |
Returns: Application ID, candidate name, job posting title, reason, and who rejected.
Requires: mcp_write scope.
Reviews
hiring_list_reviews
Returns your review inbox in three sections: applications needing screening, reviews in your queue, and your completed reviews.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
section |
string | No | screening, my_queue, or completed |
Returns: Three arrays (needs_screening, my_queue, completed_reviews) with candidate names, job titles, stage info, and wait times. Includes counts per section.
hiring_get_review_details
Returns everything a reviewer needs to evaluate a candidate at a specific stage: candidate info, submissions, scoring criteria, and other reviews (respecting blind-review visibility rules).
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
stage_progress_id |
integer | Yes | Stage progress ID from hiring_list_reviews |
Returns: Candidate info, job posting, stage details, all submissions (form responses, code, files, video, etc.), scoring criteria with weights, review progress, your review if any, and other reviews (when visible).
Talent Pool
hiring_list_talent_pool
Lists verified talent pool entries with compact resume extraction summaries. Paginated at 25 entries per page. Use hiring_search_talent_pool for filtering by skills or experience.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
page |
integer | No | Page number (default: 1, 25 entries per page) |
Returns: Total count, pagination info, and an array of entries with email, verification date, resume extraction summary, and creation date.
hiring_search_talent_pool
Searches the talent pool by skills, experience, or email using semantic and text search. Returns detailed resume extractions for matching entries.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
query |
string | Yes | Search query (skills, experience keywords, or email) |
limit |
integer | No | Maximum results (default: 10, max: 25) |
Returns: Matching entries with email, verification date, detailed resume extraction, and creation date.
hiring_invite_talent_pool
Invites a talent pool candidate to apply for a specific job posting. Sends an email with a prefilled application link.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
talent_pool_entry_id |
integer | Yes | Talent pool entry ID from hiring_list_talent_pool or hiring_search_talent_pool |
job_posting_id |
integer | Yes | Job posting ID from hiring_list_job_postings |
Returns: Invitation ID, candidate email, job title, who invited, and the invitation URL.
Requires: mcp_write scope.
Video
hiring_search_video_transcripts
Searches video interview transcripts by keywords using semantic and text search. Returns candidate info, video details, and relevant transcript excerpts.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
query |
string | Yes | Keywords to find in transcripts |
job_posting_id |
integer | No | Filter results to a specific job posting |
limit |
integer | No | Maximum results (default: 10, max: 20) |
Returns: Matching video transcripts with candidate info, video details, and relevant excerpts.
Team Tools
team_list_members
Lists all members of the current account with their roles.
Parameters: None
Returns: Array of members with name, email, roles, and owner flag.
team_list_invitations
Lists all pending invitations for the current account.
Parameters: None
Returns: Array of invitations with name, email, assigned roles, who invited, and when.
team_invite_member
Sends an invitation email to join your account. Only account admins can use this tool.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
email |
string | Yes | Email address to invite |
name |
string | Yes | Full name of the invitee |
admin |
boolean | No | Grant admin role (default: false) |
Returns: Confirmation with email, name, assigned role, and status.
Requires: mcp_write scope, admin role, and active subscription.
Utility Tools
echo
Tests MCP connectivity. Echoes your message back with account context.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
message |
string | Yes | Message to echo |
Returns: Your message, account name, user email, scopes, and timestamp.
search_docs
Searches Kit’s product documentation. Useful when you ask the assistant how a feature works.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
query |
string | Yes | What to search for |
Returns: Matching doc pages with title, category, and content.
get_plans
Retrieves current pricing plans with features, pricing details, and billing information.
Parameters: None
Returns: Array of plans with name, description, price, currency, interval, per-seat flag, trial days, and feature list.
Permissions Summary
| Tool | Scope Required | Write? | Notes |
|---|---|---|---|
echo |
— | No | |
search_docs |
— | No | |
get_plans |
— | No | |
hiring_get_setup_guide |
mcp |
No | |
hiring_list_templates |
mcp |
No | |
hiring_get_template |
mcp |
No | |
hiring_create_process_template |
mcp |
Yes | Requires active subscription |
hiring_list_job_postings |
mcp |
No | |
hiring_get_job_posting |
mcp |
No | |
hiring_create_job_posting |
— | Yes | Built-in chatbot only; requires active subscription |
hiring_list_applications |
mcp |
No | |
hiring_get_application_summary |
mcp |
No | |
hiring_get_stage_details |
mcp |
No | |
hiring_advance_application |
mcp_write |
Yes | |
hiring_reject_application |
mcp_write |
Yes | |
hiring_list_reviews |
mcp |
No | |
hiring_get_review_details |
mcp |
No | |
hiring_list_talent_pool |
mcp |
No | |
hiring_search_talent_pool |
mcp |
No | |
hiring_invite_talent_pool |
mcp_write |
Yes | |
hiring_search_video_transcripts |
mcp |
No | |
team_list_members |
mcp |
No | |
team_list_invitations |
mcp |
No | |
team_invite_member |
mcp_write |
Yes | Admin only; requires active subscription |
All tools are scoped to your connected account. An assistant can never see or modify data from a different account.