Factorial MCP for AI. Check leaves, shifts, and employee data instantly.
Works with every AI agent you already use
…and any MCP-compatible client








How this MCP server connects to your AI agent
Factorial connects your HR data directly into your AI agent. List active staff, check team schedules, track time off requests, and audit employment contracts—all through natural conversation.
This MCP gives you full control over complex human resource workflows without opening the Factorial app.
What AI agents can do with Factorial Automation
Get employee details
Retrieves detailed profile information and specific roles for one staff member.
List employee contracts
Generates a list of all active employment contracts, useful for compliance checks.
List hr documents
Retrieves metadata and IDs for all company HR documents in the system library.
Retrieve detailed profile information and roles for any specific staff member.
Pull a comprehensive list of all current employee employment contracts for compliance checks.
Query the system to see all recorded leave requests, whether they are pending or already approved.
Review chronological shift records and clock-in/out data to understand how your team is working.
Get the full organizational structure, including defined teams and departments within the company.
List and navigate the full hierarchy of company HR documents and folder structures.
Ask an AI about this
Waiting for input…
What AI agents can do with Factorial: 8 Tools for HR Management
These eight tools allow your AI agent to read specific HR records in Factorial. You can use them together to audit compliance, track attendance, and map organizational structures.
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 Factorial on VinkiusGet Employee Details
Retrieves detailed profile information and specific roles for one staff member.
List Employee Contracts
Generates a list of all active employment contracts, useful for compliance checks.
List Hr Documents
Retrieves metadata and IDs for all company HR documents in the system library.
List Employees
Lists every active employee, giving you their full names, emails, and basic profile...
List Document Folders
Provides a structured list of available HR document folders to help navigate the...
List Time Off Leaves
Queries and lists all recorded leave requests, showing who is out and when.
List Attendance Shifts
Lists chronological shift records to track employee working hours and productivity patterns.
List Company Teams
Maps out the full list of organizational teams, useful for understanding company...
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
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 Factorial, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ 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 Factorial. 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
Built on the Model Context Protocol (MCP) for 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 connection provides 8 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
HR reporting used to require a full day just to gather basic team metrics., Solved with Vinkius AI Gateway
Today, gathering a simple report—like knowing how many people are out next week or mapping the current structure of the Sales department—means opening the Factorial app. You click into employee records, then navigate to time off tabs, then maybe cross-reference a team directory. It's clicking through five different dashboards and copy-pasting dates onto a spreadsheet.
With this MCP, you talk to your agent. You ask it directly: 'Who is out next month?' The system runs the necessary queries—checking list time off leaves against list company teams—and gives you one clean answer in text format. No clicking required. Just the data.
get_employee_details Provides instant, deep-dive employee intelligence.
Instead of opening an individual profile page and hunting for a specific role title or manager ID, you just ask your agent to get_employee_details. It pulls that exact piece of information out cleanly, saving you the clicks and context switching.
What's different now is the immediacy. You don't browse; you query. Your AI client acts as a dedicated data layer between you and Factorial’s complex database.
What your AI can actually do with this
Managing employee records usually means jumping between five different internal dashboards just to get a picture of a single person's status. This MCP changes that. It lets your AI agent interact directly with your Factorial HR account, treating it like an expert administrator sitting on your team. Instead of manual report generation or hunting through folder structures, you simply ask for what you need.
Your agent pulls the data—like pulling a list of all active employees or checking pending time off requests—and presents it instantly. When you subscribe to this MCP via Vinkius, you connect your preferred AI client and get immediate access to powerful HR tools. You can check team availability by running attendance shifts against organizational teams, or review an employee's full employment contract details without leaving the chat window.
019dd0ee-3053-719a-b71e-7a05ff72d1f4 Here's how it actually works
The bottom line is you manage complex HR resources directly from your chat window using simple conversation prompts, not dashboard clicks.
Subscribe to this MCP on Vinkius and provide your Factorial API key from your account settings.
Select this MCP in your AI client, allowing it access to the HR data tools.
Ask your agent a question—like 'Show me all pending leave requests for Q3.'—and get the answer instantly.
Who is this actually for?
HR Managers who are tired of manually compiling reports across multiple systems need this. Operations Leads who struggle to verify team capacity in real-time will appreciate the immediate visibility. Team Leads needing instant proof of staff availability won't have to send out ten separate calendar invites anymore.
Use this MCP to instantly pull workforce reports, verify leave balances, and audit document statuses without ever opening the Factorial app.
Automate queries that map company-wide structures by checking organizational teams or listing active employees across departments.
Verify team availability and review attendance shifts straight from your communication hub to plan shifts efficiently.
What Changes When You Connect
Get instant team availability. You don't have to ask ten people for their PTO status; just asking the agent to list time off leaves gives you a complete picture.
Stop jumping between tabs to check compliance. The tool that lists all employment contracts lets you audit staff agreements instantly, citing specific details when needed.
Know your workforce without opening Factorial. By listing employees or pulling team hierarchy data, you get the full organizational map right inside your chat window.
Track actual work time, not just scheduled shifts. Using list attendance shifts gives accurate clock-in/out patterns, which is better than relying on self-reported schedules.
Keep HR documents organized. You can browse and discover specific files by first calling the function that lists document folders, then navigating into them.
See it in action
Verifying Team Capacity Before a Project Kickoff
A team lead needs to know if three key staff members are available next month. Instead of sending five calendar invites and waiting for responses, the agent runs list time off leaves against the employee directory, instantly showing any approved or pending conflicts.
Auditing Payroll Discrepancies
The operations lead notices a pay discrepancy. They ask the agent to retrieve both list attendance shifts and get employee details for that period. The AI compares the two sources, highlighting if any shift data doesn't match recorded working hours.
Onboarding New Managers
An HR manager needs a quick overview of the new department structure. They ask to list company teams and then run list employees, which immediately provides both the organizational map and the contact details for every person in it.
Compliance Check on Offboarding
A manager needs to confirm that all departing staff have signed updated agreements. They call list employee contracts to get a master list, then use get_employee_details to check the specific status of the outgoing worker's file.
The honest tradeoffs
Manually listing every employee.
A user decides it's easier to just open Factorial and click through 50 profiles one by one to see who works in Marketing.
Instead, use list employees. This sends the entire directory data to your agent at once, giving you the full roster instantly for filtering or searching.
Confusing shift logs with PTO records.
A user assumes that if an employee is marked 'out' in one system, it means they took approved leave, not just a day off without logging it properly.
Always run list time off leaves first to confirm official status. If the agent returns nothing, then check list attendance shifts for any raw clock-in/out activity that might explain the absence.
Guessing which document folder holds policy info.
A new hire spends an hour clicking through the main HR portal trying to find the latest vacation policy PDF.
Start by calling list document folders. This gives you a programmatic overview of the entire structure, allowing your agent to pinpoint the exact folder location for that policy.
When It Fits, When It Doesn't
Use this MCP if your primary bottleneck is consolidating disparate HR data points—things like combining staff availability with shift history or cross-referencing contracts against employee roles. You need a single source of truth delivered via chat. Don't use it, however, if you are trying to update the core system (e.g., changing an employee's department name). This MCP is designed for reading and auditing data. If your goal involves initiating transactions outside of querying existing records (like submitting a new PTO request), you might need a different, write-enabled integration tool instead.
Questions you might have
How do I check team availability using the Factorial MCP? +
You use list time off leaves to see all requests. You can also cross-reference this data with list attendance shifts to understand if a planned absence conflicts with actual work patterns.
Can I get an employee's contract information using the Factorial MCP? +
Yes, you use list employee contracts. This provides a comprehensive view of all employment agreements for auditing and compliance checks.
What tools help me understand the company structure in Factorial? +
You can call list company teams to map out departments, and then use list employees to get the roster associated with that hierarchy.
Does the Factorial MCP only show approved leave dates? +
No. The tool list time off leaves queries both pending requests and already approved leaves, giving you a full picture of staff availability.
What is the best way to check an employee's role in Factorial? +
Use get_employee_details. This function pulls specific profile data points for any single person, including their current designated role and department.
We've already built the connector for Factorial. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 8 tools are live and waiting.
You're up and running in seconds.
Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.