# WebHR MCP MCP > WebHR connects your AI client directly to cloud HR data to automate employee management tasks. Use this MCP to track attendance records, manage leave requests, list staff profiles, and monitor open job postings—all without opening a single HR dashboard. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** employee-management, attendance-tracking, recruitment, onboarding, leave-management, hrms ## Description This connector lets you handle the entire worker lifecycle straight from chat. Instead of switching between separate systems for payroll, time off, and hiring, your agent talks directly to WebHR. You can pull detailed employee metadata, check aggregated attendance summaries, or get instant reports on leave balances across departments. Need to know who applied for a job? It finds that data too. Because all this activity passes through Vinkius, you don't just get the answer; you also get full visibility into exactly which tool was called and what data flowed through. You never lose track of what your agent is doing. ## Tools ### get_attendance_summary Generates an aggregated report on overall attendance metrics for a given period. ### get_employee_details Pulls the full profile and metadata record for a specific staff member. ### list_attendance_logs Retrieves detailed, chronological records of every employee clock-in and clock-out event. ### list_job_candidates Lists all applicants who have applied for current job openings. ### list_company_departments Lists all defined organizational departments within the company structure. ### list_employees Provides a comprehensive list of every active employee record in the organization. ### list_job_postings Displays a list of open job positions the company is currently trying to fill. ### list_job_requests Shows records for internal job requisitions, meaning roles that were approved internally but maybe not yet posted. ### list_available_leave_types Displays the different types of leave (like PTO or sick leave) available in your system. ### list_leave_requests Lists the history of employee leave requests, including approvals and dates taken. ### list_office_locations Retrieves a list of all physical company office locations. ## Prompt Examples **Prompt:** ``` Check the status of our open 'Senior Frontend Engineer' job posting and list all the active candidates currently in the pipeline. ``` **Response:** ``` The 'Senior Frontend Engineer' position is currently active. I found 8 active candidates in the pipeline, with 3 in the 'Technical Interview' stage and 5 in 'Screening'. Would you like to view the details of any specific candidate? ``` **Prompt:** ``` Retrieve all pending leave requests for the Engineering department and check the available vacation balance for 'Marcus Johnson'. ``` **Response:** ``` There are currently 4 pending leave requests in the Engineering department. I also checked Marcus Johnson's profile: his request for 5 days of PTO is pending, and he currently has 12 days of vacation balance remaining. ``` **Prompt:** ``` Generate an attendance summary for the New York office to see how many employees clocked in late this week. ``` **Response:** ``` I've pulled the attendance summary for the New York office. This week, there were 145 successful on-time clock-ins and 12 late arrivals. The overall punctuality rate is currently at 92%. Would you like a detailed log of the late entries? ``` ## Capabilities ### Pulling Staff Records Retrieve detailed information on any staff member, including their department and profile details. ### Tracking Attendance History Get summaries of clock-in/out times or list the raw log records to check punctuality for a period. ### Managing Time Off List available leave types, check employee leave history, and review all pending time off requests. ### Mapping Company Structure View the list of company locations or organizational departments to understand where staff are housed. ### Running Recruitment Checks Monitor open job postings, check internal requisitions, and view lists of candidates applied for positions. ## Use Cases ### Checking departmental compliance The Operations Lead needs to verify that all field offices have the required staff structure. They ask their agent, and it combines `list_company_departments` with `list_office_locations` to give a clear overview of where everyone is assigned. ### Handling an employee query about time off An HR Manager asks the agent for Marcus Johnson's leave status. The agent runs `get_employee_details` and then cross-references it with `list_leave_requests`, providing a single, definitive answer. ### Quickly assessing staffing gaps The Business Owner wants to know if the Engineering department is staffed enough. The agent first runs `list_company_departments` and then checks `list_employees` against the required headcount for that group. ### Reviewing hiring funnel efficiency The Recruiter wants to know if a new job posting is attracting applicants. They use `list_job_postings` first, and then immediately follow up with `list_job_candidates` for that specific role. ## Benefits - Instead of manually checking dashboards, you can use the agent to get an immediate attendance summary for any office or department using `get_attendance_summary`. - Need a full team roster? Running `list_employees` gives you all staff profiles and metadata in one go. You don't need to export data and sort it yourself. - Tracking time off is simple. The agent checks your leave history via `list_leave_requests` so you know exactly how much PTO someone has left, immediately. - When hiring, the workflow is cleaner. Check open roles with `list_job_postings`, then instantly pull candidate lists using `list_job_candidates`. It keeps the pipeline moving. - The platform ensures that every tool call, like checking departments via `list_company_departments`, creates a cryptographically signed audit trail. You always know who saw what and when. ## How It Works The bottom line is you talk to your agent once, and it handles the multiple back-end systems for you. 1. Subscribe to this MCP and provide your WebHR API Key in the setup settings. 2. Connect through any compatible client (like Claude or Cursor) and ask your agent a question, such as 'What are our open engineering roles?' 3. The agent executes the necessary calls and returns a plain text summary of the requested HR data. ## Frequently Asked Questions **How do I check attendance using get_attendance_summary?** You just ask your agent for the summary, specifying the time frame or location you care about. It gives you a clean metric report without giving you all the raw logs. **Can list_job_postings help me find internal roles?** No, `list_job_postings` shows what is actively advertised to outside candidates. If you are looking for roles that were approved internally but not yet posted, use `list_job_requests` instead. **What information does get_employee_details provide?** It gives a single record with comprehensive data on an individual employee, including their personal profile and department placement. This is your go-to tool for staff metadata. **If I run `list_employees`, what security measures protect the data flow?** Credentials pass through a zero-trust proxy, so your keys are never stored on disk. Every tool call generates a cryptographically signed audit trail, guaranteeing that every action taken by your agent is tamper-proof. **If my agent makes repeated calls to `list_leave_requests`, how are rate limits handled?** The platform handles rate limiting automatically. If you exceed the allowed call frequency, the system will throttle requests and provide an explicit error message instead of failing silently or overloading your account. **When I use `list_attendance_logs`, how does the MCP optimize data retrieval?** The MCP has native token optimization built in. This significantly cuts down on token consumption when fetching large amounts of log data, letting you process massive attendance records without ballooning your API costs. **How can I correlate data from `list_company_departments` with employee status?** You can use the department structure to filter and group results. For instance, you can get a list of employees belonging only to 'Engineering' or any other defined organizational unit. **If I get an authentication error when running `list_job_requests`, what should I check first?** First, verify that your WebHR API key is active and has the necessary scope permissions. If the key looks correct, try re-authenticating your AI client connection through Vinkius. **How do I find my WebHR API Key?** Log in to your WebHR portal, navigate to **Setup** > **API Settings**, and generate a new key for your integration. **Can the agent check employee leave balances?** Yes! Use the `list_leaves` tool to retrieve current leave applications and balance details for employees in your system.