# Hurma MCP for AI Agents AI Agent Connect > Hurma MCP lets you manage your entire HR workflow through your AI agent. You can track recruiting pipelines, manage employee records, and monitor time-off requests without leaving your favorite workspace. It's built for growing teams that need to keep people operations organized without the manual overhead. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_ANK9b0icI5MYIH9ONPQERXGt3fEs6KRTAAut0oF3/ai-agent-connect - **Tags:** employee-directory, time-off-tracking, onboarding, hiring-pipeline, performance-reviews, hr-management ## Description Connect your Hurma instance to any AI agent and manage your HR operations through natural conversation. This Connector lets you handle the tedious parts of people operations without jumping between different browser tabs. Instead of hunting for a specific dashboard to see who is away, you can just ask your agent to check the current status of your team. It handles the heavy lifting of HR admin work, like checking a teammate's remaining time off before you book a meeting or creating a new candidate profile on the fly. You don't have to remember specific URLs or move through complex menus. When you connect this to Vinkius, it turns your AI into a functional HR agent that knows your company's structure, from department layouts to individual onboarding checklists. You get to spend less time on data entry and more time actually managing your people. You can quickly see who is in the interview stage, pull up a new hire's specific details, or get a list of every department in the company. It bridges the gap between your HR data and your daily workspace, making it possible to keep your records up to date while you focus on the actual work of building a team. Whether you're checking a vacation balance or pulling a list of candidates, the goal is to keep your people operations moving without the manual friction. ## Tools ### create_candidate Add a new person to your recruiting pipeline. This lets you log new applicants as soon as you find them. ### create_leave_request Submit a new time-off or absence request for an employee. This makes it easy to log leaves without navigating the full HR portal. ### export_overtimes Download your overtime data for reporting. Use this to get the numbers you need for payroll or audits. ### get_vacation_balance Check how many vacation days an employee has left. You can quickly verify availability before approving a request. ### get_employee_details View the full profile and details of a specific employee. Use this to get a quick overview of a team member's role and history. ### list_departments Get a list of all the different departments in your company. This helps you understand the current organizational structure. ### list_employees Browse the entire list of employees in your organization. Use this to find any team member across the company. ### list_out_of_office See which team members are currently away from their desks. It's the fastest way to check team availability. ### list_custom_properties View the custom fields you've defined in your HR records. This helps you see the specific data points you're tracking. ### list_vacancy_stages See the different steps in your hiring process. You can see where every candidate sits in the pipeline. ### get_candidate_details Pull specific information about a single candidate. This helps you review a profile quickly during a hiring sprint. ### list_candidates See all the people currently in your recruiting pipeline. You can monitor your hiring progress at a glance. ## Prompt Examples **Prompt:** ``` Who is out of the office this week? ``` **Response:** ``` ### Team Availability | Name | Reason | Dates | | :--- | :--- | :--- | | **Ana Costa** | Vacation | Apr 24-28 | | **Mike Torres** | Sick Leave | Apr 25 | | **Lisa Park** | Remote | Apr 26 | *Total out of office: 3* ``` **Prompt:** ``` List all candidates in the Interview stage. ``` **Response:** ``` ### Interview Stage Pipeline * **Maria Silva** - Senior Dev * **James Lee** - PM * **Carlos Mendes** - Senior Backend There are currently 5 candidates in the Interview stage. ``` **Prompt:** ``` What's the onboarding status for the new Engineering hires? ``` **Response:** ``` ### Engineering Onboarding Progress * **Maria Silva**: 60% Complete * **João Santos**: 40% Complete * **Ana Lima**: 20% Complete *Status: 3 active onboardings in progress.* ``` ## Capabilities ### Track recruiting pipelines See every candidate and their current stage in your hiring process. ### Manage employee records Pull up full details for any team member or browse your entire directory. ### Handle time-off requests Check vacation balances and submit new absence requests instantly. ### Monitor onboarding progress Keep tabs on new hire checklists and see how they are settling in. ### View company structure Get a high-level overview of all departments and job positions. ## Use Cases ### The Hiring Sprint A manager needs to see all candidates in the Interview stage and add a new one from a resume. They use list_candidates and create_candidate to keep the pipeline moving. ### The Team Sync A lead wants to see who is away this week and check the Engineering department's head count. They use list_out_of_office and list_departments to plan the week. ### The Onboarding Check An HR admin needs to see if a new hire's checklist is done and what their current position is. They use list_custom_properties and get_employee_details to verify status. ### The Vacation Request An employee wants to know their balance before asking for a week off in October. They use get_vacation_balance and create_leave_request to handle the request. ## Benefits - Stop jumping between browser tabs by accessing your employee directory and candidate lists directly in your chat. - Speed up hiring by using create_candidate to add new applicants to your pipeline as soon as you find them. - Keep team schedules clear by using list_out_of_office to check availability before booking any meetings. - Simplify leave management by using create_leave_request to log time off without opening the HR dashboard. - Track onboarding progress with list_custom_properties to see exactly where new hires stand in their journey. - Get instant visibility into your company structure by pulling a full list of departments and positions. ## How It Works The bottom line is you turn your AI into a direct interface for your Hurma HR data. 1. Subscribe to the Hurma MCP on Vinkius. 2. Enter your Hurma domain and API Key in your AI client settings. 3. Start asking your agent to pull candidate lists or check team availability. ## Frequently Asked Questions **How does Hurma MCP help my HR team?** It lets your team manage employee records, track leave requests, and handle recruiting pipelines through natural conversation with your AI agent. **Can I use Hurma MCP to see who is on vacation?** Yes, you can ask your agent to list everyone who is currently out of office or check specific vacation balances. **Can I add new candidates to my pipeline with Hurma MCP?** Absolutely. You can tell your agent to create a new candidate record with their name and position to add them to your pipeline. **Does Hurma MCP work with my current HR data?** Yes, it connects directly to your existing Hurma instance so you can manage your actual company data. **How do I get started with Hurma MCP?** Just subscribe to the Connector on Vinkius and enter your Hurma domain and API key in your AI client's settings. **Can I check vacation balances using Hurma MCP?** Yes, you can ask your agent to check how many vacation days a specific employee has remaining. **Can I manage the recruiting pipeline through the AI agent?** Yes. Use `list_candidates` to see all candidates with status, `get_candidate_details` for full profiles, and `create_candidate` to add new applicants. **Can I monitor who is out of office today?** Yes. `list_out_of_office` retrieves all current and upcoming time-off entries. Use `list_leave_requests` for pending approvals and `get_leave_balances` for remaining vacation days. **Does Hurma require a custom domain in addition to the API Key?** Yes. Each Hurma account has a unique subdomain. Provide the domain name and API Key. Requests go to `https://{domain}.hurma.work/api/v1` with a Bearer token.