# Deel MCP

> Deel MCP connects your AI agent directly to global HR operations, payroll, and compliance data for international teams. Check contract terms across 150+ countries, track invoices, monitor expenses, and manage time-off requests using natural conversation.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** global-hiring, contract-management, international-payroll, compliance, remote-work, hr-automation

## Description

Need to run global HR tasks without jumping between ten different tabs? This MCP connects your AI client to Deel's full suite of people tools. You can handle everything from tracking employee profiles worldwide to monitoring payments for contractors in multiple countries.

Imagine asking your agent, 'Who needs expense reimbursement and what are the status of last month's payroll?' It pulls together data on submitted expenses, checks payment history, and reports back who needs follow-up. The system gives you a single source of truth for compliance, contracts, and employee records across global borders.

Whether you're an HR manager needing to check a specific contract status or a finance team tracking overdue invoices, this MCP makes it happen through simple conversation. By connecting via Vinkius, your agent gets access to Deel’s entire catalog of tools—payroll, time-off requests, and more—so you can run complex global operations without ever leaving your chat window.

## Tools

### list_contracts
Lists all active contracts, providing details like legal type, current status, and general compensation structures.

### list_expenses
Gathers metadata on submitted expense reports, including receipt attachments and the current review status (approved, rejected, or pending).

### get_contract
Retrieves complete details about a specific contract, such as compliance requirements, effective dates, and exact compensation rates.

### list_people
Provides a unified list of all team members and contractors, showing their professional roles and geographical location.

### get_person
Resolves deep details on an individual person, including payment history, active contracts, and personal metadata within the platform.

### list_invoices
Lists all invoices, showing billing amounts, issue dates, and whether they are paid, pending, or overdue.

### list_payments
Provides data on past payments, including the disbursement amount and the technical status of each transfer.

### list_time_off
Lists all time-off requests, showing the requested dates, leave category, and current approval status for review.

### list_tasks
Retrieves task descriptions, due dates, and completion status specifically tied to a contract’s milestones.

### list_milestones
Lists project stages defined in a contract, including identifiers, payment amounts, and projected achievement dates.

## Prompt Examples

**Prompt:** 
```
List all active contractors in my team.
```

**Response:** 
```
I've found 24 active contractors, including 'Maria Santos' (Brazil) and 'Kenji Tanaka' (Japan). Would you like to see the monthly compensation for any of them?
```

**Prompt:** 
```
What invoices are currently pending payment?
```

**Response:** 
```
There are 5 pending invoices totaling $18,400. The largest is for 'Kenji Tanaka' ($8,000) due on April 10th. Should I pull the full payment report?
```

**Prompt:** 
```
Show me any time-off requests pending approval.
```

**Response:** 
```
I found 3 pending time-off requests: 'Alex Kim' (3 days in May), 'Sarah Lee' (1 week in June), and 'David Chen' (today). Would you like to see the reasons provided for these requests?
```

## Capabilities

### Check employee profiles and team status
List all current employees and contractors globally, retrieving their roles and locations.

### Review contract details and compliance
Retrieve specific legal terms, compensation rates, and compliance requirements for any given agreement.

### Track global finances and payments
View a list of invoices to see which are paid, pending, or overdue, as well as track payment disbursements across the organization.

### Manage time-off and expense reporting
List submitted expenses with their approval status, or check the current status of all time-off requests.

### View project financial stages
Get a list of defined contract milestones, including projected achievement dates and associated payment amounts.

## Use Cases

### Reconciling payroll for a new country
A finance manager needs to confirm if all contractors in Brazil have paid invoices. They ask their agent, which then uses list_invoices and get_person together to provide the total pending amount owed by specific individuals.

### Onboarding a global contractor
An HR lead needs to confirm the contract terms for a new hire in Japan. They use get_contract to pull up compliance rules and check list_people to verify the person's current status before issuing equipment.

### Handling expense audits
An operations leader needs to know which employees have submitted expenses but haven't received approval. They ask for a report, triggering list_expenses and getting the full review status for quick follow-up.

### Reviewing annual leave across departments
A manager needs to see who is out this month. They check list_time_off through their agent, instantly seeing all pending requests and when approvals are needed before the end of the quarter.

## Benefits

- Stop switching tabs to check on team status. You can use list_people and get_person to pull a unified view of every employee or contractor globally, all through natural conversation.
- Never miss a payment deadline again. The MCP lets you list_invoices and list_payments in one go, giving instant visibility into overdue amounts and disbursement statuses for your finance team.
- Get compliance details instantly. Instead of searching through legal documents, use get_contract to retrieve precise compensation rates and compliance requirements for any jurisdiction.
- Simplify HR workflow management. You can check time-off requests using list_time_off or review pending expenses via list_expenses without writing a single spreadsheet formula.
- Track project progress with precision. Use list_milestones and list_tasks to monitor structured engagements, seeing exactly what stages are complete and when the next payment is due.

## How It Works

The bottom line is that you talk to your AI client like talking to an HR specialist, and it executes complex Deel tasks instantly.

1. Connect your AI client to the Deel MCP on Vinkius.
2. Authorize access using your Deel API Token in your agent settings.
3. Ask your agent conversational questions, such as 'Show me all pending time-off requests' or 'What is the status of the Q2 invoices?'

## Frequently Asked Questions

**Can Deel MCP list all team members and their roles?**
Yes, the list_people tool retrieves a unified view of all employees and contractors worldwide, detailing their professional role and location in one call.

**How do I check if an expense report was paid or rejected using Deel MCP?**
You use list_expenses to see the metadata for submitted reports. The resulting data will include the current review status, letting you know immediately if it's approved, pending, or rejected.

**Is Deel MCP good for tracking project milestones?**
Absolutely. The list_milestones tool pulls identifiers and payment amounts associated with defined stages of a contract, giving you clear progress markers on large projects.

**Can I see payments that have already been disbursed?**
Yes, the list_payments tool returns data detailing past disbursements, including the exact amount and the technical status for each transfer, helping with reconciliation.

**What if I need to know the specific compliance rules for a contract?**
You run get_contract. This tool resolves detailed terms, compliance requirements, and effective dates, giving you deep insight into the legal specifics of any agreement.