# Deputy MCP for AI Agents MCP > Deputy lets your AI client manage the entire workforce lifecycle from within conversation. Your agent can pull employee details, review current shift rosters, track timesheets, and handle leave requests instantly. Stop switching between tabs; keep all scheduling and HR data in one place. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** workforce-management, employee-scheduling, timesheets, leave-management, roster-management, shift-planning ## Description Managing staff schedules used to mean logging into a complex portal, cross-referencing spreadsheets, and digging through multiple forms just to know who’s working when. Now, you can talk to your AI client about your workforce needs instead. Your agent connects directly to Deputy to handle everything from employee directories to leave approvals using natural language conversation. Need to know which employees are clocked in right now? Ask it. Reviewing last week's payroll hours? Tell it to check the timesheets. It handles that instantly, giving you a clear picture of your operations. When you connect this MCP via Vinkius, your agent gets access to all these tools—it’s like having an Operations Manager on standby 24/7. You don't need to be an expert in the API; you just talk about staffing needs, and it does the heavy lifting for roster management, timesheet tracking, and leave coordination. ## Tools ### get_employee_profile Pulls detailed information for a single, specified employee. ### get_authenticated_user Retrieves metadata about the user who is currently logged into Deputy. ### list_currently_active_shifts Identifies and lists all employees who are clocked in at this moment. ### list_workforce_employees Generates a complete list of every employee record in your organization. ### list_leave_requests Shows all submitted time-off and leave requests, regardless of approval status. ### list_business_locations Retrieves a list of every physical site or company location configured in Deputy. ### list_pending_leave_approvals Lists only the leave requests that are waiting for your direct managerial approval. ### list_active_rosters Provides a view of both current and future shift schedules across all locations. ### list_completed_timesheets Shows timesheets that have been submitted by employees for review. ### search_employees_by_name Finds and returns records for an employee based on their display name. ## Prompt Examples **Prompt:** ``` How many people are clocked in right now across all locations? ``` **Response:** ``` **Current Staffing Count:** * **Location A (Downtown):** 14 employees active. * **Location B (Suburbs):** 6 employees active. * **Total Clocked In:** **20 people.** You can also check who is clocked in at a specific spot, like 'Downtown', if you need to know the exact names. ``` **Prompt:** ``` Are there any leave requests pending approval for next month? ``` **Response:** ``` **Pending Leave Approvals (Next 30 Days):** * Sarah Lee: Personal Leave (Oct 5 - Oct 7) * Mark Chen: Vacation (Oct 12 - Oct 16) * Emily Rodriguez: Sick Time (Oct 24) Please review these requests. They need your sign-off by the end of the week. ``` **Prompt:** ``` Who is assigned to work at the East Side location next Monday? ``` **Response:** ``` **East Side Roster - Next Monday:** * **Shift 1 (8:00 AM - 4:00 PM):** John Smith, Jane Doe * **Shift 2 (11:00 AM - 7:00 PM):** Alex Kim, Maria Garcia All shifts are currently covered. Let me know if you need the employee IDs for this team. ``` ## Capabilities ### Get employee details Retrieve comprehensive personal information for any specific staff member. ### Check active shift status Identify exactly which employees are currently clocked in and working their shifts. ### List all staff members Pull a comprehensive directory of every employee within your organization's records. ### Review leave requests View the full list of time-off and leave applications submitted by staff. ### Manage pending approvals Filter down to only show leave requests that are awaiting your manager approval. ### Monitor schedules Get a list of all current and upcoming shift rosters across locations. ## Use Cases ### Finding coverage gaps for tomorrow's shifts A manager needs to know if the Downtown location has enough staff next Tuesday. They ask their agent, and it checks `list_active_rosters` and reports back on expected staffing levels across all roles. ### Handling a last-minute sick call A team lead gets an alert that key staff are out. They ask their agent to check `get_employee_profile` for the missing person and then use `list_workforce_employees` to find who can cover the gap. ### Auditing timesheets before payroll The HR specialist needs to verify hours for 50 employees. They ask their agent to pull all records using `list_completed_timesheets`, saving them from manually opening dozens of files. ### Reviewing leave backlogs A manager is overwhelmed by pending time off. Instead of reading 30 requests, they ask the agent to use `list_pending_leave_approvals` and get a concise summary of who needs approval. ## Benefits - Instantly know who is working: Use `list_currently_active_shifts` to get a real-time count of clocked-in employees without manually checking shift boards. - Streamline approvals: Instead of sifting through months of data, use `list_pending_leave_approvals` to focus only on requests that need your sign-off. - Better planning visibility: Review both current and future assignments by calling `list_active_rosters`, helping you spot coverage gaps weeks before they become problems. - Accurate payroll data: Quickly audit time records using `list_completed_timesheets` to ensure the hours billed match the actual shifts worked. - Full employee context: Use `get_employee_profile` and `search_employees_by_name` together to pull a complete history for any staff member in one conversation. - Organizational oversight: Get an overview of all operational sites using `list_business_locations`, making sure your agent knows where every shift is taking place. ## How It Works The bottom line is, instead of writing code or clicking through menus, you just talk to your AI agent, and it handles complex HR tasks using Deputy's live data. 1. Connect the Deputy MCP to your AI client. You'll authorize it using your Deputy API Token and account Subdomain. 2. Ask your agent a question, like 'Show me who is clocked in right now.' 3. The MCP runs the relevant tool, fetches the data, and returns a natural language answer that you can act on immediately. ## Frequently Asked Questions **How can I use Deputy with AI agents to check staffing levels?** You simply ask your agent, 'Who is working at my site?' It instantly queries the system and tells you who is clocked in right now or what the full roster looks like for any future date. This saves you from checking multiple dashboards. **Can Deputy MCP help me manage leave approvals?** Yes, it filters through all time-off requests and presents only those that require your specific manager approval. You get a clear list of who needs attention without having to sort through the entire employee history. **What if I want to know an employee's full work history?** You can pull detailed profiles for employees and then review their completed timesheets. This gives you a clear audit trail of everything they have worked, which is crucial for payroll accuracy. **Is Deputy MCP good for multi-location scheduling?** It's excellent for multi-site management. You can ask about rosters at specific business locations and get full coverage details, allowing you to compare sites easily in one chat session. **Does this help me with payroll compliance checks?** By accessing completed timesheets and employee profiles, your agent helps audit work hours against policy. You can ensure that the logged time matches the required shift duration before sending it to payroll.