Breezy HR MCP for AI. Manage your full recruitment pipeline instantly.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
Breezy HR handles your entire recruitment pipeline directly through any AI agent. Use this MCP to list companies, track open positions, and manage candidate records instantly—all without leaving your chat window.
It lets you add new applicants, view application history, or fetch deep metadata for specific roles.
What your AI can do
Add candidate
Creates a brand-new candidate record and adds them to an existing job position.
Get candidate
Retrieves all personal details for a single, known candidate.
Get company
Pulls specific data points about one company by its ID.
Get specific information about any company in your roster.
Retrieve details for active job openings within a company or across the platform.
Add new candidates to your system, or pull up full profiles on existing applicants.
Get a list of people who fit the criteria for a specific job opening.
See every application and its status associated with one candidate.
Ask an AI about this
Waiting for input…
Breezy HR Alternative with 8 Tools
These tools let you interact with every part of the Breezy HR system—from listing all companies to adding new candidates.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Breezy HR on VinkiusAdd Candidate
Creates a brand-new candidate record and adds them to an existing job position.
Get Candidate
Retrieves all personal details for a single, known candidate.
Get Company
Pulls specific data points about one company by its ID.
Get Position
Fetches detailed information for a single job opening.
List Applications
Lists all historical applications made by a specific candidate across different...
List Candidates
Retrieves multiple candidates who are associated with a single job opening.
List Companies
Provides an overview of all companies tracked in your Breezy HR account.
List Positions
Lists every open job position available within a specific company.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token
from cloud.vinkius.com. For OAuth-protected servers, expand
Advanced settings to add credentials.
Start a conversation
Open a new chat. The Breezy HR integration is available immediately — no restart needed.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Breezy HR, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Breezy HR. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 8 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
The HR dashboard sprawl is exhausting.
Right now, finding a single candidate's full picture means clicking through company tabs, then position details, then finally opening the application history. It involves multiple screens, several clicks, and usually requires copy-pasting IDs just to keep track of what you found.
With this MCP, your agent handles all that complexity for you. You simply ask it for a candidate's full status or for open jobs in a specific company. The data comes back instantly, ready to read.
The Breezy HR Alternative MCP provides Applicant Management.
You no longer have to switch context to manually add new leads or track down which jobs are open. You can tell the agent to run `list_companies` and then immediately ask it to find positions within 'Global Tech'.
The bottom line is that your whole recruitment process flows from one chat window, making data lookup faster and less error-prone.
What your AI can actually do with this
You can connect your HR workflow directly to Breezy HR using this MCP. Instead of jumping between tabs and exporting spreadsheets, your AI agent handles the data retrieval naturally. Ask it to list all companies in your pipeline, then ask for open positions within 'Acme Corp.' You can also check a specific candidate's application history or add new applicants instantly with just names and emails.
Vinkius hosts this MCP so you connect once to manage recruiting across multiple services. This lets recruiters pull deep metadata on roles and people, giving them a clear picture of where the hiring process stands.
019e5d02-e1f7-731d-9604-38a96b0c89f9 
Here's how it actually works
The bottom line is you talk to your agent using plain language and it executes complex HR lookups through Breezy HR.
Subscribe to the MCP and input your Breezy HR API key.
Reference the connection in any compatible AI client, like Claude or Cursor.
Ask your agent for a specific action, such as 'List all companies' or 'Get details for candidate XYZ'.
Who is this actually for?
Recruiters who hate context switching. Hiring Managers who need quick status checks on candidates. Talent Acquisition Leads running multi-company pipelines.
Needs to list companies or open positions fast and pull candidate profiles without opening the main HR dashboard.
Wants to check a candidate’s full application history straight from their current project workflow, not through an internal portal.
Manages hiring across several companies and needs to automate the retrieval of recruitment metrics or add bulk new candidates.
What Changes When You Connect
Stop switching tabs. Instead of navigating through multiple dashboards, you can ask your agent to list open positions or fetch candidate details directly within your chat flow.
Save time on data aggregation. You don't need to manually check application records; the list_applications tool pulls a full history for any given candidate instantly.
Improve onboarding speed. Need to track down a company ID? Use list_companies first, then pull up all positions using list_positions, keeping your workflow moving.
Streamline data entry. When you find a promising lead, the agent can use add_candidate to input their name and contact details without ever leaving the chat window.
Gain deep visibility. Use get_company or get_position to fetch detailed metadata on roles and organizations, helping your team understand the hiring context better.
See it in action
The Pipeline Audit
A recruiter needs a snapshot of all open jobs for Q3. They ask their agent to run list_companies first, then iterate through each company's positions using list_positions, summarizing the total headcount need.
The Candidate Deep Dive
A hiring manager needs to know if a candidate applied for another role in the past. The agent runs get_candidate and then uses list_applications to provide the full history, ensuring no leads slip through the cracks.
The Quick Intake
A lead comes in via a job board. Instead of filling out forms, the agent runs add_candidate, providing the name and email right away to get the applicant into the system immediately.
Company Comparison
The TA team needs to compare two organizations. They use get_company on both IDs, pulling key metadata points side-by-side in a single conversation turn.
The honest tradeoffs
Trying to find all candidates
Asking the agent vaguely: 'Who applied for Senior Dev roles?' without specifying the company or position ID.
Be specific. First, use list_companies to get the correct company ID. Then run list_positions and finally ask the agent to use list_candidates with both IDs.
Adding data manually
Copying candidate names and emails into a spreadsheet, then having to paste them one by one into Breezy HR.
Tell your agent to use add_candidate. Just give it the list of contacts, and it handles the bulk entry directly into the system.
Ignoring application history
Assuming a candidate's current status is their only record, missing crucial context about past roles.
Always follow up with list_applications to get the full journey. This shows if they were rejected for Role A but applied again for Role B.
When It Fits, When It Doesn't
Use this MCP if your primary bottleneck is data retrieval and moving information between systems, not process automation itself. You need a single place to query candidate records, company details, or open positions using natural language. Don't use it if you are trying to build complex business logic (like 'if status=rejected AND role=senior then notify X'). For that, look into dedicated workflow automation tools. Use this MCP when you just need the data—use get_candidate, list_positions—to bring raw information back to your chat environment for human decision-making.
Questions you might have
How do I list all companies using the list_companies tool? +
You ask your agent to run list_companies. It returns a comprehensive overview of every company you track, giving you their names and IDs for later use.
What is the difference between get_candidate and list_candidates? +
Use get_candidate when you know the candidate's specific ID. Use list_candidates if you want a general roster of people associated with a particular job opening.
Can I add new leads using the add_candidate tool? +
Yes, simply tell your agent to use add_candidate. You provide the name and contact info, and it creates the record in Breezy HR for you.
Do I need list_applications to see a candidate's history? +
Yes. While get_candidate gives current details, running list_applications shows their full journey—every role and status they applied to historically.
When calling get_company, what specific API key format should I provide for authentication? +
You must use a valid Breezy HR API Key. This key grants your agent access; it's not the username or password. Make sure the key you pass to the tool is active and has read permissions set up in your account settings.
What metadata does get_position return about a job opening? +
The get_position tool returns comprehensive details, including required skills, department ID, salary range, and the date it was posted. This depth lets your agent build full job descriptions without extra calls.
If I run list_positions for many companies, will there be a rate limit? +
Yes, repeated bulk requests can trigger limits. We recommend batching your company IDs and calling the tool in groups of 50 to maintain smooth performance across large datasets.
If I run list_candidates, how do I handle cases where a position has no applicants yet? +
The tool returns an empty array rather than throwing an error. Your agent should check for this empty response to confirm that zero candidates are currently assigned to that specific role ID.
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.
We've already built the connector for Breezy HR. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 8 tools are live and waiting.
You're up and running in seconds.
Gemini Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.