{"server":{"name":"yugatek-portal","url":"https://portal.yugatek.net/api/mcp","transport":"streamable-http"},"authentication":{"oauth":"https://portal.yugatek.net/.well-known/oauth-protected-resource","personalToken":"Authorization: Bearer yt_pat_…"},"counts":{"all":30,"read":24,"write":6},"tools":[{"name":"list_jobs","title":"List jobs","kind":"read","readOnly":true,"description":"Lists the workspace's jobs with status, applicant counts and whether each is actively hiring.","parameters":{"type":"object","properties":{"status":{"type":"string","enum":["Open","Draft","Closed"],"description":"Only jobs with this status."},"query":{"type":"string","maxLength":120,"description":"Only jobs whose title contains this text."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"How many rows to return, 1 to 100. Default 25."},"cursor":{"type":"string","minLength":1,"maxLength":64,"description":"The nextCursor of the previous page, to get the next page. Leave out for the first page."}},"additionalProperties":false}},{"name":"get_job","title":"Get a job","kind":"read","readOnly":true,"description":"Returns one job in full with its hiring team, screening questions and the number of applications in each stage.","parameters":{"type":"object","properties":{"jobId":{"type":"string","minLength":1,"maxLength":160,"description":"The job's id, from list_jobs."}},"required":["jobId"],"additionalProperties":false}},{"name":"list_candidates","title":"List candidates","kind":"read","readOnly":true,"description":"Lists candidates the user can reach with their current stage, skills and scores; can be filtered by job or text.","parameters":{"type":"object","properties":{"jobId":{"type":"string","minLength":1,"maxLength":160,"description":"Only candidates with an application for this job."},"query":{"type":"string","maxLength":120,"description":"Only candidates whose name, role, location or skills contain this text."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"How many rows to return, 1 to 100. Default 25."},"cursor":{"type":"string","minLength":1,"maxLength":64,"description":"The nextCursor of the previous page, to get the next page. Leave out for the first page."}},"additionalProperties":false}},{"name":"get_candidate","title":"Get a candidate","kind":"read","readOnly":true,"description":"Returns one candidate with their profile, applications and notes, limited to what the user's role may see.","parameters":{"type":"object","properties":{"candidateId":{"type":"string","minLength":1,"maxLength":160,"description":"The candidate's id, from list_candidates."}},"required":["candidateId"],"additionalProperties":false}},{"name":"list_applications","title":"List applications","kind":"read","readOnly":true,"description":"Lists applications with candidate, stage and outcome, as the Applications board shows them.","parameters":{"type":"object","properties":{"jobId":{"type":"string","minLength":1,"maxLength":160,"description":"Only applications for this job."},"stageKey":{"type":"string","minLength":1,"maxLength":60,"description":"Only applications in the stage with this key (for example applied, interview)."},"includeArchived":{"type":"boolean","description":"Include archived applications. Default false."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"How many rows to return, 1 to 100. Default 25."},"cursor":{"type":"string","minLength":1,"maxLength":64,"description":"The nextCursor of the previous page, to get the next page. Leave out for the first page."}},"additionalProperties":false}},{"name":"get_application","title":"Get an application","kind":"read","readOnly":true,"description":"Returns one application in full: candidate, job, stage, resume check, interviews, ratings, notes and messages, limited to what the user's role may see.","parameters":{"type":"object","properties":{"applicationId":{"type":"string","minLength":1,"maxLength":160,"description":"The application's id, from list_applications or list_candidates."}},"required":["applicationId"],"additionalProperties":false}},{"name":"list_bench","title":"List the bench","kind":"read","readOnly":true,"description":"Lists the people on a bench, with role families, when they were added and skills.","parameters":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"description":"How many rows to return, 1 to 100. Default 25."},"cursor":{"type":"string","minLength":1,"maxLength":64,"description":"The nextCursor of the previous page, to get the next page. Leave out for the first page."}},"additionalProperties":false}},{"name":"get_job_bench","title":"Rank the bench for a job","kind":"read","readOnly":true,"description":"Ranks the people on a bench by how well they match one job.","parameters":{"type":"object","properties":{"jobId":{"type":"string","minLength":1,"maxLength":160,"description":"The job's id."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"How many rows to return, 1 to 100. Default 25."},"cursor":{"type":"string","minLength":1,"maxLength":64,"description":"The nextCursor of the previous page, to get the next page. Leave out for the first page."}},"required":["jobId"],"additionalProperties":false}},{"name":"get_job_applicants","title":"Applicants and leads for a job","kind":"read","readOnly":true,"description":"Returns a job's applicants or leads ranked by the resume check, with shortlist state and vendor submission status.","parameters":{"type":"object","properties":{"jobId":{"type":"string","minLength":1,"maxLength":160,"description":"The job's id."},"list":{"type":"string","enum":["applicants","leads"],"description":"Which list to page through. Default applicants."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"How many rows to return, 1 to 100. Default 25."},"cursor":{"type":"string","minLength":1,"maxLength":64,"description":"The nextCursor of the previous page, to get the next page. Leave out for the first page."}},"required":["jobId"],"additionalProperties":false}},{"name":"list_vendors","title":"List vendors","kind":"read","readOnly":true,"description":"Lists the workspace's vendors with their open job and submission counts.","parameters":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"description":"How many rows to return, 1 to 100. Default 25."},"cursor":{"type":"string","minLength":1,"maxLength":64,"description":"The nextCursor of the previous page, to get the next page. Leave out for the first page."}},"additionalProperties":false}},{"name":"get_vendor","title":"Get a vendor","kind":"read","readOnly":true,"description":"Returns one vendor with its contact, submission method and counts.","parameters":{"type":"object","properties":{"vendorId":{"type":"string","minLength":1,"maxLength":160,"description":"The vendor's id, from list_vendors."}},"required":["vendorId"],"additionalProperties":false}},{"name":"list_interview_results","title":"List Interview IQ results","kind":"read","readOnly":true,"description":"Lists AI video interviews with status, candidate, job and scores.","parameters":{"type":"object","properties":{"status":{"type":"string","enum":["invited","started","completed","expired"],"description":"Only interviews with this status."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"How many rows to return, 1 to 100. Default 25."},"cursor":{"type":"string","minLength":1,"maxLength":64,"description":"The nextCursor of the previous page, to get the next page. Leave out for the first page."}},"additionalProperties":false}},{"name":"get_interview_result","title":"Get an Interview IQ result","kind":"read","readOnly":true,"description":"Returns one AI video interview in full: answers, scores and verdict.","parameters":{"type":"object","properties":{"interviewId":{"type":"string","minLength":1,"maxLength":160,"description":"The interview's id, from list_interview_results."}},"required":["interviewId"],"additionalProperties":false}},{"name":"list_inbox_threads","title":"List inbox threads","kind":"read","readOnly":true,"description":"Lists inbox conversations with candidates, newest first, with unread and starred flags.","parameters":{"type":"object","properties":{"filter":{"type":"string","enum":["all","unread","starred"],"description":"Default all."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"How many rows to return, 1 to 100. Default 25."},"cursor":{"type":"string","minLength":1,"maxLength":64,"description":"The nextCursor of the previous page, to get the next page. Leave out for the first page."}},"additionalProperties":false}},{"name":"get_inbox_thread","title":"Get an inbox thread","kind":"read","readOnly":true,"description":"Returns one inbox conversation with its messages in order.","parameters":{"type":"object","properties":{"threadId":{"type":"string","minLength":1,"maxLength":160,"description":"The thread's id, from list_inbox_threads."}},"required":["threadId"],"additionalProperties":false}},{"name":"get_calendar","title":"Get calendar events","kind":"read","readOnly":true,"description":"Returns interviews, follow-ups and busy times between two dates.","parameters":{"type":"object","properties":{"from":{"type":"string","maxLength":40,"description":"Start, ISO 8601 date or date-time. Default now."},"to":{"type":"string","maxLength":40,"description":"End, ISO 8601. Default 14 days after the start."},"scope":{"type":"string","enum":["mine","team","workspace"],"description":"Default mine."},"types":{"type":"array","items":{"type":"string","enum":["interview","followup","external"]},"maxItems":3,"description":"Default all three."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"How many rows to return, 1 to 100. Default 25."},"cursor":{"type":"string","minLength":1,"maxLength":64,"description":"The nextCursor of the previous page, to get the next page. Leave out for the first page."}},"additionalProperties":false}},{"name":"get_analytics_summary","title":"Get the analytics summary","kind":"read","readOnly":true,"description":"Returns the careers analytics insight summary for the last 7 or 30 days.","parameters":{"type":"object","properties":{"range":{"type":"number","enum":[7,30],"description":"Days: 7 or 30. Default 30."}},"additionalProperties":false}},{"name":"list_saved_searches","title":"List your saved searches","kind":"read","readOnly":true,"description":"Lists the user's saved searches for one list.","parameters":{"type":"object","properties":{"list":{"type":"string","enum":["candidates","bench","jobs","applications","pipeline","assessments","inbox","vendors","privacy","accounts"],"description":"Which list the searches belong to."}},"required":["list"],"additionalProperties":false}},{"name":"list_staffing_lookups","title":"List staffing lookups","kind":"read","readOnly":true,"description":"Lists the workspace's lookup values for vendors, implementation partners and clients.","parameters":{"type":"object","properties":{"kind":{"type":"string","enum":["vendor","implementation_partner","client"],"description":"Which list."},"query":{"type":"string","maxLength":240,"description":"Only names containing this text."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"How many rows to return, 1 to 100. Default 25."},"cursor":{"type":"string","minLength":1,"maxLength":64,"description":"The nextCursor of the previous page, to get the next page. Leave out for the first page."}},"required":["kind"],"additionalProperties":false}},{"name":"list_todos","title":"List to-dos","kind":"read","readOnly":true,"description":"Lists the user's to-dos, open first, or every to-do on one candidate.","parameters":{"type":"object","properties":{"candidateId":{"type":"string","minLength":1,"maxLength":160,"description":"Only to-dos on this candidate."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"How many rows to return, 1 to 100. Default 25."},"cursor":{"type":"string","minLength":1,"maxLength":64,"description":"The nextCursor of the previous page, to get the next page. Leave out for the first page."}},"additionalProperties":false}},{"name":"get_review_queue","title":"Get the review queue","kind":"read","readOnly":true,"description":"Returns the candidates that need the user's attention, as the Review queue shows them.","parameters":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"description":"How many rows to return, 1 to 100. Default 25."},"cursor":{"type":"string","minLength":1,"maxLength":64,"description":"The nextCursor of the previous page, to get the next page. Leave out for the first page."}},"additionalProperties":false}},{"name":"search","title":"Search the portal","kind":"read","readOnly":true,"description":"Searches jobs, candidates and inbox threads by text.","parameters":{"type":"object","properties":{"q":{"type":"string","minLength":2,"maxLength":120,"description":"What to look for: a title, a name, an email, a subject."}},"required":["q"],"additionalProperties":false}},{"name":"list_candidate_documents","title":"List a candidate's documents","kind":"read","readOnly":true,"description":"Lists which verification documents a candidate has on file, by kind, file name and date. Never the files themselves.","parameters":{"type":"object","properties":{"candidateId":{"type":"string","minLength":1,"maxLength":160,"description":"The candidate's id."}},"required":["candidateId"],"additionalProperties":false}},{"name":"check_vendor_submission","title":"Check a vendor submission","kind":"read","readOnly":true,"description":"Checks whether a candidate has the documents a vendor submission needs and lists what is missing (partner-specific document rules apply).","parameters":{"type":"object","properties":{"applicationId":{"type":"string","minLength":1,"maxLength":160,"description":"The application to check, from list_applications."}},"required":["applicationId"],"additionalProperties":false}},{"name":"create_job","title":"Create a job (Draft)","kind":"write","readOnly":false,"description":"Creates a new job as a Draft; publishing stays with owners and admins.","parameters":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":200,"description":"The job title."},"department":{"type":"string","maxLength":120,"description":"Department."},"location":{"type":"string","maxLength":200,"description":"Location, for example \"Austin, TX\" or \"Remote\"."},"employment":{"type":"string","maxLength":60,"description":"Employment type, for example Full-time or Contract."},"pitch":{"type":"string","maxLength":600,"description":"One or two sentences that sell the role."},"description":{"type":"string","maxLength":20000,"description":"The job description."},"requirements":{"type":"array","items":{"type":"string","minLength":1,"maxLength":300},"maxItems":40,"description":"Must-have requirements, one per entry."},"niceToHave":{"type":"array","items":{"type":"string","minLength":1,"maxLength":300},"maxItems":40,"description":"Nice-to-have lines, one per entry."},"salaryMin":{"type":"integer","minimum":0,"description":"Minimum salary, whole number in the workspace currency."},"salaryMax":{"type":"integer","minimum":0,"description":"Maximum salary, whole number in the workspace currency."},"contractType":{"type":"string","maxLength":40,"description":"W2, C2C or Fulltime."},"activelyHiring":{"type":"boolean","description":"Mark the job as actively hiring. Needs the actively hiring permission."}},"required":["title"],"additionalProperties":false}},{"name":"set_job_status","title":"Open, close or draft a job","kind":"write","readOnly":false,"description":"Sets a job's status to Open, Draft or Closed. Owners and admins only.","parameters":{"type":"object","properties":{"jobId":{"type":"string","minLength":1,"maxLength":160,"description":"The job's id, from list_jobs."},"status":{"type":"string","enum":["Open","Draft","Closed"],"description":"The new status."}},"required":["jobId","status"],"additionalProperties":false}},{"name":"set_job_actively_hiring","title":"Mark a job actively hiring","kind":"write","readOnly":false,"description":"Turns a job's actively hiring flag on or off.","parameters":{"type":"object","properties":{"jobId":{"type":"string","minLength":1,"maxLength":160,"description":"The job's id."},"activelyHiring":{"type":"boolean","description":"true to mark the job as actively hiring, false to clear it."}},"required":["jobId","activelyHiring"],"additionalProperties":false}},{"name":"add_to_bench","title":"Add a candidate to a bench","kind":"write","readOnly":false,"description":"Adds a candidate to a bench for a role family, optionally for one job.","parameters":{"type":"object","properties":{"candidateId":{"type":"string","minLength":1,"maxLength":160,"description":"The candidate's id."},"roleFamily":{"type":"string","enum":["java","dotnet","datasci","python","fullstack","qa","sre","devops","cloud","genai","dataeng","dba","privacy","security","workday","salesforce","servicenow","gis","insurance","product","ba","pm","other"],"description":"The role family bench: java, dotnet, datasci, python, fullstack, qa, sre, devops, cloud, genai, dataeng, dba, privacy, security, workday, salesforce, servicenow, gis, insurance, product, ba, pm, other."},"jobId":{"type":"string","minLength":1,"maxLength":160,"description":"A job this bench entry is for (optional)."}},"required":["candidateId","roleFamily"],"additionalProperties":false}},{"name":"request_candidate_documents","title":"Request documents from a candidate","kind":"write","readOnly":false,"description":"Asks a candidate for documents by email and WhatsApp with a secure 7-day upload link.","parameters":{"type":"object","properties":{"candidateId":{"type":"string","minLength":1,"maxLength":160,"description":"The candidate's id."},"items":{"type":"array","items":{"type":"string","enum":["dl","visa","i94","workAuth"]},"minItems":1,"maxItems":4,"description":"Which documents to ask for: dl, visa, i94, workAuth."},"applicationId":{"type":"string","minLength":1,"maxLength":160,"description":"The application the request is about. Default: the candidate's newest."},"message":{"type":"string","maxLength":2000,"description":"A short plain-text note to the candidate."},"includeJobLink":{"type":"boolean","description":"Include the job's public link. Default true."}},"required":["candidateId","items"],"additionalProperties":false}},{"name":"submit_to_vendor","title":"Submit a candidate to the job's vendor","kind":"write","readOnly":false,"description":"Submits a candidate to the job's vendor with the chosen documents attached; partner-specific document rules apply.","parameters":{"type":"object","properties":{"applicationId":{"type":"string","minLength":1,"maxLength":160,"description":"The application to submit."},"documents":{"type":"array","items":{"type":"string","enum":["dl","visa","i94","workAuth"]},"maxItems":4,"description":"Which of the candidate's documents on file to attach: dl, visa, i94, workAuth."},"note":{"type":"string","maxLength":1000,"description":"An optional note for the vendor."}},"required":["applicationId","documents"],"additionalProperties":false}}]}