Retrieve the list of company benefit plans offered by the company using the GET /v1/companies/{company_id}/company_benefits endpoint to identify available benefit types and IDs.
For each desired benefit, fetch employee-level eligibility and contribution details via GET /v1/employees/{employee_id}/employee_benefits.
Create or update an employee benefit enrollment by sending a PUT or POST to /v1/employees/{employee_id}/employee_benefits with the company_benefit_id, active flag, and employee/employer contribution amounts or percentages.
Confirm the enrollment is active by re-fetching the employee benefits and verifying the active field is true and contribution amounts match.
If the benefit is medical/dental/vision, check that the coverage start date aligns with the employee's hire date or qualifying life event date to avoid retroactive coverage gaps.
Known gotchas
Contribution amounts for pretax benefits (HSA, FSA, health premiums) must not exceed IRS annual limits; the API does not enforce these limits and will accept out-of-range values silently.
Deactivating a benefit mid-year may trigger ACA or COBRA obligations — the API does not warn you; downstream compliance steps must be handled separately.
Some benefit types (e.g., HSA) require the employee to also be enrolled in a qualifying High Deductible Health Plan (HDHP); the API does not validate this dependency.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp