# Finch MCP for AI Agents AI Agent Connect > Finch MCP lets you automate HRIS and payroll tasks. It connects to your HR data so your AI agent can list employees, pull compensation details, and check pay statements without you having to jump between different portals. It's built for teams who need to move data between payroll systems and internal tools quickly. ## Overview - **Category:** human-resources - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_3qjM4sorxc6Qca4rtgYz4vadnDgVPz4Y5UYy5nLV/ai-agent-connect - **Tags:** hris, employee-data, payroll-integration, unified-api, employment-records, benefits-administration ## Description Finch is the connector you need to pull HR and payroll data into your AI workflow without the usual headache of manual exports. Instead of logging into three different portals to find a new hire's salary or check a pay group, you can just ask your agent to do it for you. This Connector acts as a single bridge to all your HRIS and payroll providers, meaning you don't have to worry about the underlying connections. When you use this through the Vinkius catalog, your agent gains the ability to see the full picture of your workforce. You can pull specific employment records, monitor sync jobs to make sure your data is moving correctly, and even check your connection permissions on the fly. It turns a mess of scattered HR records into a clean, queryable source of truth that lives right inside your chat window. ## Tools ### get_company Retrieve organization details like your legal name, EIN, and primary address. Use this to get high-level company metadata quickly. ### get_employment Pull job titles, salaries, and department info for a specific person. This is great for checking individual compensation details. ### get_individual Get personal details like names, emails, and SSNs for an individual. Use this when you need to find specific contact info for a staff member. ### get_me Check the details of the current authorized user connection. This confirms which account your agent is currently using. ### introspect Check your current connection status and active permissions. Use it to see exactly what actions your agent is allowed to perform. ### list_automated_jobs See a list of all automated data sync jobs. This lets you monitor the health of your data integrations at a glance. ### list_directory Read the full employee directory for your organization. Use this to get a complete list of everyone on your team. ### list_pay_groups View all pay groups associated with your organization. This helps you see how different departments are grouped for payroll. ### list_pay_statements Get a list of pay statements for a specific payment ID. Use this to audit payments and verify gross pay totals. ### list_supported_providers See all HRIS and payroll providers that Finch can connect to. Use this to check if your current provider is supported. ### get_automated_job Get specific details about a single automated data sync job. This helps you verify that your HRIS data is moving correctly. ## Prompt Examples **Prompt:** ``` Who is in the marketing department and what are their titles? ``` **Response:** ``` I've pulled the employee directory for you. Here are the team members in Marketing: | Name | Job Title | | :--- | :--- | | Alice Johnson | Marketing Director | | Bob Smith | Content Specialist | | Charlie Davis | SEO Lead | Would you like to see the compensation details for any of these individuals? ``` **Prompt:** ``` Check the status of my connection to Gusto. ``` **Response:** ``` Checking your connection status now... **Connection Status:** Active **Provider:** Gusto **Permissions:** - Directory: ✅ - Employment: ✅ - Payments: ✅ Your agent is fully authorized to manage these records. ``` **Prompt:** ``` List pay statements for payment pmt_123. ``` **Response:** ``` I've retrieved the statements for payment **pmt_123**: - **Total Statements:** 12 - **Total Gross Pay:** $54,000.00 - **Status:** Completed Would you like me to pull the individual breakdown for a specific employee from this list? ``` ## Capabilities ### Pull employee directory records Get a full list of everyone in your organization. ### Fetch individual employment details Retrieve specific job titles, salaries, and departments for any staff member. ### Monitor payroll statements Access pay groups and specific payment records to track compensation. ### Check connection status Verify your permissions and the health of your HRIS integration. ### Track data sync jobs See the status of automated jobs to ensure your HRIS data stays current. ### Identify supported providers See which HRIS and payroll providers your agent can talk to. ## Use Cases ### Onboarding a new hire An HR manager asks the agent to pull a new hire's profile and check their department. The agent uses get_employment and get_individual to gather all the info at once. ### Monthly payroll audit A finance lead asks for a list of pay statements for a specific payment ID to verify totals. The agent uses list_pay_statements to provide a clear summary of the payment. ### Data sync troubleshooting An admin asks the agent to check if the latest HRIS sync job finished successfully. The agent uses list_automated_jobs to check the status of the data flow. ### Salary research A manager asks the agent to find the salary range and job title for a specific role in the engineering department. The agent uses get_employment to pull the relevant data. ## Benefits - Skip manual exports: Use list_directory to get your full staff list instantly instead of downloading CSVs. This saves you from the repetitive task of cleaning and re-uploading data. - Verify payroll quickly: Use list_pay_statements to check payment records without logging into your payroll provider. You can confirm totals and count payments in a few seconds. - Keep data in sync: Use list_automated_jobs to monitor your data flow and ensure your HRIS records are current. You'll know immediately if a sync fails or hangs. - Audit permissions easily: Use introspect to see exactly what your agent can access across your HRIS. This helps you maintain security without having to guess what the connection can do. - Unified HR access: Connect to multiple providers at once so you don't have to manage separate integrations. It puts all your HRIS and payroll data into one single chat interface. ## How It Works The bottom line is you get a unified way to manage HR and payroll data through a single chat interface. 1. Subscribe to the Finch MCP on Vinkius. 2. Provide your Finch Access Token from your Finch Connect account. 3. Ask your agent to pull employee data or payroll statements. ## Frequently Asked Questions **What can the Finch MCP do for my HR team?** The Finch MCP lets your AI agent pull employee records and payroll data directly from your HRIS. You can get staff lists, check salaries, and monitor your data syncs without leaving your chat window. **Can I use Finch MCP to see pay statements?** Yes, you can use it to pull pay statements for specific payment IDs. This is helpful for quickly checking gross pay totals and verifying payments for your team. **How does Finch MCP handle multiple payroll providers?** Finch acts as a unified bridge. It connects to various HRIS and payroll providers, giving your AI agent a single way to access all your data regardless of which platform you use. **Can my agent check HRIS sync status?** Yes, it can see a list of all your automated data sync jobs. This lets you verify that your records are moving correctly and identify any issues with your HRIS data flow. **Does Finch MCP help with employee directory lookups?** It does. Your agent can read the full employee directory to find staff members, job titles, and department information instantly. **How do I see what permissions my agent has?** You can ask your agent to introspect the connection. It will show you exactly what permissions are active, such as access to the directory, employment records, or payments. **How do I obtain a Finch Access Token?** Access tokens are generated when a user successfully completes the Finch Connect authorization flow for their specific HRIS or payroll provider. **Which HRIS providers does Finch support?** Finch supports over 200 providers including Gusto, ADP, Workday, BambooHR, and Rippling. You can use the `list_supported_providers` tool to see the full list flawlessy. **Can I see individual pay statements?** Yes! The `list_pay_statements` tool allows you to retrieve payment details for individuals if the connected organization has granted the necessary payroll permissions flawlessy.