# KeyPay MCP for AI Agents AI Agent Connect > KeyPay MCP. Connect your KeyPay (Employment Hero Payroll) account to your AI agent to manage payroll, employee data, and leave requests. Pull pay run details, check deductions, and access payslips instantly without manual data entry. ## Overview - **Category:** human-resources - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_vs5aCUuKDAsrOmTWYJGNHpzCEssitb2WepI0qq0l/ai-agent-connect - **Tags:** payroll-processing, workforce-management, compliance, employee-records, pay-runs, hr-automation ## Description This Connector gives your agent a direct line into your KeyPay payroll data. Instead of jumping between tabs to find out why a pay run is pending or what a specific employee's deductions look like, you can just ask your agent. It handles the heavy lifting of navigating the Employment Hero Payroll platform for you. You can pull up business details, see who's on leave across different locations, and grab payslips without clicking through three levels of menus. Using Vinkius, you can get this connected in minutes, letting your AI client handle the tedious parts of HR data retrieval. It's built for the person who needs to know the status of a pay run or a specific employee's profile without having to log in and hunt for it. You get a conversational way to manage the data that usually requires a lot of clicking. This means you can stay in your chat interface and get answers to questions like 'Who is on leave today?' or 'What was the total for the last pay run?' without the context switching that usually slows down your day. You can also verify that specific deduction lines are correct or pull a full list of employees for a specific business entity to keep your records organized. It turns a manual data-gathering chore into a simple conversation where your agent does the navigating for you. ## Tools ### list_pay_runs See all pay runs for a specific business. It helps you quickly check the status of past or upcoming payroll cycles. ### list_employees Get a list of all employees for a specific business. This helps you quickly identify who is on the current roster. ### get_business_details Pull specific details for a single business. Use this to verify location or configuration data for a specific site. ### get_employee_details Get the full profile and payroll info for an employee. This is the go-to tool for checking individual staff data. ### get_pay_run_details See the specific details of a single pay run. Use this to look into one specific payroll cycle at a time. ### list_leave_requests See all leave requests for a specific business. Use it to track who's out and when they're coming back. ### list_pay_slips Get a list of payslips for a specific employee. This is perfect for when a staff member needs to see their history. ### list_businesses Get a list of every business connected to your account. Use this to see which entities you have permission to manage. ### list_pay_run_deductions View all the deductions for a specific pay run. This is great for double-checking accuracy before finalizing payments. ### list_pay_run_earnings See all the earnings associated with a specific pay run. Use it to verify that all hours and bonuses were captured correctly. ## Prompt Examples **Prompt:** ``` Show me the pay runs for business ID 12345. ``` **Response:** ``` I've found 5 recent pay runs for business 12345. The latest is **'Fortnightly Pay Period'** ending May 15th, which is currently marked as **Finalised**. ``` **Prompt:** ``` Who is on leave for the main office? ``` **Response:** ``` Here are the current leave requests for the main office: | Employee | Status | Dates | | :--- | :--- | :--- | | John Smith | Approved | May 1st - May 5th | | Sarah Jane | Pending | May 12th - May 14th | John is already out, while Sarah's request is still waiting for approval. ``` **Prompt:** ``` Can you list the employees for the Tech Ventures business? ``` **Response:** ``` I've retrieved the employee list for Tech Ventures. You have 12 employees currently listed, including: - Alice Wong (Senior Developer) - Bob Miller (QA Engineer) - Charlie Day (Designer) Would you like to see the full details for any of these individuals? ``` ## Capabilities ### Pull pay run details Get the specific status and data for any completed or pending pay run. ### List all businesses See every business entity associated with your account in one view. ### View employee profiles Access personal details and payroll configurations for any staff member. ### Check leave history See pending and past leave requests for any business you manage. ### Grab payslips Pull a list of issued payslips for a specific employee instantly. ### Inspect deductions Review the specific deduction lines and payroll items for any pay run. ## Use Cases ### Checking a pay run status An admin asks the agent if the 'Fortnightly Pay' is done. The agent uses `get_pay_run_details` to confirm it's finalized. ### Finding a specific employee A manager wants to know a staff member's details. The agent uses `get_employee_details` to pull their profile and payroll setup. ### Auditing deductions An accountant needs to see why a pay run was low. The agent uses `list_pay_run_deductions` to show all the deduction lines for that period. ### Tracking leave An HR lead wants to see who's out this week. The agent uses `list_leave_requests` to pull the status of all pending and historical requests. ## Benefits - Stop digging through menus to find pay runs. Use `list_pay_runs` and `get_pay_run_details` to see exactly what's happening with your payroll cycles instantly. - Get a bird's-eye view of your staff. Use `list_employees` and `get_employee_details` to manage your entire workforce without opening multiple browser tabs. - Track leave requests across multiple sites. Use `list_leave_requests` to see who's away from work across all your different business entities in one go. - Verify payroll accuracy faster. Use `list_pay_run_deductions` and `list_pay_run_earnings` to double-check every line item before you hit finalize. - Access payslips on demand. Use `list_pay_slips` to quickly find and share the history of issued payslips with employees who need them. - Manage multiple businesses with ease. Use `list_businesses` and `get_business_details` to switch between different entities without getting lost in the dashboard. ## How It Works The bottom line is you get instant, conversational access to your payroll and employee data without leaving your AI client. 1. Subscribe to the KeyPay MCP on the Vinkius platform. 2. Input your KeyPay API Key and your specific Region Domain. 3. Ask your agent to list pay runs, check employee details, or pull leave requests. ## Frequently Asked Questions **What can I do with the KeyPay MCP?** You can use your AI agent to pull payroll data, check employee profiles, and view leave requests across all your businesses without leaving your chat window. **Can I check pay run statuses with KeyPay?** Yes, you can ask your agent to check if a specific pay run is finalized, see the total earnings, or look into specific deduction lines. **How do I see leave requests for my businesses?** The Connector allows your agent to pull a list of all leave requests, showing you who is currently away and what requests are still pending. **Can the KeyPay MCP pull employee profiles?** It can pull full employee details, including their payroll configurations and basic profile information, so you don't have to search for them manually. **How do I check payroll deductions?** You can ask your agent to list the deductions for any specific pay run to verify that everything is accurate before you finish the cycle. **Can I use this to find payslips for my staff?** Yes, you can quickly pull a list of issued payslips for any employee to help with internal queries or record keeping. **Does the KeyPay MCP work for multiple businesses?** Yes, it can list all businesses in your account and pull data for each one, making it ideal for managing multiple entities from one place. **In which regions is the KeyPay API available?** KeyPay supports multiple regions including Australia, UK, New Zealand, Singapore, and Malaysia. Make sure to provide the correct region domain during setup. **Can I see my employee's payslips using this agent?** Yes, the `list_pay_slips` tool allows you to retrieve a list of issued payslips for a specific employee within a business. **Is it possible to track leave requests?** Absolutely. Use the `list_leave_requests` tool to fetch all historical and pending leave requests for any of your registered businesses.