manage_employee_benefit
Manage Employee Benefit
List, create, or update employee benefit enrollments. Enrolls employees in company-defined benefit plans with specified contribution amounts and deduction settings.
Ask your agent in plain language. Each of these maps to a real tool on the server.
manage_employee_benefit
List, create, or update employee benefit enrollments. Enrolls employees in company-defined benefit plans with specified contribution amounts and deduction settings.
manage_job_compensation
Manage employee jobs and compensations. Job list/create/update endpoints require an approved Embedded Payroll application. List jobs for an employee, create/update jobs, and manage compensation details (rate, payment unit, FLSA status). Jobs represent positions held by an employee, and each job can have multiple compensations with effective dating.
manage_contractor_payment
List contractor payments grouped by contractor and returned as individual payments. Creating or cancelling payments requires an approved Embedded Payroll application with payrolls:run. Use get_current_context to discover the authorized company.
manage_earning_type
List, create, or update custom earning types for a company. Earning types define categories of compensation (e.g., bonuses, commissions, tips) beyond standard types.
list_contractors
List contractors (1099 workers) for a company. Returns contractor profiles including names, types, and status.
list_employees
List employees for a company. Supports filtering by termination status and pagination. Returns employee profiles including names, emails, and employment details.
process_payroll
Request asynchronous payroll calculation or submission for an approved Embedded Payroll company. Gusto app integrations cannot run payroll. A successful response confirms acceptance; use get_payroll to verify the eventual processing outcome.
manage_employee
Create, update, retrieve, terminate, or rehire a W-2 employee. - To **create**: provide companyId, firstName, lastName, and optionally other fields. - To **get** or **update**: provide employeeId and any fields to update. - To **terminate**: provide employeeId and termination details. - To **rehire**: provide employeeId and rehire details.
manage_time_off
List time off policies for a company or retrieve an employee's time off activity for one exact type. Use company policies to identify the exact timeOffType required for get_balances.
manage_garnishment
List, create, or update wage garnishments for an employee. Supports ordinary garnishments with exact amounts and schedules; specialized child-support setup must be completed in Gusto.
manage_department
List, create, or update departments for a company. Departments help organize employees and can be used for reporting and payroll categorization.
manage_company_benefit
List, create, retrieve, or update company-level benefit types (health insurance, 401(k), HSA, etc.). Company benefits define the benefit plans available to employees.
list_pay_schedules
List pay schedules for a company. Pay schedules define the frequency and timing of payroll runs (weekly, biweekly, semi-monthly, monthly).
manage_company_location
List, create, or update company locations. Locations are used for tax jurisdiction purposes and employee work addresses.
get_company
Retrieve detailed information about a Gusto company, including its profile, locations, and configuration. Use this to look up company details by company ID.
get_payroll
Retrieve detailed information about a specific payroll, including employee compensations, taxes, deductions, and totals.
manage_contractor
Create, retrieve, or update a contractor (1099 worker). - To **create**: provide companyId, type, and contractor details. - To **get**: provide contractorId. - To **update**: provide contractorId and fields to change.
list_forms
List company or employee form metadata, or retrieve one form by ID. These endpoints require an approved Embedded Payroll application and company_forms:read or employee_forms:read. No form content or signing operation is returned.
list_payrolls
List payrolls for a company. Can filter by processing status and date range. Returns payroll summaries including pay period, status, and totals.
get_current_context
Discover the current Gusto token resource, resource owner, granted scopes and company UUID. Each OAuth grant targets one company; use this companyId in other tools. Name and email are omitted when the provider does not expose them.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Discover the authorized Gusto company, read personnel and payroll records, and manage documented benefits, locations, departments and compensation. Payroll processing, contractor payment writes, job management and form metadata require approved Embedded Payroll capabilities.
Common questions about connecting Gusto to AI agents with Metorial.