# Breezy HR MCP for AI Agents AI Agent Connect

> Breezy HR connects your recruitment pipeline to your AI agent. Use it to list job openings, track candidate statuses, and add new applicants without leaving your chat interface. It turns your hiring data into an active workspace where you can query, update, and manage candidates using natural language.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_XUrNoGDyqtLAPAGGZESrJ36PhQURCWaIpEjzPRfb/ai-agent-connect
- **Tags:** recruitment, hiring, applicant-tracking, hr-management, candidate-sourcing

## Description

Managing a high-volume hiring pipeline usually means jumping between browser tabs, copy-pasting candidate names, and hunting for specific job IDs. It is a tedious cycle of context switching that slows down the actual work of finding talent. This Connector changes that by letting your AI agent do the heavy lifting for you. Instead of manually searching for who applied to a specific role, you can just ask your agent to pull up the history or check a candidate's current status. It handles the data fetching for companies, positions, and applicants so you can focus on the actual interviews and hiring decisions. It is one of the many integrations available in the Vinkius catalog that turns a static HR database into an active workspace. You get to stay in your flow while the agent handles the tedious data entry and status checks. You can move from looking at a broad list of openings to inspecting the specific details of a single position without ever clicking a button. It makes the data in Breezy HR accessible through natural language, meaning you can get answers about your pipeline as fast as you can type the question. You get to spend your time talking to people instead of hunting for records in a database. This is a practical way to move faster without adding more manual steps to your day. By connecting this to your AI client, you turn your HR platform into a searchable knowledge base.

## Tools

### list_candidates
Get a full list of people who applied for a specific position. Use this to quickly scan your applicant pool.

### list_companies
View all the companies you manage in Breezy HR. This gives you a high-level look at your entire portfolio.

### list_positions
Pull a list of all active job openings for a specific company. It's great for seeing what's currently live.

### add_candidate
Put a new person into a specific job position. This helps you move leads into the pipeline faster.

### get_candidate
Pull up the full profile for a specific applicant. Use this to see their contact info and history at a glance.

### get_company
Retrieve the details for a specific company in your account. It's the fastest way to get organizational info.

### get_position
Fetch the specifics for a job opening. This ensures you have the right job details when discussing roles.

### list_applications
See every application a specific person has submitted. This helps you track their journey across multiple roles.

## Prompt Examples

**Prompt:** 
```
Who applied for the Senior Developer role at Acme Corp?
```

**Response:** 
```
I've pulled the candidate list for the **Senior Developer** position at **Acme Corp**. Here is who is currently in the pipeline:

| Name | Status |
| :--- | :--- |
| Alice Smith | Interviewing |
| Bob Jones | Screening |
| Charlie Brown | New Application |

Would you like to see the full profile for any of these candidates?
```

**Prompt:** 
```
Show me the history for John Doe.
```

**Response:** 
```
I found the following applications for **John Doe**:

*   **Marketing Manager** (Company: Global Tech) - *Status: Rejected*
*   **Content Strategist** (Company: Global Tech) - *Status: Interviewing*

It looks like he has applied to two roles within Global Tech. Would you like to see the specific details for either one?
```

**Prompt:** 
```
Add a new candidate named Jane Smith with email jane@example.com to the Marketing Manager position.
```

**Response:** 
```
Successfully added **Jane Smith** to the **Marketing Manager** position. 

**Record Created:**
*   **Name:** Jane Smith
*   **Email:** jane@example.com
*   **Position:** Marketing Manager

Is there anything else you'd like to do with this candidate?
```

## Capabilities

### List job openings
Get a full list of active positions for any company in your account.

### Retrieve candidate profiles
Pull up specific candidate details and contact information instantly.

### Add new applicants
Put new leads into your hiring pipeline with a simple text command.

### View application history
Track every application a specific person has submitted across roles.

### Fetch company details
Get the organizational metadata for any company in your portfolio.

## Use Cases

### Quick candidate screening
A recruiter asks the agent to list candidates for the Senior Developer role at Acme Corp and then requests the contact details for the top three.

### Tracking multi-role applicants
A hiring manager wants to see if a specific candidate has applied to other roles in the company and uses the agent to pull their full history.

### Rapid lead entry
An HR admin adds five new leads from a career fair to the pipeline by telling the agent to add each candidate to the Marketing Manager position.

### Portfolio overview
A talent lead asks the agent to list all active positions across all companies to get a high-level view of the current hiring needs.

## Benefits

- Stop switching tabs by using the list_candidates tool to see your applicant pool instantly.
- Speed up data entry by using add_candidate to put new leads into the system without manual forms.
- Get a full view of a person's history across different roles using the list_applications tool.
- Keep your hiring data accurate by using get_position to pull exact job details for your team.
- Manage multiple brands easily by using list_companies to see your entire portfolio at once.

## How It Works

The bottom line is you can manage your entire recruitment pipeline through a natural conversation with your AI agent.

1. Subscribe to the Breezy HR MCP on Vinkius.
2. Enter your Breezy HR API Key into the configuration.
3. Ask your AI client to list candidates, add new leads, or fetch job details.

## Frequently Asked Questions

**Can I use the Breezy HR MCP to see my open jobs?**
Yes, you can ask your agent to list all active positions for any company in your account. It will provide a clean list of every job currently live.

**How do I add a new person to the hiring pipeline using this Connector?**
Just tell your agent to add a new candidate. You can provide their name and email, and the agent will put them into the specific position you designate.

**Can the AI see my candidate history?**
Yes, the Connector allows your agent to retrieve the full journey of a specific person, showing every application they have submitted across your various roles.

**Does this work with Claude or Cursor?**
Yes, this Connector is compatible with any AI client that supports the Model Context Protocol, including Claude, Cursor, and Windsurf.

**Can I manage multiple companies with the Breezy HR MCP?**
Absolutely. You can list all companies in your account and pull job positions or candidate data for any of them through a single conversation.

**Will this replace my Breezy HR login?**
No, this Connector connects your existing Breezy HR account to your AI agent. You still keep your account, but you gain a faster way to interact with the data.

**Can I see the full details of a specific candidate using their ID?**
Yes! Use the `get_candidate` tool by providing the Company ID, Position ID, and Candidate ID. The agent will return all available profile information and metadata for that candidate.

**How do I list all open job positions for a specific company?**
Simply use the `list_positions` tool with the target Company ID. It will return a list of all job openings associated with that company account.

**Is it possible to add a new candidate to a position directly through the AI?**
Yes, you can use the `add_candidate` action. You'll need to provide the Company ID, Position ID, and the candidate's name (email is optional but recommended) to create the record.