# Finch MCP > Finch connects your AI agent directly to structured HRIS and payroll data. You can list employees, get specific employment details like salary or department, and retrieve pay statements without leaving your chat interface. Stop exporting spreadsheets; start asking questions. ## Overview - **Category:** human-resources - **Price:** Free - **Tags:** hris, employee-data, payroll-integration, unified-api, employment-records, benefits-administration ## Description Managing employee records and running payroll doesn't have to mean switching between five different portals and dealing with endless CSV downloads. Finch acts as the single API layer for all your HR and payroll data sources. Your AI client can interact directly with your company’s core systems, pulling precise information on demand. Need to know if a new hire is fully set up? Ask the agent to read the employee directory or check their specific job title and department using employment details. Dealing with quarterly reviews? Fetch individual profiles or organizational data like EINs instantly. Payroll questions are solved by listing pay groups or pulling detailed statements for specific payment IDs. This integration simplifies complex enterprise data retrieval, allowing your chat workflow to handle tasks previously reserved for specialized HR software. By connecting through Vinkius, you get immediate access to this unified API layer from any MCP-compatible client, making payroll transparency and workforce management simple natural language queries away. ## Tools ### get_automated_job Retrieves specific details about an automated data synchronization task. ### get_company Pulls core organizational legal information, such as the company's name and EIN. ### get_employment Gathers specific employment data for one person, including their job title, department, and salary band. ### get_individual Fetches sensitive personal identifying information (PII) like email addresses or SSNs for a user. ### get_me Shows the connection details and scope of permissions authorized by your account. ### introspect Checks the current status, provider name, and granted permissions for the entire connected service. ### list_automated_jobs Lists all data synchronization jobs that are currently running or scheduled. ### list_directory Reads and returns the entire employee roster for the connected company. ### list_pay_groups Lists all defined pay groups or salary structures used within the organization's payroll system. ### list_pay_statements Retrieves a list of pay statements associated with a specific payment ID. ### list_supported_providers Shows which HRIS and payroll software systems are compatible with this MCP. ## Prompt Examples **Prompt:** ``` List all employees in the directory. ``` **Response:** ``` I've retrieved the employee directory. You have 45 individuals registered, including 'Alice Johnson' (Marketing) and 'Bob Smith' (Engineering). Would you like to see the employment details for any of them? ``` **Prompt:** ``` Check the status of my connection to Gusto. ``` **Response:** ``` Introspecting connection... Your connection to Gusto is active and authorized. You have permissions for 'directory', 'employment', and 'payment'. Shall I fetch the latest organization metadata? ``` **Prompt:** ``` List pay statements for payment ID pmt_123. ``` **Response:** ``` Retrieving pay statements... For payment pmt_123, I found statements for 12 employees. The total gross pay was $54,000. Would you like to see the individual breakdown for any specific employee? ``` ## Capabilities ### Inventory Employee Roster Read the complete directory of employees connected to your organization. ### Extract Employment Details Get specific professional information for an employee, including their salary and department. ### Fetch Personal Records Retrieve sensitive personal data like names, emails, or Social Security Numbers for any individual. ### Monitor Payroll Flow List pay groups and pull detailed statements using a specific payment ID to verify payroll totals. ### Check System Status Verify the connection health, permissions, and current status of your HRIS integration. ## Use Cases ### Verifying Employee Status Changes A Product Manager needs to confirm if a department budget change affects three key employees. They ask their agent, who uses `list_directory` first, then runs `get_employment` on each person, providing an immediate summary of all titles and salaries. ### Auditing Quarterly Payroll A Finance Analyst needs to confirm the total gross pay for a specific payment period. They ask their agent to list pay statements using `list_pay_statements`, which aggregates records across multiple employees into one readable summary. ### Onboarding Data Verification An HR Specialist is setting up a new tool and needs baseline company data. They ask for the legal entity details, triggering `get_company` to pull accurate EINs and full legal names without navigating forms. ### Cross-referencing Employee PII A compliance officer must verify the email address and SSN of a former employee. They ask their agent, which triggers `get_individual`, ensuring they get the most accurate personal data directly into their workflow. ## Benefits - Stop manual exports. Instead of downloading and cross-referencing spreadsheets, ask your agent to list the entire employee directory or check individual employment details directly in chat. - Verify compliance instantly. Use the `introspect` tool to confirm exactly what data permissions you have before running a complex query, ensuring you only access necessary records. - Streamline payroll audits. Instead of jumping into a separate portal, ask your agent to list pay statements or check defined pay groups using `list_pay_groups`, getting the totals right away. - Get organizational context fast. Quickly pull core company data like legal names and EINs with `get_company` so you don't have to search multiple internal knowledge bases. - Track system health without logging in. Run a check using `list_automated_jobs` to ensure your HRIS data sync jobs are running smoothly in the background. ## How It Works The bottom line is: you use natural language prompts to execute complex HR and payroll API calls without writing any code or exporting data. 1. Subscribe to this MCP and provide your Finch Access Token. 2. Connect your preferred AI client (like Claude or Cursor) to the Vinkius Catalog. 3. Ask your agent a question, such as 'What was the total gross pay for March?' The agent runs the query against the connected data. ## Frequently Asked Questions **How do I check my connection permissions using Finch MCP?** You can use the `introspect` tool to see exactly what data your agent has access to and what provider it is connected to. This ensures you know the scope of the data before running a major query. **Can I list all employees in Finch MCP?** Yes, simply call `list_directory`. This tool reads the full employee roster for your organization, giving you an immediate view of every connected user. **What is the best way to check payroll data with Finch MCP?** To verify pay totals, use `list_pay_statements` by providing a specific payment ID. You can also call `list_pay_groups` first to understand the salary structure. **Does Finch MCP help with onboarding new hires?** It helps dramatically. By using `get_employment`, you pull structured data about job titles and departments, which is crucial for ensuring new accounts are set up correctly across multiple internal systems.