WebHR MCP. Manage staff records and track HR data from chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
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.
What your AI agents can do
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.
Retrieve detailed information on any staff member, including their department and profile details.
Get summaries of clock-in/out times or list the raw log records to check punctuality for a period.
List available leave types, check employee leave history, and review all pending time off requests.
View the list of company locations or organizational departments to understand where staff are housed.
Monitor open job postings, check internal requisitions, and view lists of candidates applied for positions.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
WebHR: 11 Core HR Tools
Use these tools to programmatically interact with every aspect of the WebHR platform, from hiring pipelines to daily attendance logs.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using WebHR on Vinkius019dd186get attendance summary
Generates an aggregated report on overall attendance metrics for a given period.
019dd186get employee details
Pulls the full profile and metadata record for a specific staff member.
019dd186list attendance logs
Retrieves detailed, chronological records of every employee clock-in and clock-out event.
019dd186list job candidates
Lists all applicants who have applied for current job openings.
019dd186list company departments
Lists all defined organizational departments within the company structure.
019dd186list employees
Provides a comprehensive list of every active employee record in the organization.
019dd186list job postings
Displays a list of open job positions the company is currently trying to fill.
019dd186list job requests
Shows records for internal job requisitions, meaning roles that were approved internally but maybe not yet posted.
019dd186list available leave types
Displays the different types of leave (like PTO or sick leave) available in your system.
019dd186list leave requests
Lists the history of employee leave requests, including approvals and dates taken.
019dd186list office locations
Retrieves a list of all physical company office locations.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with WebHR, then connect any of our 5,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by WebHR. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 11 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
The Manual HR Data Headache
Every week, someone has to manually open the attendance portal, pull raw clock-in/out logs. Then they have to copy those dates into a separate spreadsheet, cross-reference them with the department list, and finally check the employee directory just to see who was late. It's clicking through four different tabs and praying you don't miss a date.
With this MCP, your agent does that entire process in seconds. You ask for an attendance summary by location or department name, and it gives you the final metric—the clean answer—without you ever opening a spreadsheet.
Viewing Staff Profiles with get_employee_details
Before this MCP, finding out if an employee moved departments required logging into the HR system and navigating through three different dropdown menus. It was a deep click-through process just to see their title history.
Now, you ask your agent for the details of a specific worker, and it pulls up that complete profile instantly. The data is right there, ready to use.
What you can do with this MCP connector
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.
019dd187-1822-71dc-a98f-020abf6b4b07 
How WebHR MCP Works
- 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.
The bottom line is you talk to your agent once, and it handles the multiple back-end systems for you.
Who Is WebHR MCP For?
HR Managers who are sick of jumping between dashboards. Operations Leads needing quick structural data. Business Owners wanting instant reports on organizational health.
You automate monitoring staff attendance and checking the progress of open recruitment pipelines using natural language.
You quickly retrieve employee profiles or department structures without having to log into multiple internal systems.
You programmatically check the status of open jobs and list active candidates in the pipeline to keep hiring moving fast.
What Changes When You Connect
- 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_employeesgives 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_requestsso 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 usinglist_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.
Real-World 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.
The Tradeoffs
Treating it like a database query
Trying to write complex SQL or JSON filter logic into the prompt, forcing the agent to fail on syntax.
→ Just ask plain English. For example, instead of listing filters for department and date range, just say: 'Show me all late clock-in logs for Engineering last month.' The agent handles the rest.
Mixing up employee status checks
Asking if a person is an employee when they are actually just a job candidate.
→
Always use list_job_candidates to check applicants. Use get_employee_details only for people who already work at the company.
Ignoring organizational context
Asking about leave without knowing which department it belongs to, leading to vague results.
→
First, run list_company_departments to confirm the correct name, then specify that in your request for list_leave_requests.
When It Fits, When It Doesn't
Use this MCP if you need a single point of truth for employee and HR data. You should use it when you are managing workflows that span multiple records, like checking leave requests (list_leave_requests) and then cross-referencing them with the full staff profile (get_employee_details). Don't use this if your only goal is to view a static list of office addresses; list_office_locations handles that better. If you are doing specialized payroll calculations, look for dedicated finance tools instead.
Common Questions About WebHR MCP
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.