# Humaans MCP MCP > Humaans MCP connects your AI agent directly to a modern HRIS system. You can run operational queries against employee records, track leave status, and map out organizational structures using available tools like `list_employees` or `get_employee`. It pulls data on departments, roles, teams, offices, and public holidays needed for automating HR workflows. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** hris, employee-directory, leave-management, org-chart, people-ops, payroll-data ## Description Need to pull specific employee details or run reports based on current company structure? This MCP connects your agent to the Humaans HRIS API. You can automate routine HR operations that usually require logging into a dashboard. For example, you can list all active employees, check who is currently out on leave, or quickly find out which department an office belongs to. Whether it’s checking for public holidays in Q4 or pulling the records for every person in the marketing department, this MCP handles it. It gives your agent access to foundational company data like teams, roles, and document libraries. All of these tools are hosted on Vinkius, so you connect once from any compatible client and gain immediate access to HR operations. It’s built for anyone needing reliable organizational data—from simple directory lookups to complex leave balance checks. ## Tools ### get_employee Retrieves specific profile information for one employee. ### get_me Returns the profile details of the authenticated user running the agent. ### list_departments Gets a list of all defined departments within the organization. ### list_documents Provides an index of company and employee-specific documents. ### list_employees Generates a full directory list of all employees. ### list_leaves Lists active or historical leave requests for staff members. ### list_offices Retrieves a directory listing of corporate office locations. ### list_public_holidays Fetches the dates for company-recognized public holidays. ### list_roles Provides a list of all job titles and roles available in the company. ### list_teams Lists all operational teams within the organization's structure. ## Prompt Examples **Prompt:** ``` List all employees in the London office. ``` **Response:** ``` I'll fetch the employee list and filter by the London office for you. ``` **Prompt:** ``` Who is currently on leave? ``` **Response:** ``` I'll check the current leave requests to see who is away. ``` **Prompt:** ``` Show me the organization chart (teams and departments). ``` **Response:** ``` I'll retrieve the list of teams and departments for you. ``` ## Capabilities ### Retrieve specific employee details Get the full profile of an individual using their ID. ### List all employees and roles Fetch a directory list of every active employee or job role within the company. ### Check leave status Pull current records to see who requested time off or when leaves are scheduled. ### Map organization structure List departments, offices, and teams to understand the company's hierarchy. ### View corporate documents Find a list of official company or employee-specific documents. ## Use Cases ### Running an offsite headcount check A manager needs to know which employees are available next week. They ask their agent, and it uses `list_employees` combined with filtering logic based on current leave status from `list_leaves`. The result gives a clean list of people who can attend. ### Onboarding new staff An HR assistant needs to know which teams and departments exist for a new hire. They query the MCP, which runs `list_departments` and then `list_teams`, giving them all available options to assign. ### Payroll deadline data collection A payroll specialist needs to confirm all staff are accounted for before running checks. They run the MCP, which uses `list_employees` and cross-references it with `list_offices` to ensure every location is covered. ### Drafting an internal announcement A communications lead needs a list of contacts for all managers. They prompt the agent, which uses `list_roles` and then filters that against `get_employee` to pull manager-level contact information. ## Benefits - Instantly get a complete directory of staff. Instead of manually searching through multiple spreadsheets, use `list_employees` to pull a comprehensive list of everyone on the books. - Automate PTO tracking. You can check who is away or how many leave requests are pending by running `list_leaves`, which eliminates manual calendar checks and follow-ups. - Map out organizational structure quickly. Use tools like `list_departments` and `list_teams` to understand the hierarchy without clicking through a complex org chart view. - Handle time off planning reliably. Before scheduling, use `list_public_holidays` and `list_leaves` together to ensure nobody is booked on a non-working day. - Get immediate user info. If you need details for yourself or another team member, the `get_employee` tool pulls accurate records straight from the source. ## How It Works The bottom line is: you prompt an action, and the agent executes the necessary API calls to get clean, structured HR data back. 1. Tell your agent exactly what data you need. For example, 'List all employees in the London office.' 2. Your agent selects and executes the appropriate tool (e.g., `list_employees` combined with department filtering). 3. The MCP runs the query against Humaans and returns a structured set of results to your client for immediate use. ## Frequently Asked Questions **How do I use the list_employees tool with Humaans MCP?** You run `list_employees` to pull a master directory. If you need to narrow it down, ask your agent to filter that list by criteria like department or office location. **What is the best tool for checking if an employee needs PTO?** Use `list_leaves`. This function checks current leave requests and helps you see who's scheduled off, which is more accurate than just looking at a calendar. **Can I find out what roles exist using list_roles in Humaans MCP?** Yes. `list_roles` gives you the official job titles recognized by the company. This helps validate if an employee's title is current or standard. **Does get_employee show me all their documents?** `get_employee` shows core profile data, but for a list of attached files, you need to run `list_documents`. They are separate functions. **How do I use the get_me tool to verify my own user details?** It retrieves your current authenticated user information directly. You can run this tool anytime to confirm which user context your AI agent is operating under before fetching sensitive employee data. **What does list_departments return about the organizational structure?** It provides a complete list of all existing departments within your organization. This lets you filter other searches, such as finding employees or documents, by their specific department ID. **If I need to check which offices are available, should I use list_offices?** Yes, using list_offices gives you a current inventory of all physical locations. This is helpful for filtering employee directories or understanding regional operational boundaries. **Can I find out what holidays are coming up with list_public_holidays?** It lists all recognized public holidays according to the system calendar. This ensures your agent knows when paid time off is automatically granted, preventing unnecessary leave requests. **How do I get Humaans API credentials?** You can generate an Access Token in your Humaans user profile settings under 'API'. Ensure you have the necessary permissions to access organizational data. **Can I see salary information?** Access to sensitive fields like salary depends on the permissions of the Access Token provided. This MCP uses the standard people and organization endpoints. **Does it support leave management?** Yes, the list_leaves tool allows you to track and monitor employee leave requests.