# Paylocity MCP > Paylocity MCP connects your workflow directly to Paylocity HR and payroll data. Use this connector with any agent to list employees, audit benefits setup, track detailed earnings, and verify tax or direct deposit information instantly through natural conversation. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** workforce-management, employee-records, benefits-administration, payroll-processing, hr-analytics, onboarding ## Description Managing payroll and employee records shouldn't require jumping between multiple portals or running complex reports just to find one piece of information. This MCP lets you talk directly to Paylocity data using your agent. You can ask for a list of all current employees, pull up specific profiles, or check if an employee is still in the onboarding process. Need payroll details? You can inspect earning codes and deduction setups for any worker. Want compliance confirmation? Just ask it to retrieve local tax configurations or verify direct deposit settings against company rules. Because this connector sits on Vinkius, you get access to all these HR functions from one place, letting your AI client handle the heavy lifting of data retrieval. This means payroll managers can audit earnings and deductions, finance teams can reconcile complex financial data, and HR admins can check benefit status without ever touching the main portal. You treat it like a conversation; you get structured, actionable employee records back. ## Tools ### get_employee_benefit_setup Retrieves the benefit configuration details for a specified employee. ### get_employee_custom_fields Fetches unique custom data fields set up for an individual employee record. ### get_employee_deductions Gets a list of deductions and their details associated with an employee. ### get_employee_direct_deposit Retrieves the direct deposit setup information for an employee. ### get_employee_earnings Pulls detailed earning codes and amounts for a specific employee. ### get_employee_emergency_contacts Retrieves the emergency contact information for an employee. ### get_employee Gets general profile details for any specific employee record. ### get_employee_local_taxes Retrieves the local tax configuration setup for an individual employee. ### list_employees Generates a comprehensive list of all employees registered in the company system. ### list_onboarding_employees Lists names and statuses for employees who are currently going through the onboarding process. ## Prompt Examples **Prompt:** ``` List all employees in our company. ``` **Response:** ``` I've retrieved the employee list. There are 142 employees registered. Would you like to filter by status or search for a specific person? ``` **Prompt:** ``` Show me the earnings and deductions for employee 12345. ``` **Response:** ``` For employee 12345, earnings include 'Base Salary' and 'Monthly Bonus'. Deductions include 'Health Insurance' and '401k Contribution'. ``` **Prompt:** ``` Who is currently in the onboarding process? ``` **Response:** ``` I've fetched the onboarding list. There are 3 employees: 'Alice Brown', 'Michael Scott', and 'Dwight Schrute'. Alice is 80% complete. ``` ## Capabilities ### List all employees Retrieves a comprehensive list of every active employee in the company. ### Get detailed employee profiles Pulls full records for a single person, including contact information and job metadata. ### Audit compensation details Retrieves specific earnings codes, deduction setups, and benefit configurations for any worker. ### Verify payroll settings Checks critical financial data like local tax setup or direct deposit credentials. ### Track hiring status Lists all employees who are currently active in the onboarding pipeline. ## Use Cases ### Auditing a worker's full pay stub details A payroll manager needs to confirm if an employee received their correct bonus and that all required deductions were applied. Instead of pulling up the old payroll report, they simply ask their agent to check earnings using `get_employee_earnings` and then check deductions using `get_employee_deductions`. The agent provides both sets of figures in one response. ### Checking onboarding completion rates An HR administrator needs a headcount of new hires who are stuck in the process. They prompt their agent to use `list_onboarding_employees` and get an immediate list, which they then cross-reference with general employee details using `get_employee`. ### Validating tax compliance for a new state A finance team member is setting up paychecks in a different jurisdiction. They ask the agent to use `get_employee_local_taxes` and get immediate confirmation of the required local tax configuration, preventing a costly manual audit. ### Getting all employee contact info for an emergency A manager needs the primary contact and the secondary emergency contacts for three employees. They instruct their agent to run `get_employee` followed by `get_employee_emergency_contacts` on each person, gathering all necessary data in a single conversational flow. ## Benefits - Stop running multiple reports for basic info. Use `list_employees` to get an instant roster of all personnel without leaving your chat window. - Verify complex compensation details instantly. You can check both earnings (`get_employee_earnings`) and deductions (`get_employee_deductions`) for a full picture of pay. - Ensure compliance before payroll runs. Need to audit tax rules? Use `get_employee_local_taxes` or verify direct deposit settings using `get_employee_direct_deposit`. - Track hiring progress without calling HR. The `list_onboarding_employees` tool gives you a real-time count and status of new hires. - Access specialized data points easily. Beyond basic info, the MCP lets you pull custom field values using `get_employee_custom_fields` for specific reports. ## How It Works The bottom line is you get structured HR and payroll data delivered directly into your chat window or workflow without needing manual logins or exports. 1. Subscribe to this MCP and provide your Paylocity Client ID, Secret, and Company ID within your Vinkius account. 2. Connect your preferred AI agent (like Claude or Cursor) to the catalog via the required credentials. 3. Simply ask your agent a question—for example, 'What are Alice's local tax settings?'—and it executes the necessary function call. ## Frequently Asked Questions **How do I use the Paylocity MCP to find an employee's current benefits?** You run `get_employee_benefit_setup` and provide the employee identifier. This tool pulls the specific benefit plan configurations for that individual. **Can I check tax details using Paylocity MCP?** Yes, use the `get_employee_local_taxes` tool. It retrieves the local tax setup information needed to ensure compliance in different regions. **Does this MCP help me see all my staff members?** Absolutely. The `list_employees` function gives you a full, current roster of every employee registered in your company system. **What if I need to know about new hires? Does Paylocity MCP help?** The `list_onboarding_employees` tool is designed exactly for that. It quickly lists and tracks everyone currently in the onboarding process, giving you visibility into hiring progress. **Can I check direct deposit details with Paylocity MCP?** You can use `get_employee_direct_deposit`. This tool retrieves the specific banking and account setup information for payroll verification.