# Wizehire MCP MCP > Wizehire connects your ATS directly to your AI agent, giving it full control over managing applicant pipelines, job postings, and team roles without leaving your workflow. Use this MCP to list candidates, check technical requirements for jobs, or move applicants between hiring stages with simple conversation prompts. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** hiring-platform, candidate-tracking, job-postings, applicant-tracking, disc-assessment, recruitment-pipeline ## Description Managing talent acquisition usually means jumping between five different tabs: the job board, the CRM, the calendar, the salary band sheet, and the internal team roster. It’s a massive headache that forces you to copy-paste data constantly. This MCP lets your AI agent do the heavy lifting. Instead of searching through menus, you talk to your client—Claude, Cursor, or any compatible app—and tell it what needs doing. You can ask for all active job openings and immediately get details on specific technical requirements. Need to move a promising applicant from 'Interview' to 'Hired'? Just prompt the agent with the candidate ID and the new stage. It’s about workflow continuity. The real power comes when you chain this MCP with other systems; for example, having your AI agent read candidate data here, then automatically send an outreach message via a messaging platform, or trigger a billing record update. This cross-MCP chaining capability is what makes Vinkius the hub that keeps everything running in one place. ## Tools ### check_api_health Tests if your connection to Wizehire is active and working correctly. ### create_new_candidate Adds a new person to the candidate database using just their name and email address. ### get_candidate_details Retrieves all known information for one specific applicant. ### get_current_user Pulls the profile data of the person currently logged into Wizehire. ### get_job_details Retrieves all specific information about a single job posting. ### list_active_job_postings Lists every job opening that is currently live and accepting applications. ### list_candidates Generates a complete list of everyone who has ever applied to the company. ### list_configured_webhooks Shows a roster of automated alerts and webhooks that are set up in Wizehire. ### list_hiring_stages Displays all the specific stages (like 'Screening' or 'Offer') defined for hiring within the company. ### list_hiring_team Lists all managers and members who are part of the internal recruiting team. ### list_office_locations Provides a list of all physical business office locations managed by Wizehire. ### update_candidate_hiring_stage Changes an applicant’s status to move them between defined hiring stages. ## Prompt Examples **Prompt:** ``` List my active job postings in Wizehire. ``` **Response:** ``` I've retrieved 3 active job postings, including 'Senior Project Manager' and 'Sales Executive'. Would you like the details for any of them? ``` **Prompt:** ``` Show the latest candidates for the 'Sales Executive' role. ``` **Response:** ``` Fetching applicants... I've found 5 recent candidates for the Sales Executive role. Notable ones include John Doe (DISC+: High D). Should I pull his full profile? ``` ## Capabilities ### List all job openings Retrieves a list of every active job posting currently configured in Wizehire. ### Get candidate profiles Pulls specific details for any single applicant, including their assessment data and contact info. ### Update hiring status Moves a specified candidate to a different stage in the recruitment pipeline (e.g., from 'Applied' to 'Interview'). ### Add new applicants Manually creates a record for a new person into the candidate pool using their name and email. ### Check team structure Lists all current hiring managers and active members of the recruiting team. ## Use Cases ### A candidate needs a full history review. The hiring manager wants to know everything about John Doe, including his DISC+ assessment scores and current stage. Instead of searching by name and clicking through pages, the agent runs `get_candidate_details` and hands over the whole profile in one response. ### A new job needs a clear structure. The Product Manager launches a new role but forgets to define the next steps. They prompt the agent, which runs `list_hiring_stages`, showing them exactly what stages are available and if they need to add a new one. ### A team member leaves, and their tasks must be reassigned. The HR lead needs to know who is on the team. They run `list_hiring_team` to get the roster and check for any open roles by calling `list_active_job_postings`. ### A candidate was found via a new channel. The recruiter finds an excellent pass-through contact. They use the agent to run `create_new_candidate`, adding the person's basic info and immediately tagging them for review. ## Benefits - Stop switching tabs. Instead of navigating to the ATS UI to get a profile, just ask your agent for `get_candidate_details` and pull the data directly into your current chat window. - Automate status changes. You don't need to click 'Move Candidate.' Just tell your agent to run `update_candidate_hiring_stage`, and it executes the change instantly, keeping records accurate. - Full visibility on job needs. Use `list_active_job_postings` to see exactly which roles are live, along with their technical requirements, so you never miss a detail. - Build better automations. Combine this MCP's candidate data with a billing system via cross-MCP chaining in Vinkius to create fully automated onboarding workflows. - Maintain team oversight. Quickly run `list_hiring_team` or check your office locations using `list_office_locations` without logging into the main dashboard. ## How It Works The bottom line is that you tell your AI client what to do; it handles all the API interaction and returns a simple answer. 1. Subscribe to this MCP, then paste your Wizehire API Key into your client's settings. 2. Start by asking your agent a question, like 'What are our active job postings?' 3. The agent calls the necessary functions and presents you with clean data or confirms the action was taken. ## Frequently Asked Questions **How do I check if the Wizehire API key works using `check_api_health`?** Running `check_api_health` simply verifies that your connection credentials are valid and that the MCP can talk to Wizehire's main system. If it returns a success code, you’re good to go. **What data does `get_candidate_details` return?** `get_candidate_details` pulls everything known about one applicant—contact information, their profile history, and assessment scores. It's the deep dive on a single person. **How do I use `update_candidate_hiring_stage`?** You provide the candidate's ID and the name of the stage you want them moved to (e.g., 'Interview'). The agent executes this move, updating their official status in Wizehire. **Can I list all my current job postings using `list_active_job_postings`?** Yep. Running `list_active_job_postings` gives you a clean, current roster of every role that's open and accepting applicants right now. **What data must I provide when using the `create_new_candidate` tool?** You need to supply a name and an email address. The tool requires these two specific fields to successfully add a new candidate record into your Wizehire system. **How do I find out what the official hiring stages are using `list_hiring_stages`?** It returns an accurate list of all defined hiring stages in your account. This lets you confirm which statuses are valid for any candidate movement or automation process. **Does running `list_candidates` give me the full profile details, or just a summary?** It provides an overview list of all active candidates in your system. If you need specific data like assessment scores or contact history, you must call `get_candidate_details`. **Where can I check which external services are connected using `list_configured_webhooks`?** This tool gives a clear inventory of all active webhooks linked to your Wizehire account. You can use it to audit exactly what external systems receive data updates from the platform.