Factorial Connector for AI agents.
8 live capabilities
Manage employee records and HR workflows through natural conversation.
Waiting for input…
Why people use Factorial
Factorial : Managing HR Workflows Without the Dashboard Fatigue
This Connector changes that. You just ask your agent. It pulls the leave data, checks the shifts, and gives you a summary in seconds. You get the answers you need without ever having to log in or click a single button.
What Vinkius changes
You get a conversational interface for your entire 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
Finding a remote work policy
An HR admin needs to find the remote work handbook.
- Real-world use case 02
Checking June availability
A team lead needs to see who is out of the office.
- Real-world use case 03
Auditing payroll records
A finance clerk needs to verify if payslips were issued in March.
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 hr documents
Includes document metadata and identification IDs. List all company HR documents
- 02 Capability
List document folders
Use this to navigate the document library. List HR document folders
- 03 Capability
List time off leaves
Useful for monitoring attendance and staff availability. List employee leave requests
- 04 Capability
List attendance shifts
Essential for tracking employee working hours and productivity patterns. List all attendance shifts
05—08
4 capabilities in this set.
Part of 8 available through Factorial.
- 05 Capability
List company teams
Useful for understanding the organizational hierarchy. List all organizational teams
- 06 Capability
Get employee details
Essential for reviewing detailed profile information and roles. Get details for a specific employee
- 07 Capability
List employee contracts
Essential for auditing and compliance reviews. List all employment contracts
- 08 Capability
List employees
This capability lists all Factorial employees. It lets you see every person in your organization in one go.
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_0jicYRQCsa0zo9eB6ojNVJFnsSR0lRawLwvtI74R/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_0jicYRQCsa0zo9eB6ojNVJFnsSR0lRawLwvtI74R/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": {
"url": "https://edge.vinkius.com/vk_preview_0jicYRQCsa0zo9eB6ojNVJFnsSR0lRawLwvtI74R/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": {
"url": "https://edge.vinkius.com/vk_preview_0jicYRQCsa0zo9eB6ojNVJFnsSR0lRawLwvtI74R/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": {
"url": "https://edge.vinkius.com/vk_preview_0jicYRQCsa0zo9eB6ojNVJFnsSR0lRawLwvtI74R/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": {
"url": "https://edge.vinkius.com/vk_preview_0jicYRQCsa0zo9eB6ojNVJFnsSR0lRawLwvtI74R/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 --transport http "https://edge.vinkius.com/vk_preview_0jicYRQCsa0zo9eB6ojNVJFnsSR0lRawLwvtI74R/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 being a human switchboard for basic questions and team leads who need to know who's available without pestering people on Slack.
HR Manager
Pulls employee directories and manages leave requests without opening the dashboard.
Team Lead
Checks shift rotations and team availability to plan project timelines.
Finance Clerk
Verifies payslip availability and company metadata for monthly audits.
Ops Coordinator
Retrieves company documents and verifies organizational structures on demand.
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 Factorial MCP to see who's on vacation?
Yes, you can ask your agent to list all leave requests for any specific year. It will provide a clear summary of who is away and when, helping you plan projects without opening the HR dashboard.
Does Factorial MCP work with Cursor?
Yes, this Connector works with any compatible client, including Cursor, Claude, and Windsurf. Once connected, your agent can access your Factorial data directly.
Can I find company documents using Factorial MCP?
Absolutely. You can ask your agent to find specific HR policies, employee handbooks, or other internal files. It will search your company folders and list the relevant documents for you.
How do I check payslips with Factorial MCP?
You can ask your agent to list payslips for a specific month and year. It will retrieve the available records so you can verify compensation data quickly through a chat interface.
Can I manage shifts with Factorial MCP?
Yes, the Connector allows you to list shifts for any given month. This makes it easy to audit team rotations, check coverage, and see who is scheduled to work at any time.
Is Factorial MCP good for HR managers?
It's a huge time saver for HR managers. It eliminates the need to manually search for employee profiles, leave dates, and company documents, letting you handle these requests in seconds via natural conversation.
Can my agent list all leave requests for the current year in Factorial?
Yes. Use the 'list_leaves' capability. You can specify the 'year' parameter, and the agent will fetch all absence and holiday requests, allowing you to track team availability flawlessly.
How do I check the shift schedule for a specific month via chat?
Use the 'list_shifts' capability. Provide the 'year' and 'month' (numeric). The agent will retrieve the detailed scheduling information, providing you with a clear view of operational coverage.
Can I audit payslip availability through the agent?
Absolutely. Use the 'list_payslips' capability for a target year and month. Your agent will verify which employees have available compensation records without you needing to manually navigate the payroll section.
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