> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.deel.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.deel.com/_mcp/server.

# Deel MCP server

> Connect AI agents to the Deel platform using the Model Context Protocol

The Deel MCP server exposes Deel platform operations as tools that AI agents and assistants can invoke directly. It implements the [Model Context Protocol](https://modelcontextprotocol.io/) (MCP), an open standard for connecting AI models to external data sources and services.

The server communicates over HTTP using the JSON-RPC 2.0 protocol with Server-Sent Events (SSE) for streaming responses. The server URL is:

```
https://api.letsdeel.com/mcp
```

## How it works

MCP defines a standardized interface between AI clients (such as Cursor, VS Code, Claude Desktop, or ChatGPT) and servers that provide tools and resources. When an AI agent connects to the Deel MCP server, it discovers the available tools and can invoke them on behalf of the authenticated user.

Each tool maps to a Deel API operation. For example, the `listOfContracts` tool retrieves contracts, and the `createTimeOffRequest` tool submits a time-off request. The AI agent selects the appropriate tool based on the user prompt and constructs the required parameters.

## Tool categories

The Deel MCP server exposes tools across three permission levels:

| Category         | Description                                                                       | Example                                            |
| ---------------- | --------------------------------------------------------------------------------- | -------------------------------------------------- |
| **Organization** | Operations that access organization-wide data. Require organization-level scopes. | `getListOfPeople`, `listItAssets`                  |
| **Worker**       | Operations scoped to an individual worker. Require worker-level authentication.   | `createTimeOffRequest`, `getTimeOffRequests`       |
| **Public**       | Reference data that does not require user-specific permissions.                   | `retrieveCountries`, `retrieveSupportedCurrencies` |

## Prerequisites

Before connecting to the Deel MCP server, you need:

* **A Deel account** with API access enabled
* **Authentication credentials** using one of the following methods:
  * An OAuth2 application (recommended for MCP clients that support OAuth)
  * A personal access token (PAT) for clients that do not support OAuth

Most MCP clients (Cursor, VS Code, Claude Desktop, ChatGPT) handle the OAuth2 authorization flow automatically. You do not need to implement the flow manually unless you are building a custom MCP client.

## Next steps

#### [Authorization](/mcp/authorization)

Understand the OAuth2 discovery and authorization flow for MCP

#### [Connecting clients](/mcp/connecting-clients)

Set up your AI client to connect to the Deel MCP server

#### [Tools reference](/mcp/reference/tools-reference)

Browse the full list of available MCP tools

#### [OAuth2](/api/oauth)

Learn about OAuth2 authentication for the Deel API