KeyPay MCP. Check compliance and manage payroll records.
KeyPay lets you manage payroll, employee records, and pay runs directly from your agent. This MCP connects to KeyPay (Employment Hero Payroll) so you can list businesses, check earnings, track leave requests, and verify compliance data for all your employees.
Give Claude and any AI agent real-world access
Retrieve a list of all corporate entities linked to the KeyPay account.
Fetch specific profile and payroll setup information for individual employees.
Retrieve full details about a single pay cycle, including all earnings and deductions.
Get a complete list of both pending and historical leave requests across your business units.
List and retrieve payslips for specific employees instantly.
Ask an AI about this
Waiting for input…
What AI agents can do with KeyPay: 10 Tools for HR Management
These tools allow you to systematically retrieve specific pieces of data—from listing all employees to viewing deduction lines—using natural language through your agent.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using KeyPay MCPList Businesses
Gets a list of every business connected to your KeyPay account.
List Pay Run Deductions
Shows all deductions applied during a specific payroll run.
List Pay Run Earnings
Retrieves the detailed list of earnings for a given pay cycle.
List Employees
Provides a roster and basic details for all employees in one business.
Get Business Details
Pulls specific, detailed information about a single identified business entity.
Get Employee Details
Fetches the full profile and configuration details for one employee.
Get Pay Run Details
Retrieves comprehensive information about a single pay run, including status and dates.
List Leave Requests
Lists all current and past leave applications for a specified business unit.
List Pay Runs
Retrieves a list of recent pay runs conducted for a given business.
List Pay Slips
Generates a list of payslips available for a particular employee.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on each call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with KeyPay, then connect any of our 5,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by KeyPay. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS CLOUD
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Payroll compliance is a bureaucratic nightmare.
Today, checking on employee records means jumping between the main KeyPay dashboard, downloading payslip PDFs, and manually cross-referencing earnings tables. You're opening five different tabs just to confirm that an employee was paid correctly after accounting for leave or deductions. It’s tedious clicking through dashboards every time a question pops up.
With this MCP, you ask your agent directly: 'What were John Smith's total pay run earnings and deductions last month?' You don't click anything. The data appears clean and ready to read right in the chat window.
KeyPay gives you immediate payroll visibility.
The MCP eliminates the need for manual status checks, like having to use `list_pay_runs` and then drill down into `get_pay_run_details` just to confirm if a pay period is final. It aggregates that complex data structure instantly.
You get real-time, comprehensive payroll visibility without ever leaving your chat interface. That's how efficient modern work should feel.
What KeyPay MCP does for your AI
Need to handle complex payroll tasks without logging into a web dashboard? This MCP lets your AI client talk directly to your KeyPay account. You can run checks across multiple business entities associated with the account or pull specific details about an employee's profile. Your agent handles everything from listing current pay runs and their detailed earnings down to tracking historical leave requests.
It also gives you immediate access to payslips for any worker, plus a way to inspect deduction lines to guarantee compliance accuracy. Because this connection is hosted on Vinkius, you get the benefit of having your payroll data available to any MCP-compatible client—whether that's Cursor or Claude. You just tell your agent what information you need, and it gets it for you.
019d75c0-b566-73f1-9109-23faf43a432e How to set up KeyPay MCP
The bottom line is that you delegate complex, multi-step HR data retrieval entirely to your AI client.
You subscribe to this MCP on Vinkius and provide your KeyPay API key and region domain.
Your AI client uses the credentials to connect, allowing it to access your payroll data across all linked businesses.
The agent executes specific tasks—like listing pay runs or fetching employee details—and returns clean, actionable data directly to you.
Who uses KeyPay MCP
This MCP is for the Payroll Administrator who spends hours cross-referencing spreadsheets; it's for the HR Manager who needs quick insights into employee leave and status; and for Business Owners needing instant visibility into payroll costs.
You use this MCP to check pay run statuses, list earnings, or inspect deduction lines without opening the KeyPay dashboard.
You monitor leave requests and query employee profiles using natural language prompts rather than navigating multiple internal forms.
You get instant, comprehensive reports on payroll costs by listing all businesses associated with the account or viewing pay run histories.
Benefits of connecting KeyPay MCP
Instantly check pay run status. Instead of navigating through dashboards to see if a pay period is 'Finalised' or pending, your agent uses get_pay_run_details to give you the current status right away.
Verify employee data on the fly. Need to know an employee’s active role or payroll setup? Use get_employee_details and get that information without ever leaving your chat interface.
Manage compliance checks easily. By running list_pay_run_deductions, you can quickly inspect every deduction line, making sure the records match local law before pay day.
Track time off effortlessly. The MCP lets you run list_leave_requests to monitor all pending or historical leave for a business without having to check multiple HR systems.
Get full visibility across companies. If your organization has multiple legal entities, use list_businesses first to scope the data before running payroll checks.
KeyPay MCP use cases
Investigating an employee's pay slip discrepancy
The HR manager notices a payslip looks wrong. They ask their agent, which then runs list_pay_slips and pulls the exact document details for review. Finally, they run list_pay_run_earnings to compare the listed earnings against the employee's base salary records.
Auditing a business unit’s payroll history
The CFO needs to see how many pay runs occurred in Q1. They use list_businesses first, then run list_pay_runs for the specific entity ID. This quickly builds a timeline of all paid periods.
Onboarding a new worker and checking their status
A team lead needs to confirm if John Doe is active and what his current title is. They ask the agent to use get_employee_details for John Doe, confirming his role before processing payroll.
Reviewing leave balance across all departments
The department head needs a quick headcount of available time off. By using list_leave_requests, they get an immediate summary of pending leave for their entire team, saving days of manual form checking.
KeyPay MCP tradeoffs
What to watch out for, and the recommended way to handle each one.
Trying to find data by name only
Asking the agent: 'Show me John Smith's pay slip from last month.' The system fails because it needs a specific employee ID or business reference, not just a common name.
First, use list_employees to get John Smith’s unique ID. Then, provide that ID when asking the agent to run list_pay_slips for him.
Assuming all businesses are linked
Running payroll checks on a new corporate entity without realizing it hasn't been registered in KeyPay yet. The tool returns an error because the business ID is unknown.
Always start by using list_businesses to confirm every legal entity you need data for, ensuring you scope your search correctly.
Overlooking deductions
Only querying basic earnings details and missing out on crucial information like tax withholding or superannuation contributions.
Always follow up any pay run query with list_pay_run_deductions to get the complete picture of how much money was taken out.
When to use KeyPay MCP
Use this MCP if your primary job involves pulling, comparing, or auditing structured data related to employee compensation, time off, or corporate structure. Specifically, if you need to check earnings against deductions, or verify a payroll run's final status across multiple businesses, this is the tool for you. Don't use it if your goal is to update records—this connection reads existing data; it doesn't change an employee's address or approve new leave requests. If you only need general company information outside of HR (like inventory counts), you should look at a different category MCP, not this payroll tool.
Frequently asked questions about KeyPay MCP
How do I check multiple businesses with KeyPay MCP? +
Use the list_businesses tool first to see all registered entities. You can then target specific companies by calling tools like list_pay_runs or get_employee_details using that business's ID.
Can I find an employee’s full details with KeyPay MCP? +
Yes. You run get_employee_details, and the agent pulls up their entire profile, including payroll configuration and current status, in one go.
Does KeyPay MCP help me calculate taxes? +
No, this MCP reads existing data; it doesn't perform calculations. However, you can use list_pay_run_deductions to verify what deductions were applied during a run for auditing purposes.
How do I get payslips using KeyPay MCP? +
You execute list_pay_slips. You just need to specify the employee and the period, and your agent retrieves all available payslip information for you.
What if I need data from a business that isn't listed? +
If you suspect an entity is missing, start by using list_businesses to confirm the full list. If it’s not there, you must contact your KeyPay administrator to get it added.