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

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "method": "tools/call",
5
  "params": {
6
    "name": "listOfContracts",
7
    "arguments": {}
8
  }
9
}

Response format

A successful tool invocation returns a result with content:

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "content": [
6
      {
7
        "type": "text",
8
        "text": "{\"data\": [{\"id\": \"abc123\", \"title\": \"Software Engineer\", ...}]}"
9
      }
10
    ]
11
  }
12
}

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

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "content": [
6
      {
7
        "type": "text",
8
        "text": "Error: Insufficient permissions. The token requires contracts:read scope."
9
      }
10
    ],
11
    "isError": true
12
  }
13
}

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

IT assets

Onboarding and immigration

Organization and reference data

Next steps