# Gusto MCP

> Gusto connects your AI agent directly to employee data and payroll records. Instead of logging into separate HR portals for benefits, time-off, and compensation details, you can ask your client anything about your workforce—like checking a specific employee's PTO balance or listing all current company locations—and get the structured answer instantly.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** payroll-processing, employee-management, benefits-administration, tax-compliance, time-off

## Description

Connecting Gusto gives your AI agent immediate access to complex human resources data. It handles everything from employee records and organizational structure to payroll runs, benefits plans, and time-off policies. You can ask simple questions like, 'What is the PTO policy for new hires?' or 'Show me the total gross pay for last month.' Your agent compiles this sensitive information using conversational logic, pulling together details normally spread across dozens of tabs. This means your team doesn't have to jump between different HR systems just to answer a single question. By connecting through Vinkius, you give your AI client a centralized source of truth for payroll and employee management, turning complicated data retrieval into simple conversation.

## Tools

### list_companies
Retrieves a list of all company entities managed within the system.

### list_time_off_policies
Lists all configured policies related to paid time off, including rules for accrual.

### get_company
Gets specific configuration and identification details for a single company.

### list_employees
Provides a comprehensive list of all staff members working in the organization.

### get_employee
Retrieves full personal and professional details for one specific employee.

### list_payrolls
Provides an overview of all past payroll runs, including dates and totals.

### get_payroll
Gets detailed metrics and records for a specific payroll run date.

### list_locations
Retrieves a list of all physical office locations tied to the company.

### list_departments
Retrieves a list of all functional departments within the company structure.

### list_benefits
Lists the various benefits offered to employees, along with their enrollment statuses.

## Prompt Examples

**Prompt:** 
```
Show all employees in the engineering department.
```

**Response:** 
```
Found 12 engineers:

| Name | Title | Start Date |
|------|-------|------------|
| Sarah Chen | Senior Engineer | Jan 2024 |
| Alex Rivera | Staff Engineer | Mar 2023 |
...
```

**Prompt:** 
```
Show me the last payroll run details.
```

**Response:** 
```
📊 Payroll Run — March 31, 2026

| Metric | Value |
|--------|-------|
| Total Gross | $245,000 |
| Federal Tax | -$48,500 |
| State Tax | -$12,200 |
| Net Pay | $184,300 |
| Employees | 34 |
```

**Prompt:** 
```
List all time-off policies.
```

**Response:** 
```
3 policies configured:

1. **Unlimited PTO** — Salaried employees
2. **Sick Leave** — 10 days/year, accrual-based
3. **Parental Leave** — 12 weeks paid
```

## Capabilities

### Reviewing Employee Records
Retrieve detailed profiles for any staff member, including their compensation history and departmental assignments.

### Calculating Payroll Metrics
Access past payroll runs to see total gross earnings, tax deductions, and net pay totals for specific periods or groups.

### Checking Leave Policies
List all current time-off policies—sick leave, vacation, etc.—and their associated accrual rules.

### Auditing Benefits Packages
View details on available benefits, such as health plans and 401k options, along with enrollment information.

### Mapping Company Structure
Get a clear view of the company's physical locations, departments, and overall organizational hierarchy.

## Use Cases

### Answering a new hire's policy question
A new hire asks their agent, 'What is the PTO balance and how do I enroll in health insurance?' The agent runs `list_time_off_policies` and then uses `list_benefits`, providing a complete answer immediately.

### Auditing departmental staffing
The manager needs to know all staff assigned to the 'Engineering' department. They ask their agent, which runs `list_departments` followed by `list_employees`, giving them an accurate roster and title list.

### Calculating year-end payouts
The finance team needs to compare total gross wages against deductions from the last quarter. They prompt for payroll data, letting the agent run `list_payrolls` and then `get_payroll` to verify numbers.

### Reorganizing office staff
The Ops team is planning a merger and needs all active company locations. They ask their agent, which runs `list_locations`, providing the full list of physical sites to factor into their plan.

## Benefits

- Stop manually checking multiple tabs. With this MCP, you can ask your agent to list employees in a specific department or location, getting the full roster without leaving your chat window.
- Verify complex payouts fast. Instead of cross-referencing spreadsheets, just ask for payroll run details using `get_payroll` and see exactly how taxes and deductions were calculated.
- Manage compliance data easily. You can list all time-off policies or view employee profiles to confirm who is eligible for parental leave according to policy.
- Map out your organization instantly. Quickly use `list_departments` and `list_locations` to understand the full scope of your company's physical presence and internal structure.
- Get benefit answers immediately. Need to know if an employee has health coverage? Use `list_benefits` to retrieve enrollment information, making benefits questions simple.

## How It Works

The bottom line is you get instant, accurate answers about HR and payroll using natural conversation.

1. You connect your preferred AI client to this Gusto MCP via Vinkius.
2. Your agent identifies the information needed (e.g., 'What is the sick leave policy for employees in Department X?').
3. The MCP executes the necessary tool call, retrieving structured data that your agent then translates into a plain language answer.

## Frequently Asked Questions

**Can the Gusto MCP list all company locations?**
Yes, you can use the `list_locations` tool to get a comprehensive roster of every physical office site tied to your organization.

**How do I check an employee's current pay rate with Gusto MCP?**
You need to run `get_employee`. This specific function pulls the detailed records, including compensation and salary information for that staff member.

**What if I want to see all benefits offered? Does Gusto MCP support this?**
The MCP supports viewing available perks via `list_benefits`. This shows details on health plans, dental coverage, and any other enrolled options.

**Can the Gusto MCP help with payroll taxes?**
Yes. You use `list_payrolls` to see a history of runs, and then `get_payroll` gives you the exact tax amounts and deductions applied for a specific pay date.

**Does Gusto MCP handle time-off accrual rates?**
The tool supports this. By using `list_time_off_policies`, your agent can read the current rules, like how many days are accrued per month or year.