# SmartHR MCP for AI Agents AI Agent Connect > SmartHR MCP. Connect your SmartHR workspace to your AI agent to query employee records, payroll data, and organizational structures instantly. Stop clicking through tabs and start getting answers in plain English. ## Overview - **Category:** human-resources - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_sLHuomQKWLgonmqoMlVmmQKwVfYLP3BsOZeKtZIy/ai-agent-connect - **Tags:** employee-management, payroll, organizational-chart, labor-management, hr-compliance ## Description When you're managing a large workforce, finding a specific piece of information usually involves a scavenger hunt. You have to log into your HR portal, filter by department, search for a name, and then click through multiple pages just to find a payroll status or a specific contract detail. It's a friction-filled process that eats up time and makes it hard to get a clear picture of your team. This Connector changes that by letting your AI agent act as a direct line into your SmartHR workspace. Instead of manual searching, you just ask your agent a question. It pulls the data you need, whether it's a list of employees in a specific office or a deep dive into sensitive contract details, and gives it back to you in seconds. You can audit compensation, map out your team's structure, or check office locations without ever leaving your current workspace. It's about making your human capital database actually accessible rather than just stored in a silo. By bringing this into the Vinkius catalog, you get a clean way to connect your company data to the tools you're already using every day. It turns a tedious admin task into a quick conversation, letting you focus on the actual people in your company instead of the data entry. ## Tools ### list_crews Get a full list of all employees. Use this to pull a complete roster for any report. ### get_crew_details Pull deep profile information for a single person. It gives you the specifics on a specific contract. ### list_departments View your organization's departments. This helps you see the high-level structure of the company. ### list_positions See every job role in your company. It helps you understand the variety of positions available. ### list_employment_types Get a breakdown of all employment categories. Use this to see the mix of full-time and contract staff. ### list_payrolls Access employee payroll records. This is useful for auditing compensation across the organization. ### list_establishments Find all physical business locations. Use it to see where your teams are actually based. ### list_crew_dependents See the dependents for a specific employee. This helps with benefits and insurance inquiries. ## Prompt Examples **Prompt:** ``` How many employees do we have in the Engineering department? ``` **Response:** ``` I've checked your departments and crew lists. Here is the breakdown for **Engineering**: | Role | Employee Count | | :--- | :--- | | Software Engineer | 24 | | QA Specialist | 8 | | DevOps | 4 | | **Total** | **36** | ``` **Prompt:** ``` Give me the payroll summary for the Tokyo office. ``` **Response:** ``` I've pulled the payroll records for the **Tokyo Shibuya Headquarters**. * **Active Records:** 142 * **Average Monthly Payroll:** ¥4,200,000 * **Status:** All records are up to date for the current period. ``` **Prompt:** ``` Who are the dependents for the employee with ID crew-8f192? ``` **Response:** ``` I've retrieved the details for **Crew 8f192 (Yuto Tanaka)**: **Dependents Listed:** * **1 Registered Dependent** (Spouse) * **ID:** dep-43X ``` ## Capabilities ### Pull full employee rosters Get a complete list of every crew member in your SmartHR workspace. ### Map out department hierarchies See your entire organizational structure and job positions at a glance. ### Fetch specific contract details Retrieve deep profile information and dependent records for individual employees. ### Audit payroll records Query active and historical payroll ledgers to check compensation scaling. ### Identify office locations List all physical business establishments and branch offices. ### View employment types Get a breakdown of different employment categories across your organization. ## Use Cases ### Checking dependents for health insurance An HR admin needs to verify if a new hire has dependents. They ask the agent to check the records for a specific ID using list_crew_dependents. ### Mapping the Engineering department A manager needs to see the hierarchy of the tech team. The agent uses list_departments and list_positions to show the structure. ### Auditing regional payroll The finance team needs to see payroll records for the Tokyo branch. The agent pulls this via list_payrolls. ### Verifying office locations A security lead needs a list of all registered business sites. The agent quickly pulls the data using list_establishments. ## Benefits - Stop tab-switching by pulling employee rosters and payroll data directly into your chat interface. - Audit compensation scaling faster using list_payrolls to see historical and active records. - Map your entire company structure instantly with list_departments and list_positions. - Get specific contract details on demand using get_crew_details without manual searching. - Check office locations and branch details quickly with list_establishments. - Simplify benefits management by retrieving dependent info with list_crew_dependents. ## How It Works The bottom line is you get instant, natural language access to your entire HR database without the manual clicking. 1. Subscribe to the SmartHR MCP on Vinkius. 2. Enter your SmartHR Access Token and Subdomain in your AI client settings. 3. Ask your agent to query your employee database, payroll records, or org charts. ## Frequently Asked Questions **Can the SmartHR MCP access my payroll data?** Yes, it can query your payroll ledgers to help you audit compensation scaling or check historical records for specific employees. **Does the SmartHR MCP show my office locations?** Yes, it lists all physical business establishments and office locations registered in your SmartHR workspace. **Can I use SmartHR MCP to update employee info?** No, this Connector is for reading and querying data. You'll still need to use the SmartHR web platform to create or edit employee records. **How do I connect my SmartHR account?** Just subscribe to the Connector on Vinkius and add your SmartHR Access Token and Subdomain to your AI client's configuration. **Is my employee data safe with this Connector?** Yes, the Connector uses your specific access token to securely query your data without ever storing your credentials. **Can I see department hierarchies with SmartHR MCP?** Yes, it can list all organizational departments and job positions so you can understand your company's structure easily. **Is it safe to expose my company's payrolls to the AI?** Yes. This connector runs entirely on your local machine or trusted enclave natively. No employee data, payload information or generated queries are routed to our servers—your API interactions occur directly from your environment straight to SmartHR's endpoints. **Can the agent calculate average payroll over time automatically?** Absolutely. Just prompt your agent: 'List all payrolls from Q2, and display the average distribution'. The agent will call the `list_payrolls` endpoint, retrieve the raw figures, do the mathematical operation independently in context, and present you a very clear table or markdown summary. **How do I look up which internal department an employee works for?** You don't need to specify the exact tool. You can simply ask: 'What department is crew member [Name] in?'. Your AI will automatically use the `list_crews` tool and cross reference the results with `list_departments` to formulate a correct response.