# PayFit MCP > PayFit connects your AI agent directly to PayFit Global Payroll. Get structured access to sensitive HR and accounting data—like employee lists, contract statuses, payslip records, and general ledger entries—without manual exports or web logins. This MCP lets you ask complex questions about payroll compliance and corporate structure using plain language. ## Overview - **Category:** human-resources - **Price:** Free - **Tags:** payroll-automation, employee-management, compliance, payslips, accounting-integration, hr-operations ## Description Need to audit active employee records or pull quarterly financials? PayFit gives your AI agent a secure bridge into your company's HR and accounting backend. Instead of logging into multiple portals, you talk to your agent, and it performs the necessary data fetches. You can ask for an overview of corporate settings to determine mapping addresses, list every current collaborator and their contract status, or pull specific payslip details for compliance checks. Plus, you can generate valid accounting entries directly via chat. This integration brings that payroll truth right into your workflow, making sure your AI client—whether it's in Claude, Cursor, or any other compatible app—has the exact data it needs to work. ## Tools ### get_company Retrieves fundamental metadata about your PayFit company account, like its primary address and internal module count. ### list_collaborators Fetches a complete list of all current employees in the system. ### get_collaborator_details Pulls specific information about one individual employee, including their roles and department assignments. ### list_contracts Provides a comprehensive list of all employment agreements held within the company. ### list_payslips Gets a list of payslip records for an employee, allowing you to track payroll history. ### list_departments Lists all distinct departments currently operating within the organization. ### get_accounting_entries Generates valid accounting ledger entries for a specified payroll period (in YYYYMM format). ## Prompt Examples **Prompt:** ``` Fetch the metadata configuration belonging to our main running PayFit company entity. ``` **Response:** ``` Connected successfully via `get_company`. The explicit bounds show entity 'Vinkius Global'. Registration country boundary set internally to 'FR'. Total active modules detected natively: 4. Would you like me to parse the connected departments next? ``` **Prompt:** ``` Scan our active architecture fetching a strict list of all collaborators and contracts. ``` **Response:** ``` Invoked explicitly bounding lists targeting `collaborators`. The array returned 40 limits natively. 1: Alice Engineering (ID xy1...). 2: John Security (ID zw2...). I also pulled their relative contract states logic. Ask me specifically for Alice's limits. ``` **Prompt:** ``` Retrieve global accounting transactions executed during March. ``` **Response:** ``` Pulled exact structures hitting `get_accounting_entries`. The payload reveals 12 distinct localized payroll ledger objects matching explicit debit and credit rules. Should I serialize these dynamically strictly into a table visual format for your review? ``` ## Capabilities ### Audit Corporate Structure Get a high-level overview of your company account, including department boundaries and payroll limits. ### Manage Employee Roster Find specific employees or list the entire team roster within the company. ### Track Employment Status View all active employee contracts and details about any single collaborator's status. ### Fetch Payroll History Retrieve masked, secure data for specific payslips run by an employee. ### Generate Financial Ledgers Pull validated accounting entries matching a specific payroll period for financial records. ## Use Cases ### Reconciling Payroll Discrepancies A finance analyst needs to verify if the general ledger matches the actual employee payouts. They ask their agent: 'Get accounting entries for March 2024 and compare them to all active collaborators.' The agent executes `get_accounting_entries` and cross-references it with data from `list_collaborators`, delivering a clear variance report. ### Auditing Contract Status A People Ops manager suspects an employee's contract might be outdated. They instruct their agent to run through 'list contracts' and then use `get_collaborator_details` on the specific ID, getting immediate confirmation of the current status. ### Quarterly Department Review A corporate administrator wants to know which departments are active before planning a new payroll system. They ask the agent to run `list_departments` and then use `get_company` to confirm the overall company structure limits for those divisions. ### Year-End Reporting A user needs historical data on paychecks for tax filing. They ask the agent to 'list payslips' for a given employee ID, fetching all required masked payroll records in one go. ## Benefits - Stop relying on manual data exports. By using `get_accounting_entries`, you can directly feed validated payroll ledger objects into your ERP ingestion pipelines, making reconciliation instant. - Audit employee compliance instantly. Instead of clicking through multiple screens, simply use `list_collaborators` to get the full roster and then check individual contract status with `get_collaborator_details`. - Streamline onboarding checks. Quickly list all active departments using `list_departments` and cross-reference them against department structures to ensure proper payroll allocation. - Simplify history requests. Need a payslip from last quarter? Use `list_payslips` to fetch the masked data and confirm compliance outputs without needing old credentials or PDFs. - Know your corporate boundaries. Start with `get_company` to pull core metadata, immediately giving you context on mapping addresses and overall payroll limits. ## How It Works The bottom line is: you never have to copy-paste payroll or HR data from a web browser again. 1. First, subscribe to this MCP and provide your PayFit Company ID and active API Key. 2. Next, tell your agent what data you need; for example, 'List all departments' or 'Get the accounting entries for June 2024'. 3. Finally, the MCP executes the request against PayFit and returns structured data that your AI client can interpret directly. ## Frequently Asked Questions **How do I use PayFit MCP to find all employee contracts?** Use `list_contracts` to get a comprehensive list of every employment agreement in the company. This tool provides an overview without needing individual IDs. **Can PayFit MCP help me reconcile accounting entries?** Yes, you can use `get_accounting_entries` by providing the specific payroll period (YYYYMM). The resulting data is structured for direct financial comparison and analysis. **Which tool do I use to get a list of active employees?** The correct tool is `list_collaborators`. This fetches all current employee IDs and basic details, which you can then cross-reference with other tools like `get_collaborator_details`. **Is PayFit MCP useful for auditing departments?** Yes. You can first run `list_departments` to see all divisions and then use `get_company` to confirm the overall corporate structure that governs those departments. **How do I get payslip data using PayFit MCP?** Use `list_payslips`, specifying the collaborator's ID. This fetches secure, masked payroll records for compliance checks without needing to access the original documents.