# Humaans MCP for AI Agents AI Agent Connect > Humaans connects your AI agent to your HRIS to manage people data. You can pull employee details, track leave requests, and view org charts across global teams. It is built for HR teams who need to get info fast without digging through dashboards. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_LarqqH4EDHEPnslQdaPVgGeeelzn7f5eRT2uEUac/ai-agent-connect - **Tags:** hris, employee-directory, leave-management, org-chart, people-ops, payroll-data ## Description This Connector gives your AI agent the eyes it needs to see into your Humaans account. Instead of hunting through a messy HR dashboard to find out who is out of the office or what department a new hire belongs to, you can just ask your agent. You can check who is on vacation, grab a list of everyone in a specific office, or pull down the full org structure. It turns your HRIS into a searchable knowledge base for your agent. By using this via the Vinkius catalog, you get a centralized way to keep your people operations moving without the usual manual overhead of switching tabs and copying data. It is about making employee data accessible exactly when you need it, whether you are onboarding someone or just checking on team capacity. You get direct access to your company's people data without the friction of manual lookups. ## Tools ### list_documents View company and employee documents. This helps you find internal records or policies quickly. ### list_employees Get a full list of everyone. This is great for pulling a complete directory of your staff. ### list_leaves See who is out of the office. This lets you track leave requests without opening separate tabs. ### list_roles See all job titles. This helps you understand the various roles available within your company. ### list_teams See all team structures. This allows you to see how your organization is grouped into teams. ### get_me See your own account info. This helps the agent understand which user is currently authenticated. ### list_departments See all company departments. Use this to map out the various divisions of your organization. ### list_offices See all physical locations. This helps you coordinate logistics across different global offices. ### list_public_holidays Get a list of public holidays. Use this to plan deadlines across different time zones and regions. ### get_employee Get specific details for an individual. This is useful for quick profile lookups during the onboarding process. ## Prompt Examples **Prompt:** ``` Who is currently in the London office? ``` **Response:** ``` Here are the employees currently listed in the London office: | Name | Role | | :--- | :--- | | Sarah Jenkins | Senior Designer | | Marcus Chen | Project Manager | | Elena Rodriguez | UX Researcher | Would you like me to get more details on any of these people? ``` **Prompt:** ``` Who is away on leave this week? ``` **Response:** ``` I've checked the leave requests for this week. The following people are currently away: * **David Smith** (Back on Monday) * **Aisha Khan** (Back on Wednesday) * **Tom Baker** (Back on Friday) Let me know if you need to see their specific return dates. ``` **Prompt:** ``` Show me the company departments and teams. ``` **Response:** ``` Your organization is structured into the following departments and teams: **Departments:** * Engineering * Marketing * Sales * People Ops **Teams:** * Frontend Development * Growth Marketing * Customer Success * Product Design ``` ## Capabilities ### Fetch employee profiles Get specific details for any staff member instantly. ### List all staff members Pull a complete list of everyone in your organization. ### Track leave requests See who is away and when they will return. ### Browse organizational departments View the various departments that make up your company. ### View office locations See all the physical offices your team operates out of. ### Check public holidays Get a list of holidays across different regions. ### Identify job roles See the different job titles available in your company. ### Browse team structures Look up the different teams within your organization. ## Use Cases ### Quick Onboarding An HR generalist asks the agent for the details of a new hire. The agent uses get_employee to pull the data and draft a welcome email. ### Capacity Planning A team lead asks who is on vacation next week. The agent uses list_leaves to provide a summary of who is out. ### Org Mapping An ops manager needs to see the company structure. The agent uses list_departments and list_teams to build an overview. ### Global Logistics A manager needs to know which offices are in Europe. The agent uses list_offices to find all locations in that region. ## Benefits - Skip the dashboard: Use list_leaves to see who is away without opening your HRIS browser. - Faster onboarding: Use get_employee to pull data instantly for new hires and internal records. - Global planning: Use list_public_holidays to see regional dates in one view for better planning. - Org clarity: Use list_teams and list_departments to map out your company structure in seconds. - Document access: Use list_documents to find internal records without searching through folders. - Role awareness: Use list_roles to quickly identify job titles across your entire organization. ## How It Works The bottom line is you get a conversational interface for your entire HRIS database. 1. Connect your Humaans API keys to the Connector. 2. Authorize your AI client to access your specific HR data. 3. Ask questions about your team or employees in plain English. ## Frequently Asked Questions **Can Humaans MCP help me check employee leave status?** Yes, it can. You can ask your agent who is currently on leave, and it will pull that information directly from your HRIS so you can see who is away without opening a dashboard. **How do I use Humaans MCP for employee lookups?** You can simply ask your agent for a specific person's details. It will retrieve their profile information from your Humaans account and show it to you in the chat. **Does Humaans MCP support global offices?** Yes, it does. You can ask your agent to list all the offices your company has, which is helpful for coordinating work across different locations. **Can I use Humaans MCP to see company departments?** Absolutely. It can pull a list of all departments in your organization, making it easy to see how your company is structured. **Is Humaans MCP good for HR teams?** It is specifically designed for people operations. It helps HR teams answer common questions about staff, leave, and org structure much faster than manual lookups. **Can Humaans MCP find public holidays?** Yes, it can pull a list of public holidays. This is great for planning deadlines and understanding regional time-off across your global team. **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 Connector 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.