# HireVue MCP > HireVue connects your entire hiring pipeline directly into your AI agent. Manage candidate profiles, schedule interviews, and track job openings without opening a new tab or switching context. It handles everything from initial data capture to interview scheduling, letting you run full talent workflows through natural conversation. ## Overview - **Category:** video-conferencing - **Price:** Free - **Tags:** recruitment, hiring, interviewing, candidate-tracking, ats ## Description Stop juggling tabs when you're trying to manage candidates. Instead of navigating between an applicant tracking system (ATS) dashboard and your communication tool, this MCP lets you handle the entire hiring workflow right where you're working—in your agent chat. Need to pull up a person’s record? Just ask for their details. Want to schedule a follow-up interview with Jane Doe? It creates the invitation immediately. Even if a job role changes, you can list all available positions and get instant metadata on specific openings. This connectivity is hosted within the Vinkius catalog, giving your AI agent access to every step of your talent acquisition process without needing complex integrations or custom code. ## Tools ### cancel_interview Cancels a specific, existing interview invitation. ### create_candidate Generates and saves a brand new candidate profile record. ### create_interview Sends out a formal invitation for an interview between parties. ### get_candidate Retrieves all the stored details for a specific candidate ID. ### get_interview Checks the current status and details of an existing interview invitation. ### get_position Fetches complete metadata for a single, named job position. ### list_positions Outputs a list of all currently active and available job roles in the system. ### update_candidate Modifies existing information on a candidate's profile record. ## Prompt Examples **Prompt:** ``` List all available job positions in HireVue. ``` **Response:** ``` I've retrieved the available positions. You have active roles such as 'Senior Developer' (ID: pos_123) and 'Sales Lead' (ID: pos_456). Would you like details on a specific one? ``` **Prompt:** ``` Create a candidate: Jane Smith, jane.smith@example.com. ``` **Response:** ``` Candidate Jane Smith has been created successfully with ID 'cand_789'. I can now help you schedule an interview for her. ``` **Prompt:** ``` Get the details for position pos_123. ``` **Response:** ``` Fetching details for 'Senior Developer' (pos_123)... This position is active and currently has 12 associated interview templates. ``` ## Capabilities ### Build and maintain candidate profiles You can create new records for applicants, retrieve existing details, or update information on a person's file. ### Schedule and manage interviews The MCP creates interview invitations, checks current statuses, or cancels appointments instantly when needed. ### Review available job positions You can see a list of all open roles and pull up detailed information for any specific position ID. ## Use Cases ### Onboarding a new applicant after a call A recruiter just finished an initial phone screen with Alex Jones. Instead of opening the ATS, copying his email, and creating a record, they simply ask their agent: 'Create candidate for Alex Jones, jane.doe@example.com.' The `create_candidate` tool builds the full record instantly. ### Checking role details before talking to an HM A hiring manager needs to know if the 'Senior Developer' position is still open and what its requirements are. They ask their agent to `list_positions` first, then use `get_position` on the specific ID to get all necessary context. ### Cleaning up old scheduling data HR Operations realizes several interviews were canceled weeks ago and the records are cluttering the system. They tell their agent to check the status of a bunch of IDs using `get_interview`, then use `cancel_interview` on any that shouldn't exist anymore. ### Updating contact info for an existing candidate A recruiter finds out a promising lead changed their phone number. Instead of logging into the ATS to manually change it, they ask their agent to `update_candidate` with the new details, keeping everything in one flow. ## Benefits - Instantly capture new talent data. Instead of manually entering details, use `create_candidate` to generate and store a complete profile from simple chat inputs. - Keep your workflow contained. You never have to switch screens to manage scheduling; the agent handles both creating an invite (`create_interview`) and checking its status (`get_interview`). - Stay informed on job openings. Use `list_positions` when you need to quickly see what roles are active, or use `get_position` if you only know a specific ID. - Maintain data accuracy. Don't rely on spreadsheets for updates; use the `update_candidate` tool to ensure all personal details are current in the system of record. - Control your pipeline flow. Quickly cancel outdated appointments using `cancel_interview`, keeping both calendars and records clean. ## How It Works The bottom line is you manage every part of the recruiting process without opening a single new browser tab. 1. Subscribe to this MCP in Vinkius and enter your HireVue API Key and Base URL. 2. Connect the service to your preferred AI client (Cursor, Claude, etc.). 3. Tell your agent what you need—for example, 'Create a candidate for John Smith' or 'List all open positions'. ## Frequently Asked Questions **How do I use the HireVue MCP to create a candidate?** You invoke `create_candidate` by simply asking your agent to build the profile for you, providing name and email. The tool takes care of generating and saving the record. **Can I check if an interview is still active using get_interview?** Yes. If you ask the agent to `get_interview`, it pulls up the current status, confirming when the meeting was scheduled for or if it was already canceled. **What tool do I use to find out what jobs are open?** Run `list_positions`. This outputs a list of all active job roles. You can then ask to `get_position` for specific details on any role ID listed. **If I need to update an existing candidate, which tool is best?** Use the `update_candidate` tool. It lets you modify records like phone numbers or job titles without having to create a whole new entry for that person. **What should I do if I get an authentication error when using `get_position`?** The first step is verifying your Base URL and API Key. The MCP relies entirely on these credentials; double-check them against your HireVue developer dashboard to ensure the connection works before running any queries. **When using `create_interview`, what data fields are required for a successful invitation?** You must provide at least the candidate ID, the position ID, and concrete date/time parameters. The system needs these three specific pieces of information to generate a valid calendar entry. **Is `get_candidate` the best tool for reviewing a full history on an applicant?** Yes. `get_candidate` fetches not only the current profile details but also associated interaction records and updates tied to that specific candidate ID, giving you a full view of their journey. **If I try to cancel an interview with `cancel_interview` using an incorrect ID, what happens?** The MCP will return a clear error code. Your AI agent should be set up to recognize this specific failure and prompt the user to check or correct the provided identifier. **How do I check the status of a specific interview?** Simply use the `get_interview` tool with the specific Interview ID. The agent will retrieve the current status (e.g., 'Scheduled', 'Completed'), candidate info, and relevant timestamps. **Can I update a candidate's information after creation?** Yes. Use the `update_candidate` tool. You can modify the `firstName`, `lastName`, `email`, or `externalId` by providing the Candidate ID and the new values. **Is it possible to cancel an interview invitation via AI?** Yes, you can cancel an invitation using the `cancel_interview` tool. Just provide the Interview ID, and the agent will process the cancellation in HireVue.