> This page is for Agent Handler. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. # Deel **Authentication:** OAuth or API token. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app. ## Sample use cases * List all active EOR contracts for our engineering team. * Create a time-off request for a contractor next week. * Show me the legal entities and their working locations. * Update the work location for a newly relocated employee. ## Available Tools #### list\_contracts List contracts in the organization. Filter server-side by type, status, team, legal entity, country, currency, or a t... #### get\_contract Get a single contract by id. Use list\_contracts to find valid IDs. #### create\_contract Create an independent-contractor (IC) contract. Discover required IDs first: list\_groups (team\_id), list\_legal\_entiti... #### terminate\_contract Terminate a non-EOR contract (independent-contractor, PAYG, etc). Use terminate\_eor\_contract instead for contracts wh... #### terminate\_eor\_contract Initiate offboarding/termination for an EOR (Employer of Record) contract. Use terminate\_contract instead for non-EOR... #### amend\_contract Amend an existing contract's terms (compensation, job title, seniority, scope of work, etc). Only send the fields tha... #### list\_contract\_termination\_reasons List contract termination reasons available in this organization. Use for terminate\_contract's termination\_reason\_id. #### discover\_person\_custom\_fields List the custom field definitions available on people profiles in this organization (name, type, and whether required... #### get\_person\_custom\_fields Get the custom field values set on one person's profile. Use list\_people to find the worker id, and discover\_person\_c... #### set\_person\_custom\_fields Set a custom field's value on one person's profile. Use list\_people to find the worker id, and discover\_person\_custom... #### list\_groups List groups (teams) in the organization. Use this to find team/group IDs for other tools. #### create\_group Create a group (team). #### update\_group Rename a group (team). Use list\_groups to find valid IDs. #### delete\_group Archive (delete) a group by id. Use list\_groups to find valid IDs. #### list\_legal\_entities List legal entities in the organization. Use this to find legal\_entity\_id for create\_contract. #### list\_job\_titles List job titles available in this organization. Use for create\_contract's job\_title\_id. #### list\_countries List countries supported by Deel, with ISO codes. Use for create\_contract's country\_code. #### list\_seniority\_levels List seniority levels available in this organization. Use for create\_contract's seniority\_id. #### list\_currencies List supported currencies (ISO 4217 codes). Use for create\_contract's compensation\_details currency. #### list\_time\_off\_types List global time-off category names (e.g. VACATION, SICK\_LEAVE) for reference only — these are not valid time\_off\_typ... #### list\_working\_locations List working locations configured for this organization. Use for update\_person\_work\_location's working\_location\_id. #### list\_organization\_structures List organization structures (team hierarchies, roles) for this organization. #### list\_people List people (HRIS profiles) in the organization. Supports search by name, and filtering by team, hiring status, hirin... #### get\_person Get a single person's HRIS profile by id. Use list\_people to find valid IDs. #### update\_person\_work\_location Update a person's working location. Use list\_people to find the HRIS profile id, and list\_working\_locations to find a... #### list\_time\_off\_policies List the time-off policies available to one HRIS profile (e.g. vacation, sick leave). Use list\_people to find the hri... #### list\_time\_off\_requests List existing time-off requests for one HRIS profile, with their id, status, and dates. Use list\_people to find the h... #### create\_time\_off\_request Create a time-off request for a person. Use list\_people to find recipient\_profile\_id, and list\_time\_off\_policies for... #### update\_time\_off\_request Update an existing time-off request. Use list\_time\_off\_requests to find the request id first. #### review\_time\_off\_request Approve or reject one or more time-off requests in a single call. Use list\_time\_off\_requests to find pending request... #### delete\_time\_off\_request Cancel (delete) a time-off request by id. Use list\_time\_off\_requests to find the request id first. This immediately s... #### list\_webhooks List webhook subscriptions registered for this organization. #### create\_webhook Create a webhook subscription. Use list\_webhook\_event\_types to find valid event names for the events list. #### update\_webhook Update a webhook subscription's status (enabled/disabled) or child-org visibility. Use list\_webhooks to find valid ID... #### delete\_webhook Delete a webhook subscription by id. Use list\_webhooks to find valid IDs. #### list\_webhook\_event\_types List the webhook event types available for subscription. Use for create\_webhook's events list.