# Workday MCP MCP

> Workday MCP manages all your human capital data—payroll, organizational structure, time off, and employee records—directly through conversation. Forget navigating dozens of complex HR dashboards; this connector lets you pull specific worker profiles or run custom reports instantly by asking questions in plain English.

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

## Description

Need to know where everyone stands? This MCP connects your Workday tenant to your agent so you can manage core human capital operations without logging into the native portal. You can get a full picture of any employee, check their PTO balance, or map out entire supervisory hierarchies just by asking. For example, instead of running three different reports to find headcount and compensation data, you ask one question. This process is safe because your credentials pass through a zero-trust proxy when using Vinkius; they are used in transit but never stored on any disk. You get the real-time insights necessary for payroll, planning, or resource allocation, all from one place.

## Tools

### execute_raas_report
Runs a specific Workday Report-as-a-Service (RaaS) report and returns the results in JSON format.

### get_payroll_results
Retrieves detailed payroll information for any specified worker.

### get_time_off_balances
Checks and returns current time off balances for an employee.

### get_time_off_requests
Retrieves a list of pending or past time off requests for a worker.

### get_worker
Gets the full, detailed profile for a single employee using their ID or name.

### list_job_requisitions
Displays all currently open job requisitions across the company.

### list_supervisory_orgs
Shows a list of supervisory organizations, including their managers and current headcount count.

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

### query_resource
Queries any general Workday REST API resource, 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

### Check Worker Details
Retrieve detailed profiles, job roles, and complete history for specific employees.

### Analyze Time Off Status
Get current PTO balances, view pending time-off requests, or check absence history for any team member.

### Map Organization Structure
Navigate the company's full reporting lines, identifying supervisors, cost centers, and business units.

### Review Payroll Data
Pull summaries of pay runs, compensation breakdowns, or benefit elections for specific workers.

### List Job Openings
Monitor active job requisitions and understand the status of the recruiting pipeline.

## Use Cases

### Headcount audit before board meeting
A CHRO needs to know how many people are in Engineering and what their current compensation trends are. They use `list_workers` to establish the scope, then run a custom report via `execute_raas_report` for the final numbers.

### Checking resource availability for a project
A Project Manager needs to know if John Smith is available next week. They check his PTO with `get_time_off_balances` and then query his current assignments using `query_resource` before committing him.

### Onboarding a new department
A manager needs to confirm the structure and reporting lines for the new Product team. They use `list_supervisory_orgs` to see who reports where, and then check open roles using `list_job_requisitions`.

### Investigating pay discrepancies
Payroll needs to verify a worker's salary history. They first get the general profile with `get_worker`, then use `get_payroll_results` to deep-dive into specific pay periods.

## Benefits

- Instead of digging through multiple screens to find a person's history, you can use `get_worker` to get their complete profile in one call. It’s everything in one place.
- Payroll managers skip manual report generation; they just ask for the data and get it back via `get_payroll_results`. No more waiting on IT.
- You instantly know if someone is available by using `get_time_off_balances` or checking pending requests with `get_time_off_requests`, letting you schedule without guessing.
- The ability to run specialized data extractions means complex questions get answered. Use `execute_raas_report` for highly tailored reports that standard tools can't reach.
- You don't have to guess who reports to whom; using `list_supervisory_orgs` maps the entire corporate structure instantly, which is huge for planning.

## How It Works

The bottom line is you turn complex HR reporting into simple conversation.

1. First, you subscribe to this MCP on Vinkius and provide your Workday API Client credentials (Client ID, Secret, Refresh Token).
2. Next, you connect your AI agent from any compatible client. You don't touch the native Workday interface again.
3. Finally, you ask a question in natural language—like 'What is Jane Doe's PTO balance?'—and get the data back instantly.

## Frequently Asked Questions

**What authentication method does Workday use?**
Workday uses OAuth 2.0 with a registered API Client. You'll need to provide your Client ID, Client Secret, and a Refresh Token — all generated from within your Workday tenant by an administrator.

**Can I check PTO balances for my direct reports?**
Yes. The `get_time_off_balances` tool retrieves current PTO balances for any worker within the security scope configured for your Integration System User. Data is returned per plan type (vacation, sick, personal).

**Does it support Workday Report-as-a-Service (RaaS)?**
Absolutely. Use the `execute_raas_report` tool with your report URL to retrieve any custom Workday report, including those with prompt parameters. Results are returned in JSON format.

**Can I navigate the entire organizational hierarchy?**
Yes. The `get_org_structure` tool fetches supervisory organizations, cost centers, and company hierarchies, allowing you to traverse the full org tree from any starting point.

**How do I use the list_workers tool to filter for employees by specific job attributes or IDs?**
You can narrow down results using the search parameter within `list_workers`. Instead of searching by name, pass criteria like a specific Employee ID or Job Family attribute. This prevents wading through irrelevant worker data.

**If I need financial data not covered in standard reports, how do I use execute_raas_report?**
The `execute_raas_report` tool runs Workday's Report-as-a-Service (RaaS) queries. This allows you to generate tailored data extractions using specific report definitions and parameters you define in the prompt.

**What information does get_worker provide beyond just current time off balances?**
`get_worker` retrieves a comprehensive profile for any given worker. This includes job history, supervisory organization details, and specific attributes that help build a full picture of their tenure with the company.

**I need to query non-personnel data like cost centers or business units; what tool should I use?**
Use `query_resource` for these system-level entities. You specify the resource type, such as 'costCenters' or 'businessUnits,' and the agent returns a structured list of names and associated details.