Factorial Connector for AI agents.
8 live capabilities
Manage your employee leave, payroll, and HR records through natural conversation.
Waiting for input…
Why people use Factorial
Factorial HR Automation: Stop Digging Through HR Dashboards
With this Connector, you just ask. You can tell your AI agent to list everyone on leave or find a specific folder of documents. It pulls the data directly from Factorial and gives it to you in plain text. You get your answers instantly without the manual navigation.
What Vinkius changes
You get a conversational interface for your entire Factorial HR database.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Checking for team coverage
A team lead asks the agent who is available for a meeting today, and it checks list_time_off_leaves to provide a clear list of active staff.
- Real-world use case 02
Onboarding a new hire
An HR manager asks for the folder structure for new hires, and the agent uses list_document_folders to guide them to the right place.
- Real-world use case 03
Audit preparation
An ops lead needs to review all active contracts, so the agent pulls a full list using list_employee_contracts for a compliance review.
Complete set · 8capabilities
The complete Factorial capability set.
These are the exact actions your AI can choose when you ask it to work with Factorial.
01—04
4 capabilities in this set.
Part of 8 available through Factorial.
- 01 Capability
List employee contracts
List all employment contracts in your system. This is useful for auditing and ensuring your company stays compliant.
- 02 Capability
List hr documents
Get a list of all company HR documents. This helps you find specific files by looking at their metadata and IDs.
- 03 Capability
List employees
List all active employees. Use this to quickly find staff IDs, email addresses, and basic profile info.
- 04 Capability
List document folders
List HR document folders. Use this to navigate the company's internal document library more efficiently.
05—08
4 capabilities in this set.
Part of 8 available through Factorial.
- 05 Capability
List time off leaves
List employee leave requests. This lets you monitor staff availability and see who is currently away.
- 06 Capability
List attendance shifts
List all attendance shifts. Use this to track working hours and understand team productivity patterns.
- 07 Capability
List company teams
List all organizational teams. This helps you understand the full hierarchy and team structure of your company.
- 08 Capability
Get employee details
Get details for a specific employee. Use this to review detailed profile information and specific job roles.
Set up in minutes
One URL. Then ask Factorial to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Factorial from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_TyON9Jn6V1WzfAjzuwlRSDq13vVfh9YiK3NRqFg8/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Factorial, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Factorial for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_TyON9Jn6V1WzfAjzuwlRSDq13vVfh9YiK3NRqFg8/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Factorial URL.
- Step 03
Save and start
Save the connection and enable Factorial in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"factorial-alternative": {
"url": "https://edge.vinkius.com/vk_preview_TyON9Jn6V1WzfAjzuwlRSDq13vVfh9YiK3NRqFg8/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Factorial
Open Agent mode in chat and ask: "Using Factorial, help me...". 8 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"factorial-alternative": {
"url": "https://edge.vinkius.com/vk_preview_TyON9Jn6V1WzfAjzuwlRSDq13vVfh9YiK3NRqFg8/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Factorial
Ask Copilot: "Using Factorial, help me...". 8 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"factorial-alternative": {
"url": "https://edge.vinkius.com/vk_preview_TyON9Jn6V1WzfAjzuwlRSDq13vVfh9YiK3NRqFg8/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Factorial
Open Cascade and ask: "Using Factorial, help me...". 8 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"factorial-alternative": {
"url": "https://edge.vinkius.com/vk_preview_TyON9Jn6V1WzfAjzuwlRSDq13vVfh9YiK3NRqFg8/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Factorial
Ask Cline: "Using Factorial, help me...". 8 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add factorial-alternative --transport http "https://edge.vinkius.com/vk_preview_TyON9Jn6V1WzfAjzuwlRSDq13vVfh9YiK3NRqFg8/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Factorial
Ask Claude: "Using Factorial, show me...". 8 tools are ready
Where the request belongs
Work Factorial can move forward.
This is for HR managers who are tired of manual data entry and team leads who need to know who is working without constant Slack pings.
HR Manager
Uses the Connector to quickly pull reports on leave balances and audit employee contracts during peak hiring seasons.
Team Lead
Checks team availability and shift patterns to plan weekly projects without leaving their primary workspace.
Operations Lead
Queries the organizational structure to ensure company-wide departments are aligned with new growth goals.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsFactorial
Modernize HR operations with time-off management, payroll processing, and performance reviews that employees actually enjoy using.
Hurma
Manage your HR processes with employee records, leave tracking, and performance reviews designed for growing teams.
BambooHR
Official HR software automation. manage employee directories, time off requests, and company reports via AI.
SmartHR
Empower your AI to manage employee records, organizational structures, and payrolls directly from your SmartHR workspace.
Personio
Orchestrate HR logistics via Personio. manage workforce lists, track specific absences, log attendances securely, and evaluate custom attributes structurally via AI.
Oyster
Manage global HR, payroll, and compliance via Oyster. list engagements, track expenses, and manage time-off requests directly from any AI agent.
Bring your own AI
Change the model, client or framework. Keep Factorial connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Factorial.
The practical details behind the request, access and result.
Can I use the Factorial MCP to see who's out of the office?
Yes. You can ask your agent to check leave requests, and it will pull a list of employees who are currently away or have approved time off.
Does the Factorial MCP work with Cursor or Claude?
It works with any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code.
How does the Factorial MCP help with HR audits?
It allows you to quickly pull a list of all active employment contracts and HR documents, making it much easier to review compliance data.
Can I search for specific HR documents using the Factorial MCP?
Yes. You can ask the agent to list document folders or specific HR documents to find the information you need without manual searching.
Is the Factorial MCP good for tracking employee shifts?
It's great for that. You can query attendance shifts to see clock-in and clock-out data to understand your team's working patterns.
How do I connect my Factorial account to my AI agent?
Just subscribe to the Connector and provide your Factorial API Key from your account settings. Your agent will then have access to your HR data.
Can my AI automatically find the details of a specific employee just by providing their ID?
Yes! Use the get_employee capability 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 capability. 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 capabilities 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.
One connection away
Give your agent a direct line to Factorial.
Connect Factorial once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available