Retrieve country-specific employment requirements from the Oyster API for each target country before creating an employment record
Create the employment record with validated fields; Oyster validates against local law requirements and returns field-level errors on non-compliance
Monitor the employment status via webhooks — subscribe to contract_changes events to detect when contract terms change due to local law updates
When Oyster pushes a compliance update webhook, retrieve the updated employment details and surface required employer actions (e.g., salary floor increases, mandatory benefit adjustments)
Confirm employer acknowledgment of compliance changes via the API to unblock payroll processing
Maintain a per-country record of compliance acknowledgments and contract change timestamps for HR audit trails
Known gotchas
Oyster covers 180+ countries but API-accessible employment creation is supported for a subset — verify programmatic hiring is available in your target country before building automated onboarding flows
Local minimum wage and mandatory benefit floors change frequently; relying on hardcoded country rules in your application rather than Oyster's validation layer will cause compliance drift
The Benefits webhooks and Contract Changes webhooks were released in May 2025 — integrations built before that date may not yet be subscribed; ensure your webhook configuration includes these new event types
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