Supercharge your AI with Factorial. Manage HR data through natural conversation.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
Factorial MCP connects your AI agent directly to your entire Factorial HR system. It lets you manage complex HR operations—from tracking time off and reviewing attendance logs to checking contracts and department structures—all through natural conversation.
Stop hopping between tabs; get a unified view of everything related to your workforce.
What your AI can do
Get employee details
Retrieves detailed profile information and specific roles for a single staff member.
List employee contracts
Generates a list of all active and historical employment contracts for compliance review.
List hr documents
Lists all general company HR documents by their metadata and unique ID.
Fetch detailed profiles and basic metadata for any active staff member.
Check all recorded leave requests, whether they're pending approval or already approved.
Inspect chronological shift records and clock-in/out data to see team working patterns.
See the entire company hierarchy, including all defined teams and departments.
List and retrieve employment contracts or general HR policies for review.
Ask an AI about this
Compatible AI Apps
OAuth 2.0 Compatible Gemini Waiting for input…
Factorial: Your HR Data Suite (8 Tools)
Use these eight specialized tools to query everything from staff directories and team structures to time off requests and company documents.
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 a single staff member.
List Employee Contracts
Generates a list of all active and historical employment contracts for compliance...
List Hr Documents
Lists all general company HR documents by their metadata and unique ID.
List Employees
Provides a full directory listing with names, emails, and basic staff IDs.
List Document Folders
Navigates the company's document library by listing available HR folder structures.
List Time Off Leaves
Checks the status of employee leave requests, showing both approved and pending time off.
List Attendance Shifts
Lists all recorded clock-in and clock-out shifts to track team working hours.
List Company Teams
Shows the names and groupings of every organizational department or team set up in...
Connect to your AI in seconds. 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.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token from
cloud.vinkius.com. For OAuth-protected servers, expand Advanced
settings to add credentials.
Start a conversation
Open a new chat. The Factorial integration is available immediately — no restart needed.
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,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 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
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 connection provides 8 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
HR staff spend hours clicking through disconnected HR systems every week.
Think about how you usually check on a team member's status. You might have to open the employee directory, then switch over to the time tracking module to see shifts, and finally go into a separate 'Leave' tab to check PTO balances. It’s constant context switching, copy-pasting IDs, and piecing together fragmented answers.
With this MCP, you just ask your agent: 'What is John Doe's available leave balance and what were his last three shifts?' The system runs the necessary checks—using list_time_off_leaves and list_attendance_shifts—and gives you a single, coherent answer immediately. You don't have to open a single separate application.
list_employee_contracts: Audit compliance effortlessly.
Before this MCP, auditing contracts meant pulling reports and manually checking expiry dates for every active staff member. If you missed even one file, or if the report was delayed, it created a serious compliance risk that required multiple people to track down.
Now, you ask your agent to list all employee contracts using list_employee_contracts. It delivers an instant, comprehensive inventory of status and dates. You know exactly what's active and when renewals are due—no manual report generation necessary.
What your AI can actually do with this
Managing people data shouldn't feel like running three different software programs just to get one answer. This MCP connects any AI agent to Factorial, giving you full control over HR workflows using only conversation. You can list all staff members and pull their specific profile details in seconds. Need to check if a team has enough people for the next month? Just ask about leave requests or look at attendance logs.
It's like having an administrative assistant that lives inside your chat window, instantly accessing company documents and reading out who reports to whom. Everything you need—employee directories, time sheets, contract status—is accessible right where you work. Connecting this through Vinkius gives your agent access to the whole catalog of tools, so you don't have to worry about which endpoint does what.
You just ask it.
019dd0ee-3053-719a-b71e-7a05ff72d1f4 
Here's how it actually works
The bottom line is that it turns complex HR lookups into simple chat commands.
Subscribe to this MCP and input your Factorial API key into your agent's settings.
Ask your AI client a direct question, like 'Who is on leave next week?'
The agent uses the necessary tools to pull data from Factorial and gives you one clear answer.
Who is this actually for?
HR Managers who spend half their day manually generating reports, Team Leads needing quick team availability checks, and Operations personnel who audit company structure. If you deal with people data at scale, this is for you.
Pulling workforce reports, checking leave balances using list_time_off_leaves, or auditing all employment contracts via list_employee_contracts.
Verifying if a team has enough people available by cross-referencing attendance shifts and current leave requests.
Orchestrating company structure queries to understand the entire departmental breakdown using list_company_teams.
What Changes When You Connect
Never manually check employee status again. You can pull detailed profile information, like roles and departments, instantly using get_employee_details.
Audit compliance without digging through folders. The list_employee_contracts tool gives you a clear view of all staff agreements.
Stop guessing who's available. By combining list_time_off_leaves with list_attendance_shifts, you get accurate real-time staffing levels.
Get the full picture of your company structure by calling list_company_teams; you don't have to rely on old org charts.
Quickly locate policy documents. Use list_document_folders and list_hr_documents to find everything from handbooks to compliance forms.
See it in action
A team lead needs to know if they can launch a new project.
The agent checks the current staffing levels by querying list_time_off_leaves and comparing it against the total staff count found via list_employees. It confirms there are enough available people, saving hours of manual spreadsheet cross-referencing.
HR needs to audit employee compliance status.
The agent pulls a list of all active contracts using list_employee_contracts and then uses get_employee_details for any gaps. This quickly flags employees whose contract details are incomplete or overdue.
An operations manager needs to understand reporting lines.
Instead of opening the internal directory, they ask about team hierarchy. The MCP responds by listing all company teams using list_company_teams, giving a structural map instantly.
The honest tradeoffs
Trying to find an employee's history.
Opening the Factorial app, navigating to 'Staff Directory,' searching by name, clicking into the profile, and then scrolling through tabs for time off or contracts. It takes 10 clicks and 5 minutes.
Just ask your agent: 'Show me Jane Doe's employment contract status and her last three weeks of attendance shifts.' This combines get_employee_details, list_employee_contracts, and list_attendance_shifts into one query.
Verifying departmental reporting lines.
Asking a coworker for the current organizational chart. They might give you an outdated printout or point you to a locked internal wiki page that's hard to navigate.
Ask your agent: 'List all company teams.' This uses list_company_teams and gives you the definitive, up-to-date structure immediately.
When It Fits, When It Doesn't
Use this MCP if your main job involves stitching together data from multiple HR records—like checking attendance against leave balances or matching contracts to specific employees. It's ideal for deep audits and reporting tasks where you need a unified view. Don't use it if your only requirement is simply viewing one piece of information, like just the name of a department; then a simpler directory tool might suffice. If your data quality is inconsistent (e.g., some contracts are manual while others are API-fed), be aware that this MCP will report exactly what the underlying tools provide. It’s powerful because it aggregates specialized reads from list_employees, get_employee_details, and list_time_off_leaves.
Questions you might have
How do I check a team's full structure with the Factorial MCP? +
You use list_company_teams to get an instant map of your organization. This tool retrieves all defined departments and teams, allowing you to see who reports where without navigating internal settings.
What if I need to check a specific person's profile details? +
Use get_employee_details. You just provide the employee ID, and it pulls all the rich data—roles, department specifics, etc.—for that individual.
Can I see who is on leave using list_time_off_leaves? +
Yes, list_time_off_leaves queries the system for both approved and pending requests. This is perfect for planning resource allocation without manual checks.
Does this MCP help with finding policy documents? +
You can use list_document_folders to see where all your HR documentation lives, and list_hr_documents to get a metadata listing of the files themselves.
If I use `list_attendance_shifts`, can I see if an employee has missed a clock-in or out? +
Yes, you can identify discrepancies. The tool returns chronological shift records, so your agent can flag any gaps between entries or shifts that fall outside expected working hours for deeper review.
When I run `list_employee_contracts`, what specific compliance data is included? +
The listing provides essential contract metadata. You'll find details like the start/end dates, contract type, and key policy references needed for quick compliance auditing.
What information do I get by calling `list_employees`? +
This function gives you a roster of all active staff. It returns full names, email addresses, and unique staff IDs, which are necessary identifiers to pull specific records using other tools.
Are there rate limits when I use `list_hr_documents`? +
The API adheres to standard usage protocols. If you hit a limit, your AI client will generate an error code that tells you exactly how long to wait before retrying the document query.
Can my AI automatically find the details of a specific employee just by providing their ID? +
Yes! Use the get_employee tool with the unique ID. Your agent will respond with complete metadata, contact information, and role details in seconds.
How do I monitor team leaves and availability? +
Simply ask the agent to run the list_leaves tool. It will compile a list of all requested and approved absences, allowing you to see who is out of the office.
Does the integration permit modifying employee data? +
No. The core set of tools focuses strictly on querying and analyzing HR context—listing employees, leaves, and attendance. State alteration operations are not currently exposed, ensuring your records remain secure.
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.
Gemini 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.