Skip to main content
The Cutshort MCP server exposes five tools that an AI agent can call. Each tool maps to a Cutshort API operation. This reference covers each tool’s input schema, output shape, and example usage from an AI agent conversation.
Searches the Cutshort candidate pool by skills, experience, location, and quality score. Use this tool to find candidates that match a job’s requirements before creating a shortlist or sending invites.Input parameters
​
string
required
Comma-separated skill names to filter by. Example: "python,django,aws"
​
integer
Minimum years of experience the candidate must have.
​
integer
Maximum years of experience the candidate may have.
​
string
City name to filter by, or "Remote" for remote-only candidates. Example: "Bengaluru"
​
integer
Minimum Cutshort quality score (0–100). Candidates below this threshold are excluded.
​
string
Filter by job-seeking status. Accepted values: "active", "open", or "active,open".
​
integer
Page number for paginated results. Defaults to 1.
​
integer
Number of results to return per page. Maximum: 50.
Example
“Find senior Python engineers in Bengaluru with at least 5 years of experience”
Retrieves the full profile of a candidate by their Cutshort candidate ID. Use this tool after a search_candidates call when you need complete details — work history, education, skills, and contact preferences — for a specific candidate.Input parameters
​
string
required
The unique identifier of the candidate. Obtained from the id field in a search_candidates response. Example: "cand_8f3kL9mN"
Example
Creates a new job posting on Cutshort and activates AI candidate matching for that role. Once created, the job is immediately eligible for shortlist generation via get_shortlist.Input parameters
​
string
required
Job title displayed to candidates. Example: "Senior Backend Engineer"
​
string
required
A description of the role, responsibilities, and team context.
​
array
required
Array of skill names required for the role. Example: ["Python", "FastAPI", "PostgreSQL"]
​
integer
required
Minimum years of experience required for this role.
​
integer
Maximum years of experience considered for this role.
​
string
Primary city for the role. Example: "Mumbai"
​
string
Work arrangement. Accepted values: "onsite", "remote", or "hybrid".
​
integer
Minimum annual salary in INR (e.g., 2000000 for ₹20,00,000).
​
integer
Maximum annual salary in INR (e.g., 3000000 for ₹30,00,000).
Example
Retrieves the AI-generated candidate shortlist for a specific job. Cutshort’s matching engine ranks candidates by fit score based on the job’s required skills, experience range, location, and salary band.Input parameters
​
string
required
The unique identifier of the job. Obtained from the id field in a create_job response. Example: "job_4xRt2wPv"
​
integer
Maximum number of shortlisted candidates to return. Maximum: 50.
Example
Sends outreach invites to one or more candidates for a specific job. You can reach candidates over WhatsApp, email, or both channels simultaneously. Invite delivery and open status are tracked in the Cutshort dashboard.Input parameters
​
string
required
The unique identifier of the job for which the invite is being sent. Example: "job_4xRt2wPv"
​
array
required
Array of candidate IDs to invite. You can invite multiple candidates in a single call. Example: ["cand_8f3kL9mN", "cand_2pQr7sYk"]
​
string
Outreach channel to use. Accepted values: "whatsapp", "email", or "both". Defaults to "both".
Example
The MCP server returns structured JSON for all tool calls. Tool outputs match the corresponding REST API response schemas — see the API Reference for full field descriptions.