# Workday MCP

> Workday connects your AI client directly to your enterprise HCM platform. You manage everything from payroll summaries and time off balances to organizational structures using natural conversation. It lets you query employee data, track requisitions, and execute custom reports without navigating multiple dashboards or running manual reports.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** hcm, employee-data, workforce-planning, payroll-processing, compensation-management, org-structure

## Description

Need to find a specific headcount number or check someone's PTO balance? Instead of logging into ten different Fiori apps, just talk to your AI client. This MCP gives your agent direct access to core Workday data—everything about workers, payroll runs, and the company’s structure. You can ask for total open positions across Engineering or pull a full compensation breakdown for a department; it'll find it immediately. Connecting via Vinkius makes this catalog available to any compatible AI client you use. Your agent becomes your centralized HR command center, turning complex data lookups into simple chat prompts.

## Tools

### list_workers
Searches and lists multiple workers using criteria like name or employee ID.

### get_worker
Fetches the complete, detailed profile for one specific worker.

### list_supervisory_orgs
Displays a list of company departments, managers, and total headcounts within those units.

### get_time_off_balances
Retrieves the current accrued time off balances for any worker.

### get_time_off_requests
Checks for pending or past time-off requests submitted by a specific employee.

### get_payroll_results
Pulls the detailed results of recent payroll runs for a worker.

### list_job_requisitions
Provides an overview and status list of all currently open job openings.

### execute_raas_report
Runs complex, custom reports by submitting specific parameters and receiving the data in JSON format.

### query_resource
Queries any general Workday resource type, such as cost centers or business units.

## Prompt Examples

**Prompt:** 
```
How many active employees do we have in the Engineering department?
```

**Response:** 
```
The Engineering supervisory organization currently has 247 active workers: 189 Regular Full-Time, 42 Contractors, and 16 Part-Time employees across 12 sub-organizations. Would you like a breakdown by location or job family?
```

**Prompt:** 
```
Show me the PTO balance for John Smith.
```

**Response:** 
```
John Smith's Time Off Balances: Vacation — 14.5 days remaining (3 days pending approval), Sick Leave — 8 days available, Personal Days — 2 of 3 used. His next pending request is Dec 22–26 (vacation). Would you like me to approve it?
```

**Prompt:** 
```
Run the 'Monthly Headcount Report' for Q1 2026.
```

**Response:** 
```
Monthly Headcount Report (Q1 2026): January — 1,245 (net +18), February — 1,263 (net +12), March — 1,275 (net +8). YTD net growth: +38 workers. Attrition rate: 2.1% (below 3% target). Top hiring departments: Engineering (+22), Sales (+11), Product (+5).
```

## Capabilities

### Retrieve Worker Information
Search and pull detailed profiles for individual employees across the entire company.

### Manage PTO and Absence
Check current time off balances and view pending or past time-off requests for team members.

### Analyze Payroll Data
Get summary results, compensation breakdowns, and benefit election details for specific workers.

### Query Organizational Structure
Map out supervisory hierarchies, cost centers, or business unit relationships instantly.

### Monitor Recruiting Status
View open job requisitions and the current status of candidate pipelines.

### Run Custom Reports
Execute highly tailored data extractions using Workday’s Report-as-a-Service capability.

## Use Cases

### Auditing Employee Data
An HRBP needs to confirm if a specific employee was moved between departments. They ask their agent to use `get_worker` and `list_supervisory_orgs`. The MCP returns the worker's full history, showing the exact date they changed supervisory organizations.

### Quarterly Compensation Review
A Payroll Manager needs to verify total bonus allocations for a specific group. They use `get_payroll_results` combined with `list_workers`, which compiles and presents the necessary financial data set instantly, saving hours of Excel work.

### Verifying PTO Eligibility
A team lead needs to know if a new hire can take time off. They prompt their agent for `get_time_off_balances` and the agent quickly returns the accrued days, allowing them to approve the leave immediately.

### Generating Custom Headcount Reports
A CHRO needs a quarterly report on total headcount growth by department. They use `execute_raas_report` with specific parameters, and the system returns a clean JSON data set ready for immediate presentation.

## Benefits

- Stop clicking through dashboards. You can ask your agent for a full list of employees or supervisors; it handles the deep queries instantly, giving you structured data right in the chat window.
- Simplify complex reporting. Instead of manually running reports to see headcount changes, use `list_workers` and `execute_raas_report` together to get real-time workforce analytics.
- Streamline time management tasks. Check PTO balances or view pending requests using `get_time_off_balances` and `get_time_off_requests`—all in one prompt, no navigation required.
- Centralize payroll insights. You can retrieve specific compensation breakdowns or full payroll results for any employee with the dedicated tools, bypassing the need to run manual reports.
- Understand company structure instantly. Need to know which cost center oversees a team? Use `query_resource` and `list_supervisory_orgs` to map out relationships in seconds.
- Manage hiring pipelines efficiently. Monitor open jobs by calling `list_job_requisitions`, giving you immediate visibility into talent needs.

## How It Works

The bottom line is you get instant access to mission-critical HR and financial records without ever touching an enterprise dashboard.

1. Subscribe to this MCP and enter your Workday API Client credentials (Client ID, Client Secret, Refresh Token).
2. Your AI client uses these credentials to securely authenticate against the Workday system.
3. You ask a question in plain language—for example, 'What is the PTO balance for Jane Doe?'—and receive the structured data answer immediately.

## Frequently Asked Questions

**Can the Workday MCP tell me if a department is growing?**
Yes, you can get growth metrics by running reports using `execute_raas_report`. You can also check general structure changes using `list_supervisory_orgs`.

**Does the Workday MCP handle salary changes?**
The MCP provides payroll insights via `get_payroll_results`, allowing you to view compensation breakdowns and merit increases, but it doesn't manage the actual change process.

**How do I check an employee's full history?**
Use the `get_worker` tool. This function pulls comprehensive data, including job profiles and worker history across their tenure with the company.

**What if I need a report that isn't in Workday? Can I use the MCP?**
If the underlying raw data exists within Workday, you can try to pull it using `execute_raas_report`. This tool is designed for custom extractions.

**Can the Workday MCP list all open positions?**
Yes, use the `list_job_requisitions` tool. It gives you a current overview of all job openings across different business units.