Factorial MCP for AI Agents. Manage HR records and time tracking instantly.
Factorial MCP connects any AI agent to your entire human resources workflow. Use it to instantly list employees, track leave requests and company holidays for a given year, audit shift schedules for months, or verify available payslips. It also lets you find specific HR policy documents and access global organizational metadata directly from conversation.
Give Claude and any AI agent real-world access
Retrieve detailed records on specific employees, including their roles, contact information, manager relationships, and hiring dates.
List all registered teams and check for upcoming leave or holidays to calculate current team capacity.
Get detailed shift schedules, clock in or out records, and list available payslips for specific months and years.
Search through stored company folders and documents to pull up HR policies or internal documentation using keywords.
Fetch global company metadata, confirming administrative settings and the current list of all registered employees and teams.
Ask an AI about this
Waiting for input…
What AI agents can do with Factorial MCP with 12 Tools
These tools let you perform every core HR function—from tracking time to finding policies—directly through your AI agent conversation.
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 MCPClock In
Records the time when a shift begins.
Clock Out
Records the time when a shift ends.
Get Employee
Retrieves detailed information on one specific employee using their ID number.
Get Me
Pulls general data about the current company's identity settings.
List Documents
Lists all available company documents and folders for review.
List Employees
Retrieves a comprehensive list of every employee registered in Factorial.
List Folders
Shows all structured company folders where documents are stored.
List Holidays
Provides a list of recognized holidays for any specific year.
List Leaves
Shows all approved leave requests submitted and tracked for a given year.
List Payslips
Lists available payslip records for both a specific month and year.
List Shifts
Retrieves all shift scheduling details for a given month and year.
List Teams
Provides a complete list of every team structure within the 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 each 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,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
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 each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Keeping track of who's out and when they clock in is a constant pain point. Solved with Vinkius AI Gateway
Right now, figuring out if the team has enough coverage requires opening Factorial, checking employee directories for PTO status, cross-referencing those dates with company holidays, then manually jumping to the shift calendar. You end up copy-pasting data between three or four different tabs just to give a single status update.
With this MCP, you simply ask your agent about team availability. It runs the necessary checks—calling `list_leaves`, checking `list_holidays`, and analyzing available teams—and delivers one concise answer: 'Team capacity is currently at 80% for June.' You get the summary without touching a dashboard.
Factorial MCP Provides Full HR Data Visibility
Before, retrieving detailed pay records meant navigating through quarterly reports and confirming eligibility by checking documents. If you needed to know an employee's status or a policy, it was a multi-step process of searching folders (`list_folders`) then opening the right files.
Now, your agent handles the complexity. You can ask for payslip availability using `list_payslips` and simultaneously find the relevant HR guide by calling `list_documents`. The data flows directly to you, eliminating clicks and context switching.
What your AI can actually do with this
Stop jumping between tabs just to answer basic questions about staff availability or payroll status. This MCP connects your Factorial HR account directly to your AI agent, giving it full visibility into your company's employee records and operational workflows through natural language chat. Need to know who’s out next month? Your agent checks the leave requests automatically.
Want to verify if a team has enough coverage for shifts coming up? You ask, and the MCP pulls the detailed schedule data instantly. It lets you get full employee profiles or find specific HR policies stored in company documents without ever logging into the main dashboard. This capability is what makes connecting through Vinkius so useful; it centralizes complex HR tasks so your agent can act as a true digital assistant for management and finance teams alike.
019d7596-05a2-71d6-a5b4-ac15756b36c6 Here's how it actually works
The bottom line is you get an instant window into your company's HR data without ever leaving your chat client.
Subscribe to this MCP on Vinkius.
Enter your Factorial API Key (you'll find this in Settings > Advanced configuration > API Keys).
Ask your AI agent a question like, 'Show me all approved leave requests for June 2026,' and it runs the query.
Who is this actually for?
This MCP is for anyone who spends more time clicking through dashboards than making decisions. If you’re tired of compiling reports by manually checking employee directories, shift schedules, and document folders, this is for you.
You use the MCP to pull full employee lists or check annual leave status without opening the Factorial portal.
You ask your agent for team availability and shift schedules, getting an immediate count of who is working and when.
You verify payslip records or audit global company metadata in real-time to confirm financial reporting data.
What Changes When You Connect
You immediately get a complete employee directory using list_employees, letting you pull roles, departments, and contact details without navigating multiple menu screens.
Checking team availability is simple. Running list_leaves or list_holidays tells you exactly how many people are out for any given year, helping prevent scheduling conflicts before they happen.
Finance teams can verify compensation records by using list_payslips, confirming that the correct payslip data exists for a specific month and year.
Need to find an old policy? Use list_documents or list_folders to search company files directly through conversation, bypassing complex file path navigation.
Scheduling becomes effortless. Instead of cross-referencing calendars, you can run list_shifts to audit team rotations and operational coverage for any month.
See it in action
Checking quarterly PTO capacity
A manager needs to know how much remaining paid time off the entire marketing department has. They ask their agent, and it uses list_leaves combined with team data to give a precise answer, avoiding manual calculations.
Auditing staffing for an upcoming peak season
The operations lead needs to confirm if enough staff are scheduled. They use the agent to run list_shifts for next quarter and check team size using list_teams, ensuring every shift is covered.
Onboarding a new employee's manager
A new HR hire needs to verify the reporting structure. They ask their agent, which uses get_employee and related data to confirm the manager relationship and contact details instantly.
The honest tradeoffs
What to watch out for, and the recommended way to handle each one.
Treating it like a search engine
Typing 'payroll info' hoping for an answer. The agent can’t guess what you need; it needs the right function to run.
Be specific and use the tool names. To check payroll, ask the agent to list_payslips for a year and month. If you need staff lists, explicitly request list_employees.
Ignoring data scope
Assuming all company policies are in one place or that an employee's details are always current.
Always ask the agent to check specific sources. For policies, use list_documents. For core identity info, use get_me.
When It Fits, When It Doesn't
Use this MCP if your HR workflow requires accessing multiple data points—like checking employee profiles alongside their current shift schedules or cross-referencing leave requests with company holidays. This is a comprehensive operational hub. Don't use it if you only need to do one simple, isolated thing, like just sending a single email; those are better handled by dedicated messaging tools. If your need is purely about writing a draft policy document and don't require pulling existing files, then an internal word processor will suffice. This MCP thrives on complex reads: fetching employee details (get_employee), listing teams (list_teams), checking time records (list_shifts), or discovering documents (list_documents).
Questions you might have
How do I use Factorial MCP to check employee contact details? +
You can get specific employee information by running the get_employee tool. You just need the employee's ID number, and the agent will pull their full profile right into the chat.
Can Factorial MCP tell me about company policies? +
Yes, you can list all stored company documents using list_documents. The agent searches those files for keywords like 'remote work' or 'PTO policy,' giving you the title and summary of what it finds.
Does Factorial MCP track my current shift status? +
You can use the clock_in and clock_out tools to record your shifts. This helps the agent keep an accurate running log that you can review later in conversation.
How do I find out what time off is available for my team? +
You should use the list_leaves tool, making sure to specify the year. This gives you a clear list of all approved absence requests so you can plan around them.
Does Factorial MCP handle payroll reports? +
The agent uses list_payslips to check for available payslip records, confirming the financial data exists for a specific year and month. It's great for auditing purposes.