Docs › MCP tools

MCP tools

The YugaTek portal is an MCP server at https://portal.yugatek.net/api/mcp (Streamable HTTP). Sign in with OAuth or send a personal token as Authorization: Bearer yt_pat_…. Every tool runs with the signed-in person's role permissions, and every change is recorded in the activity log.

list_jobsread
Lists the workspace's jobs with status, applicant counts and whether each is actively hiring.
status? (Open | Draft | Closed) · query? · limit? (max 100) · cursor?
get_jobread
Returns one job in full with its hiring team, screening questions and the number of applications in each stage.
jobId
list_candidatesread
Lists candidates the user can reach with their current stage, skills and scores; can be filtered by job or text.
jobId? · query? · limit? (max 100) · cursor?
get_candidateread
Returns one candidate with their profile, applications and notes, limited to what the user's role may see.
candidateId
list_applicationsread
Lists applications with candidate, stage and outcome, as the Applications board shows them.
jobId? · stageKey? · includeArchived? · limit? (max 100) · cursor?
get_applicationread
Returns one application in full: candidate, job, stage, resume check, interviews, ratings, notes and messages, limited to what the user's role may see.
applicationId
list_benchread
Lists the people on a bench, with role families, when they were added and skills.
limit? (max 100) · cursor?
get_job_benchread
Ranks the people on a bench by how well they match one job.
jobId · limit? (max 100) · cursor?
get_job_applicantsread
Returns a job's applicants or leads ranked by the resume check, with shortlist state and vendor submission status.
jobId · list? (applicants | leads) · limit? (max 100) · cursor?
list_vendorsread
Lists the workspace's vendors with their open job and submission counts.
limit? (max 100) · cursor?
get_vendorread
Returns one vendor with its contact, submission method and counts.
vendorId
list_interview_resultsread
Lists AI video interviews with status, candidate, job and scores.
status? (invited | started | completed | expired) · limit? (max 100) · cursor?
get_interview_resultread
Returns one AI video interview in full: answers, scores and verdict.
interviewId
list_inbox_threadsread
Lists inbox conversations with candidates, newest first, with unread and starred flags.
filter? (all | unread | starred) · limit? (max 100) · cursor?
get_inbox_threadread
Returns one inbox conversation with its messages in order.
threadId
get_calendarread
Returns interviews, follow-ups and busy times between two dates.
from? · to? · scope? (mine | team | workspace) · types[]? (interview | followup | external) · limit? (max 100) · cursor?
get_analytics_summaryread
Returns the careers analytics insight summary for the last 7 or 30 days.
range? (7 | 30)
list_saved_searchesread
Lists the user's saved searches for one list.
list (candidates | bench | jobs | applications | pipeline | assessments | inbox | vendors | privacy | accounts)
list_staffing_lookupsread
Lists the workspace's lookup values for vendors, implementation partners and clients.
kind (vendor | implementation_partner | client) · query? · limit? (max 100) · cursor?
list_todosread
Lists the user's to-dos, open first, or every to-do on one candidate.
candidateId? · limit? (max 100) · cursor?
get_review_queueread
Returns the candidates that need the user's attention, as the Review queue shows them.
limit? (max 100) · cursor?
list_candidate_documentsread
Lists which verification documents a candidate has on file, by kind, file name and date. Never the files themselves.
candidateId
check_vendor_submissionread
Checks whether a candidate has the documents a vendor submission needs and lists what is missing (partner-specific document rules apply).
applicationId
create_jobwrite
Creates a new job as a Draft; publishing stays with owners and admins.
title · department? · location? · employment? · pitch? · description? · requirements[]? · niceToHave[]? · salaryMin? · salaryMax? · contractType? · activelyHiring?
set_job_statuswrite
Sets a job's status to Open, Draft or Closed. Owners and admins only.
jobId · status (Open | Draft | Closed)
set_job_actively_hiringwrite
Turns a job's actively hiring flag on or off.
jobId · activelyHiring
add_to_benchwrite
Adds a candidate to a bench for a role family, optionally for one job.
candidateId · roleFamily (java | dotnet | datasci | python | fullstack | qa | sre | devops | cloud | genai | dataeng | dba | privacy | security | workday | salesforce | servicenow | gis | insurance | product | ba | pm | other) · jobId?
request_candidate_documentswrite
Asks a candidate for documents by email and WhatsApp with a secure 7-day upload link.
candidateId · items[] (dl | visa | i94 | workAuth) · applicationId? · message? · includeJobLink?
submit_to_vendorwrite
Submits a candidate to the job's vendor with the chosen documents attached; partner-specific document rules apply.
applicationId · documents[] (dl | visa | i94 | workAuth) · note?