# Hurma MCP MCP > Hurma MCP manages your entire HR lifecycle using natural language commands. From tracking candidates in the pipeline to monitoring employee vacation balances and submitting time-off requests, this connector lets you manage core people operations without touching a dashboard. It's designed for growing teams that need real-time data on hiring status and team availability. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** employee-directory, time-off-tracking, onboarding, hiring-pipeline, performance-reviews, hr-management ## Description This MCP connects your AI agent directly to Hurma’s HR system, letting you handle complex people management tasks through conversation instead of endless clicks. You can ask the system to list all current employees or check a specific person's vacation balance. Need to move a candidate along? You tell the agent, and it tracks the change in the pipeline. The platform lets you get detailed employee records or even monitor who is currently out of office for scheduled leave. When you connect your AI client via Vinkius, your agent gets immediate access to all these core tools, letting you manage everything from onboarding checklists to department structures—all without context switching. ## Tools ### create_candidate Creates a new record for a job applicant in the system. ### create_leave_request Submits a formal request for an employee's absence or time off. ### export_overtimes Generates and exports data detailing all recorded overtime hours. ### get_vacation_balance Reports the remaining paid time off balance for a specified employee. ### get_candidate_details Retrieves specific information for a known job candidate by ID or name. ### get_employee_details Pulls comprehensive data for a single employee, including role and department. ### list_candidates Retrieves a list of all candidates currently in the hiring pipeline. ### list_departments Lists all official company departments and their codes. ### list_employees Provides a list of every current employee in the organization. ### list_out_of_office Shows which employees are currently marked as unavailable or out of office. ### list_custom_properties Shows available custom fields or data points used across records. ### list_vacancy_stages Lists the defined stages used in the recruiting workflow (e.g., Applied, Interview). ## Prompt Examples **Prompt:** ``` Show all candidates in the pipeline and employees out of office this week. ``` **Response:** ``` Recruiting pipeline: 18 candidates. Applied (6), Screening (4), Interview (5), Offer (2), Hired (1). Top: 'Maria Silva' (Senior Dev, Interview), 'James Lee' (PM, Offer). Out of office: 3. Ana Costa — Vacation Apr 24-28, Mike Torres — Sick leave Apr 25, Lisa Park — Remote Apr 26. ``` **Prompt:** ``` List all employees in Engineering and create a new candidate for Senior Backend. ``` **Response:** ``` Engineering: 12 employees. Lead: Sarah Chen (VP). 2 open positions (Senior Backend, DevOps). Candidate created! Carlos Mendes, Senior Backend, Stage: Applied. Pipeline now 19 candidates. ``` **Prompt:** ``` Show onboarding status for new hires and all departments. ``` **Response:** ``` Onboarding: 3 active. Maria Silva (60%), João Santos (40%), Ana Lima (20%). Departments: 6. Engineering (12), Product (4), Design (3), Marketing (5), Sales (8), HR (3). Total: 35 employees. ``` ## Capabilities ### Manage Candidate Pipeline List candidates and create new profiles for the recruiting pipeline. ### Check Employee Status Get detailed records, including department assignments and job positions, for any employee. ### Track Time Off View who is out of office or create formal leave requests for team members. ### Audit Labor Data Export detailed reports on employee overtime data. ## Use Cases ### The Team Lead needs to know who's available next week. Instead of emailing five people or opening a shared calendar, you prompt your agent: 'Who is out of office between April 24th and April 30th?' The MCP uses `list_out_of_office` and checks various employee records instantly. You get the list right there, so you can schedule meetings without back-and-forth. ### A recruiter needs to fast-track a top candidate. You tell your agent: 'Create a new record for John Doe and update his status.' The MCP runs `create_candidate` and ensures the data is logged correctly in the pipeline. This means you don't have to manually click through five different forms. ### HR needs an accurate report of labor hours. Don't pull raw CSVs from a separate payroll system. Just ask your agent to export overtime data using `export_overtimes`. You get the precise, formatted details you need for compliance checks in seconds. ### The manager needs an immediate overview of team staffing. You prompt: 'List all employees and show me who is in Engineering.' The MCP uses `list_employees` and filters by department, giving you a clean count and list right away. You don't waste time clicking through the departmental directory. ## Benefits - Instead of navigating multiple tabs to check who's out, just ask the agent to list all employees currently marked as unavailable. It handles the `list_out_of_office` call immediately. - Skip logging into the recruiting portal just to see status updates. You can now use your agent to list candidates and review their profiles using `get_candidate_details` directly in your chat window. - When a new hire needs time off, you don't have to search for policy documents; ask the agent to check an employee’s remaining paid time off balance via `get_vacation_balance`. - Need payroll data? The MCP makes it simple. You can instruct your agent to export overtime records using `export_overtimes`, getting clean, structured data instantly. - Manage organizational structure changes by listing all departments or viewing job roles by calling tools like `list_departments` and `get_employee_details`. This keeps the conversation focused on the needed data. ## How It Works The bottom line is, you talk to your AI agent, not the dashboard. 1. Subscribe to this MCP and provide your Hurma domain name and API key credentials. 2. Connect the service within your preferred AI client, granting it access permissions for HR data endpoints. 3. Ask your agent a question like, 'Who needs PTO next week?' and it executes the necessary tool calls. ## Frequently Asked Questions **How do I check an employee's vacation balance using get_vacation_balance?** You just ask your agent, 'What is Jane Doe's remaining PTO?' The MCP uses `get_vacation_balance` and returns the precise number without needing you to know her ID. **Can I use list_candidates to see who has applied?** Yes, `list_candidates` shows every person in the pipeline. You can then ask for more detail on a specific profile using `get_candidate_details` if you need to review their submitted info. **Does create_leave_request handle conflicts?** The tool submits the request, but your agent reports back on whether that time-off conflicts with other existing requests or team capacity based on current data. **What is the difference between list_employees and get_employee_details?** `list_employees` gives you a roster of everyone (names, departments). `get_employee_details` drills down into one person to give you specific data like their current position or manager. **When I run list_employees, what kind of data does the MCP fetch regarding employee status?** It fetches comprehensive details including current employment status and department assignments. This ensures your agent knows if an employee is active, inactive, or on a specific type of leave. **What information can I retrieve using list_custom_properties?** This tool lists all the custom fields defined in your Hurma instance. You'll see every available attribute name and definition, allowing you to write precise instructions for data capture. **How is overtime reporting handled when I use export_overtimes?** The MCP delivers structured data containing all recorded overtime hours. This output is designed specifically for payroll processing, giving you raw numbers rather than just summaries. **Does running list_vacancy_stages help me understand the overall hiring process flow?** Yes, this tool lists every official stage in your recruiting pipeline. It gives immediate visibility into where candidates sit, from initial application to final offer. **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.