Deel MCP server

The Deel MCP server exposes Deel platform operations as tools that AI agents and assistants can invoke directly. It implements the Model Context Protocol (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:

CategoryDescriptionExample
OrganizationOperations that access organization-wide data. Require organization-level scopes.getListOfPeople, listItAssets
WorkerOperations scoped to an individual worker. Require worker-level authentication.createTimeOffRequest, getTimeOffRequests
PublicReference 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