# Breezy HR MCP > Breezy HR MCP connects your AI agent directly to your entire talent acquisition workflow. Use it to track job positions, manage candidate profiles from initial application through interview stages, and move applicants through your pipeline using natural conversation. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** hiring-pipeline, candidate-management, job-postings, talent-acquisition, applicant-tracking, recruitment-workflow ## Description Connect this MCP to any compatible client to take control of hiring processes without clicking through dashboards. You can ask your agent to get a list of all active jobs or pull up detailed records for specific candidates. Need to update someone's status? Your agent handles that, moving an applicant from one stage to the next in the pipeline. It even pulls necessary administrative data, like company details and task templates. When you subscribe through Vinkius, your AI client gains access to this entire set of tools, letting you manage every step of candidate sourcing and placement right from a chat window. ## Tools ### create_candidate Adds a new applicant profile linked to a specific job opening. ### create_position Builds and saves an entirely new job listing within your company's system. ### get_candidate Pulls the full, detailed record for one specific applicant. ### get_company Retrieves fundamental details about your company's account setup. ### get_position Gets all the metadata and core details for one specific job opening. ### list_candidates Generates a list of every candidate who applied to a given position. ### list_positions Returns a comprehensive list of all job positions, active or draft. ### list_stages Shows the defined steps and stages in your hiring pipeline for any role. ### list_task_templates Displays all pre-built task templates available to your team. ### move_candidate Changes an applicant's status by moving them into a different pipeline stage. ## Prompt Examples **Prompt:** ``` List all active job positions in Breezy HR. ``` **Response:** ``` I've retrieved your positions. You have 3 active jobs: 'Senior Developer' (ID: pos_1), 'Product Manager' (ID: pos_2), and 'Sales Exec' (ID: pos_3). ``` **Prompt:** ``` Show the candidates for the 'Senior Developer' role. ``` **Response:** ``` Retrieving candidates for 'Senior Developer'... I found 5 applicants, including John Doe (Applied) and Sarah Smith (Sourced). Which one would you like to inspect? ``` **Prompt:** ``` Move candidate cand_123 to the 'Interview' stage. ``` **Response:** ``` Candidate cand_123 has been successfully moved to the 'Interview' stage in your Breezy HR pipeline. ``` ## Capabilities ### View Job Openings and Company Data Get metadata for all active job positions or retrieve core company information directly. ### Manage Candidate Profiles Create new applicant records, get details on specific candidates, or list all applicants connected to a single job role. ### Coordinate the Hiring Pipeline List pipeline stages for any position and move an existing candidate record into a different stage with a simple command. ## Use Cases ### Need to check a candidate's status before calling them. A recruiter needs to know if John Doe moved past the initial screen. Instead of opening his profile, they prompt their agent: 'Get details for John Doe.' The agent runs get_candidate and reports back his current stage instantly. ### Launching a new role requires immediate tracking. A hiring manager defines a brand-new job opening. They use create_position to set it up, then prompt the agent to list_stages so they know exactly what pipeline steps need to be documented. ### Batch updating multiple applicants after an interview. The team just finished a round of interviews. The recruiter uses move_candidate repeatedly: 'Move candidate X to Interview' and then 'Move candidate Y to Offer Stage,' completing the updates without touching the web app. ### Getting an overview of all available roles for Q3. A talent operations specialist needs a full count. They prompt: 'List all open job positions.' The agent runs list_positions and gives them the current count and ID for every active role. ## Benefits - Stop digging through dashboards. Use your agent to list all job positions or pull detailed records for a specific applicant using get_position or get_candidate, giving you instant visibility. - Keep the pipeline flowing smoothly. When you move an applicant's status using move_candidate, you don't have to log into Breezy HR; your agent does it for you in one chat command. - Onboarding new roles is faster. You can use create_position to build out a job opening and then immediately use list_task_templates to see what follow-up actions are needed. - Never lose track of who applied where. Instead of manually tracking, your agent lets you list_candidates for a specific position so you know exactly how many people are in the funnel. - Get context instantly. Before talking about candidates, use get_company to pull up foundational company data, making sure all follow-up communication is accurate. ## How It Works The bottom line is you manage your entire talent pipeline using plain conversation, never opening a web dashboard again. 1. First, subscribe to this MCP in Vinkius and enter your Breezy HR API Key and Company ID. 2. Second, connect your preferred AI client or agent to the newly added connection within your platform. 3. Third, use natural language prompts—like 'List all open jobs' or 'Move candidate X to Interview stage'—and let your agent execute the necessary actions. ## Frequently Asked Questions **How do I start a new job role using the Breezy HR MCP?** You use create_position to build out the job listing in your system. This is the first step, as it gives you an official position ID that other tools will reference. **What if I need to see all the stages for a new role?** Run list_stages for that specific position using its ID. This confirms your full hiring pipeline steps are correctly set up before you start adding candidates. **Can I update multiple people's statuses at once with Breezy HR MCP?** Yes, by making consecutive requests to move_candidate for each person. You can instruct your agent to process a list of IDs and change their status systematically. **Does the Breezy HR MCP only work if I already have candidates?** No. If you need to start fresh, use create_candidate to add new people to a position before any action is taken on them.