# OnPay MCP > OnPay connects your AI client directly to payroll and HR data, letting you programmatically manage everything from employee profiles and payment history to pay schedules and subscriptions. Instead of jumping between multiple internal systems, your agent can pull specific company details or list all current employees in a single conversation. ## Overview - **Category:** human-resources - **Price:** Free - **Tags:** payroll, employee-records, tax-filing, benefits-administration, transaction-monitoring, hr-automation ## Description Need to audit employee records or run payroll calculations? OnPay gives your AI client direct access to the core data that runs your business. You get programmatic visibility into everything—employee profiles, historical transactions, and future pay cycles. Your agent can instantly list every active employee or retrieve detailed information about a specific payment transaction without needing manual API calls or dashboard navigation. This means you stop spending time cross-referencing sheets and start making decisions based on real data. By connecting OnPay via Vinkius, your AI client gains the capability to orchestrate complex HR workflows—from viewing active subscriptions to checking company financial item codes for reconciliation. It's simply giving your agent a full view of your payroll operations. ## Tools ### get_company_info Gets general information about the company associated with the account. ### get_employee Retrieves specific details for a single employee using their unique ID. ### get_transaction Pulls detailed information regarding one specific financial payment transaction. ### list_employees Retrieves a full list of every employee record in the system. ### list_item_codes Lists all available accounting item codes for financial tracking. ### list_pay_schedules Retrieves a list of upcoming and past company payroll schedules. ### list_subscriptions Lists all active or expired subscriptions managed by the platform. ### list_transactions Provides a comprehensive list of payment transactions that occurred. ## Prompt Examples **Prompt:** ``` List all active employees. ``` **Response:** ``` Fetching employees... I've found 15 active employees. Here are the first few... ``` ## Capabilities ### Gathering core company details The MCP can retrieve general information about the associated business entity. ### Accessing employee records It provides detailed profiles for individual employees and can list every person currently registered in the system. ### Monitoring payment history You can pull historical data on payments, including status updates and transaction details. ### Scheduling and payroll oversight The agent monitors upcoming pay cycles and tracks active subscription records for the company. ### Financial code retrieval It pulls necessary item codes and general company settings needed for accounting reconciliation. ## Use Cases ### Running a quick audit on employee status. The HR Manager needs to verify who has been hired and paid in the last quarter. They ask their agent, 'Show me all active employees.' The MCP uses `list_employees` to generate the current roster, saving hours of spreadsheet filtering. ### Investigating a payment discrepancy. A team member reports an incorrect payout amount. Instead of calling customer support, the Payroll Admin asks the agent to use `get_transaction` for that specific date and ID. They get the precise details needed to resolve the issue instantly. ### Preparing for tax filing. The Financial Analyst needs a list of all service subscriptions to calculate accrued revenue. They prompt their agent, 'List all current subscriptions.' The MCP uses `list_subscriptions` and provides the complete record set. ### Planning future payroll runs. The Operations Director wants to know when the next three pay cycles are scheduled. Asking the agent to use `list_pay_schedules` gives them a clear timeline, allowing them to pre-warn department heads. ## Benefits - Stop juggling tabs. Instead of manually listing employees in a separate dashboard, you simply tell your agent to call `list_employees`, and the full list appears immediately for review. - Never lose track of payments again. You can ask the MCP to fetch details on any payment using `get_transaction` or pull an entire history with `list_transactions`. It's instant audit capability. - Stay ahead of pay dates. Use `list_pay_schedules` to monitor upcoming cycles and ensure your team knows exactly when payroll is running, preventing delays and confusion. - Financial accuracy matters. When reconciling accounts, you don't have to guess item codes; the MCP pulls them for you using `list_item_codes`. - Keep track of revenue streams by calling `list_subscriptions`, which immediately shows whether a client is active or if their service ended. ## How It Works The bottom line is, you get to use complex HR data—like listing payment transactions or checking pay schedules—without writing a single line of code. 1. Subscribe to the OnPay MCP on Vinkius. 2. Provide your unique OnPay API Token from your management panel. 3. Your AI client can now access and manage payroll operations through natural conversation. ## Frequently Asked Questions **How do I find out if a payment went through using OnPay MCP?** You can check transaction status by calling `list_transactions` for an overview, or use `get_transaction` with the specific ID. This gives you immediate confirmation on whether the funds were processed. **Can I use OnPay MCP to list all employees?** Yes, simply call the `list_employees` tool. It provides a comprehensive roster of everyone recorded in your system for immediate review. **Does OnPay MCP help with tax filing?** While this MCP gives you access to financial data via `list_item_codes`, it is designed for data retrieval and reporting. You still need specialized accounting software for the actual tax submission. **What if I need company-wide info? Should I use OnPay MCP?** Yes, running `get_company_info` pulls general details about your business entity. This is useful before starting any complex payroll calculation or audit.