# IntelliHR MCP > IntelliHR connects your AI client directly to the intelliHR people management platform. Your agent can automatically pull core employee data, track job assignments across departments, and manage organizational records. Get comprehensive access to profiles, skills inventories, location listings, pay details, and training histories without leaving your workflow. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** employee-directory, people-management, job-assignments, hr-automation, organizational-data, performance-tracking ## Description This MCP lets you treat your HR systems like a natural conversation. Instead of navigating dozens of internal tabs or exporting messy spreadsheets, your agent talks directly to the intelliHR API to get the exact data points you need. Need to know everything about an employee, from their current job title and salary details to all past training records? Your AI client handles it in one prompt. It pulls together structured information—like listing every defined position or tracking which legal business entities exist—and presents it cleanly. Whether you're analyzing team skill gaps, auditing organizational structure, or just building a master employee directory, this connector does the heavy lifting. Because it’s hosted on Vinkius, you connect your preferred AI client once and gain access to intelliHR alongside thousands of other business tools. ## Tools ### get_person Fetches complete details for a specific person by their unique ID. ### list_business_entities Retrieves a list of all legal business entities registered in the system. ### list_jobs Lists every job or position title that is currently assigned to an employee. ### list_locations Returns a list of all registered physical office locations globally. ### list_people Provides an exhaustive directory listing of every person or employee in intelliHR. ### list_positions Lists all official position titles that the company uses for job assignments. ### list_remuneration Retrieves detailed information regarding employee pay and salary structures. ### list_skills Lists all defined skills available for employees within the organization's records. ### list_training Retrieves a history of all employee training and development completion records. ### list_users Provides a list of every system user who has access to the platform. ## Prompt Examples **Prompt:** ``` List all employees in the intelliHR directory. ``` **Response:** ``` I'll fetch the complete employee directory for you. ``` **Prompt:** ``` Show me details for employee ID '123'. ``` **Response:** ``` I'll retrieve the full profile and job history for that specific employee. ``` **Prompt:** ``` List all registered office locations. ``` **Response:** ``` I'll look up the list of office locations in your organisation. ``` ## Capabilities ### Retrieve complete employee profiles Get detailed records for any single person in the system. ### Audit organizational structure and jobs List all defined job roles, positions, and active business entities across the company. ### Inventory employee skills and training history Pull lists of skills or view comprehensive records of required and completed employee development courses. ### Map physical locations and users Access a list of all registered office locations, as well as all system users with platform access. ## Use Cases ### Auditing compliance for a new market. The Ops Manager needs to ensure every regional office is accounted for. They ask their agent, 'Show me all registered locations and list any business entities that might operate there.' The MCP runs both list_locations and list_business_entities, providing the required map instantly. ### Identifying internal skill gaps. A team lead needs to know who can fill a specialized role. They ask their agent to combine data from list_skills and list_positions. The MCP returns a ranked list of employees whose skills match the requirements for open, high-priority jobs. ### Onboarding new departmental leads. The HR Coordinator asks the agent to 'Get all data on the top five people in Marketing.' Using get_person and list_people, the agent pulls full profiles for those individuals, detailing their roles, pay structure (list_remuneration), and recent training. ### Preparing for an organizational restructure. The executive wants to see who is currently employed versus who has platform access. They prompt the agent to run list_people against list_users, allowing them to quickly spot discrepancies between active staff and system accounts. ## Benefits - Get a complete picture of staff knowledge by using list_skills to inventory all defined capabilities. You can then cross-reference this with list_jobs to see which positions are underskilled. - Audit organizational structure instantly. Instead of guessing, you can use list_business_entities and list_positions together to verify every legal entity and its assigned job titles. - Track employee growth by calling list_training. This lets your agent build a report showing who is due for recertification or who needs mandatory compliance courses. - Build an accurate master directory by combining list_people with get_person. You can pull detailed profiles on demand, giving you specific records without downloading massive files. - Understand compensation at scale using list_remuneration. This tool provides direct access to pay details, helping finance and HR reconcile salary bands against job titles (list_jobs). - Simplify location management by calling list_locations first, then cross-referencing user data via list_users to pinpoint which employees are assigned to specific offices. ## How It Works The bottom line is you get direct access to deep HR system knowledge without needing an IT ticket or learning complex API calls. 1. Your AI client sends a request to this MCP, specifying the type of HR data needed (e.g., 'List all employees who trained last quarter'). 2. The connector routes that request through the intelliHR API, gathering structured records like job assignments or remuneration details. 3. It returns a clean, organized set of data directly into your client's chat window for immediate use. ## Frequently Asked Questions **How do I find an employee's full background using the intelliHR MCP?** You can get all details by combining list_people with get_person. This allows your agent to fetch a comprehensive profile, including their job assignments and contact information. **Does the intelliHR MCP handle salary data?** Yes, it does. The list_remuneration tool provides direct access to detailed employee pay and compensation records when needed for reporting or auditing. **Can I use intelliHR MCP to see all available job titles?** Absolutely. Use the list_positions tool to pull a complete roster of every defined position title within the company's structure, regardless of who currently holds it. **What if I need to find skills related to specific jobs using intelliHR MCP?** You can combine list_jobs with list_skills. Your agent will compare the requirements of a job title against the entire pool of defined organizational skills. **Is the intelliHR MCP suitable for small teams or large corporations?** It handles both. While it manages massive corporate data, its ability to pinpoint specific records using get_person makes it highly efficient for smaller teams doing focused audits.