# Breezy HR MCP for AI Agents AI Agent Connect

> Breezy HR MCP lets you manage your entire hiring pipeline from your AI client. You can create job postings, add new applicants, move people through different interview stages, and pull company data without leaving your chat or editor. It turns your AI agent into a dedicated talent acquisition assistant for your team.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_4zVtNCxEF6KNMvLuYZ4zsdtHnd6WCLsZNdMpic5L/ai-agent-connect
- **Tags:** hiring-pipeline, candidate-management, job-postings, talent-acquisition, applicant-tracking, recruitment-workflow

## Description

Imagine you're in the middle of a busy hiring season. Usually, you're jumping between tabs, copy-pasting candidate names from emails into a spreadsheet, and manually updating statuses in a dashboard. With this Connector, you just tell your AI agent what to do. You can ask it to pull up a list of everyone who applied for the Senior Developer role or move a specific person to the Interview stage instantly. It handles the heavy lifting of data entry and status tracking so you can focus on actually talking to people. Because it's part of the Vinkius catalog, you can get this connected in minutes and start using it alongside your other tools. It's about making the administrative side of HR feel like a conversation rather than a chore. You get a clear view of your open positions and task templates without having to navigate complex menus. It's your hiring workflow, just much faster and more direct. You can see who is where in your pipeline and get the details you need to make a hiring decision without the friction of a traditional dashboard.

## Tools

### list_candidates
See a full list of people who applied for a certain job. This helps you get a bird's-eye view of your applicant pool.

### list_positions
Pull a list of every job position you have active or in draft. Use this to see your entire hiring scope at once.

### list_stages
See the different stages in a position's pipeline. This helps you understand the flow of your hiring process.

### list_task_templates
See all the task templates available in your workspace. Use this to quickly reference your standard hiring steps.

### create_candidate
Add a new applicant to a specific job opening. This helps you keep your pipeline updated as new people apply.

### create_position
Set up a new job posting in your Breezy HR account. Use this to quickly launch new hiring initiatives.

### get_candidate
Pull up the full details for a specific applicant. This makes it easy to review a person's history before an interview.

### get_company
Retrieve your authenticated company's information. Use this to get high-level data about your workspace.

### get_position
Get the specific details of a single job listing. This is useful for reviewing requirements for a specific role.

### move_candidate
Shift an applicant to a different stage in the pipeline. This is the primary way to update a candidate's status.

## Prompt Examples

**Prompt:** 
```
Show me all the candidates who applied for the Senior Developer role.
```

**Response:** 
```
I've pulled the list for the Senior Developer position. Here are the current applicants:

| Name | Status | Source |
| :--- | :--- | :--- |
| John Doe | Applied | LinkedIn |
| Sarah Smith | Sourced | Referral |
| Mike Jones | Interviewing | Indeed |

Would you like to see the full history for any of them?
```

**Prompt:** 
```
Move the candidate with ID cand_99 to the Technical Screen stage.
```

**Response:** 
```
Done. I've moved candidate **cand_99** to the **Technical Screen** stage in your Breezy HR pipeline. Is there anything else you need to do for this applicant?
```

**Prompt:** 
```
What are my current open job positions?
```

**Response:** 
```
You currently have 4 active job positions:

*   **Senior Developer** (ID: pos_1)
*   **Product Manager** (ID: pos_2)
*   **Sales Executive** (ID: pos_3)
*   **UX Designer** (ID: pos_4)

Let me know if you'd like me to pull the specific candidate list for any of these.
```

## Capabilities

### Create new job postings
Add a new job position to your active hiring list through your AI client.

### Add new applicants
Register a new candidate for a specific job opening instantly.

### Move candidates through stages
Shift applicants to different pipeline stages like Interview or Offer.

### Pull candidate histories
Retrieve the full history and details for any specific applicant.

### View all open positions
List every active and draft job position in your Breezy HR account.

### Access company templates
Get your company information and task templates directly in your chat.

## Use Cases

### Moving a candidate after a call
A recruiter finishes a phone screen and tells the agent to move the applicant to the Technical Interview stage using move_candidate.

### Checking the applicant pool
A hiring manager asks the agent to list all candidates for the Product Manager role to see who is currently in the Sourced stage.

### Launching a new role
A Talent Ops lead asks the agent to create a new position for Sales Executive and then asks to see the available task templates.

### Quick candidate research
A manager needs to know the background of a specific applicant and uses get_candidate to see their history before a meeting.

## Benefits

- Stop manual status updates by using move_candidate to shift applicants through your pipeline instantly.
- Get a bird's-eye view of your hiring needs by using list_positions to see all active and draft jobs.
- Spend less time on data entry by using create_candidate to add new applicants directly via chat.
- Quickly review applicant history with get_candidate to prepare for interviews without switching tabs.
- Access your company's task templates and info with list_task_templates and get_company for consistent hiring.
- Monitor your entire hiring flow by using list_stages to see exactly how candidates move through your process.

## How It Works

The bottom line is you stop manual data entry and start managing your hiring pipeline through simple chat commands.

1. Subscribe to the Breezy HR MCP on the Vinkius Marketplace.
2. Enter your Breezy HR API Key and Company ID in your AI client settings.
3. Ask your agent to list candidates, create positions, or move applicants.

## Frequently Asked Questions

**Can I use Breezy HR MCP to update my hiring pipeline?**
Yes. You can use it to move candidates through different stages like Interview or Offer using simple chat commands.

**Does Breezy HR MCP work with Cursor and Claude?**
Yes. It works with any MCP-compatible client, including Claude, Cursor, and Windsurf.

**How do I add a new applicant using Breezy HR MCP?**
You just tell your AI agent to add a new candidate to a specific job position, and it handles the entry for you.

**Can I see my company's task templates with this?**
Yes. You can retrieve your company's task templates instantly to see what steps are required for your hiring process.

**Is Breezy HR MCP good for high-volume recruiting?**
Yes. It is designed to help you manage high volumes of candidates by automating the status updates and data retrieval.

**Can I see all my open jobs at once?**
Yes. The Connector can pull a complete list of every active and draft job position in your Breezy HR account.

**Can I move a candidate to a new stage using the agent?**
Yes! Use the `move_candidate` tool with the Position ID, Candidate ID, and the target Stage ID. Your agent will update the pipeline status in Breezy HR instantly.

**How do I list all the candidates for a specific job?**
Simply ask the agent to `list_candidates` and provide the Position ID. It will retrieve the current applicants and their primary details.

**Does the integration allow creating a new job position?**
Yes. Use the `create_position` action and provide the name, description, and job type. The position will be created in your account as a draft or published based on your settings.