Tools reference

The Deel MCP server exposes tools that map to Deel API operations. Each tool accepts structured input parameters and returns JSON results. The AI client selects and invokes the appropriate tool based on the user prompt.

How tools work

MCP tools follow the JSON-RPC 2.0 protocol. When an AI agent determines that a Deel tool is needed, it sends a tools/call request to the MCP server with the tool name and input parameters. The server executes the corresponding API operation and returns the result.

Request format

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "listOfContracts",
    "arguments": {}
  }
}

Response format

A successful tool invocation returns a result with content:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"data\": [{\"id\": \"abc123\", \"title\": \"Software Engineer\", ...}]}"
      }
    ]
  }
}

If the tool execution fails, the response includes an isError flag:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Error: Insufficient permissions. The token requires contracts:read scope."
      }
    ],
    "isError": true
  }
}

Tool categories

Tools are organized by the domain they operate on. The table below groups tools by functional area.

Contracts and hiring

People and HRIS

Time off and scheduling

Payments and invoices

Payroll

Hiring intelligence

Benefits and compliance

Deel IT

Tools marked _beta are new endpoints whose behavior may change until the stable date given in the description the MCP server returns for the tool.

IT assets

IT orders

IT hardware policies

IT seats

IT clearance requests

IT agreements

IT products

IT warehouses

Onboarding and immigration

Organization and reference data

Next steps