For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
SupportDeel Home
Overview
Overview
  • Resources
    • Blog
    • Community
  • Get Started
    • Introduction
    • Authorization
    • Connecting clients
  • Reference
    • Tools reference
    • Error handling
  • Guides
    • Best practices
LogoLogo
SupportDeel Home
On this page
  • How it works
  • Tool categories
  • Prerequisites
  • Next steps
Get Started

Deel MCP server

Was this page helpful?

Authorization

Next
Built with

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

Authorization

Understand the OAuth2 discovery and authorization flow for MCP

Connecting clients

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

Tools reference

Browse the full list of available MCP tools

OAuth2

Learn about OAuth2 authentication for the Deel API