How do I connect my Factorial account?

You need to provide your Factorial API Key after subscribing to the MCP on Vinkius. Once connected, your AI client can immediately access your data.

Which AI clients can I use with this MCP?

You can use any MCP-compatible client, including Claude, Cursor, and Windsurf.

Can I see employee leave requests?

Yes, the MCP includes a capability to list leave requests, allowing you to monitor both pending and approved time off.

Is my HR data secure?

Vinkius hosts the MCP and manages the credentials securely, ensuring your Factorial data remains private to your authorized AI client.

Can I find specific company documents?

Yes, you can use the capabilities to list document folders and specific HR documents within your Factorial account.

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.

An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect Factorial to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Run your HR workflows through a simple chat interface.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 8 capabilities

We ship only the actions that matter.

Capability set01 / 02

01-04

4 capabilities in this set.

Part of 8 available through Factorial.

01
List hr documents
This capability lists all company HR documents. It provides the metadata and identification IDs needed to find specific files.
02
List time off leaves
This capability retrieves employee leave requests. Use it to monitor staff availability and pending time-off approvals.
03
List attendance shifts
This capability pulls all recorded attendance shifts. It helps you track working hours and identify team patterns.
04
List company teams
This capability lists all organizational teams. It is the primary way to understand your company's internal structure.

Capability set02 / 02

05-08

4 capabilities in this set.

Part of 8 available through Factorial.

05
List document folders
This capability lists HR document folders. Use it to navigate through your company's digital filing system.
06
List employee contracts
This capability retrieves all employment contracts. It is designed for quick auditing and compliance checks.
07
Get employee details
This capability fetches specific profile information for an individual employee. Use it to review roles and personal details.
08
List employees
This capability pulls a list of all active employees. It provides names, emails, and basic metadata to help you find staff IDs.

Real work

What teams actually run

Checking Team Availability

A manager asks the AI who is on leave this week to plan a meeting.

Employee Onboarding Info

A lead uses the AI to quickly find a new hire's contact details and role.

Compliance Audits

An HR professional asks for a list of all current employment contracts.

Attendance Review

An operations lead checks shift records to verify working patterns.

Automate a task

Put Factorial to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

Factorial works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

Building your own app? The connector is yours to use.

You don't need a client to put Factorial to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

917ms average. Fast in production.

Factorial is checked daily against the live service.

Daily averagePeak 1149ms

Oct 3Today

Fastest day: 743ms
Slowest day: 1149ms
14-day trend: Slowing+31%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 8 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Factorial, so you can see the experience inside your AI.

It does not authenticate your account with Factorial. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Factorial Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_0jicYRQCsa0zo9eB6ojNVJFnsSR0lRawLwvtI74R/mcp

Claude Desktop

Follow the steps below to connect in seconds.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3Click Add and start a new chat — Factorial capabilities are ready to use.

Configuration · claude_desktop_config.jsonCopy

{
  "mcpServers": {
    "factorial-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_0jicYRQCsa0zo9eB6ojNVJFnsSR0lRawLwvtI74R/mcp"
    }
  }
}

Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up Factorial in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work Factorial owners hand off.

This MCP is built for professionals who manage people and need quick access to HR data without manual searching.

01
HR Managers
They use the AI to pull workforce reports and check leave balances instantly.
02
Team Leads
They check team availability and attendance shifts directly from their chat interface.
03
Operations Leads
They use the AI to query organizational structures and manage company-wide data.

FAQ

Questions Factorial owners ask.

01
How do I connect my Factorial account?
You need to provide your Factorial API Key after subscribing to the MCP on Vinkius. Once connected, your AI client can immediately access your data.
02
Which AI clients can I use with this MCP?
You can use any MCP-compatible client, including Claude, Cursor, and Windsurf.
03
Can I see employee leave requests?
Yes, the MCP includes a capability to list leave requests, allowing you to monitor both pending and approved time off.
04
Is my HR data secure?
Vinkius hosts the MCP and manages the credentials securely, ensuring your Factorial data remains private to your authorized AI client.
05
Can I find specific company documents?
Yes, you can use the capabilities to list document folders and specific HR documents within your Factorial account.
06
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.
07
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.
08
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.

Explore

More in Productivity

Connect Factorial to Claude, Cursor, ChatGPT & more

Your AI does the work. We keep it safe and sound.

Each Connector runs inside its own sealed environment.

One switch stops every agent. Instantly.

Spending limits that pause instead of surprise.

We ship only the actions that matter.

01-04

List hr documents

List time off leaves

List attendance shifts

List company teams

05-08

List document folders

List employee contracts

Get employee details

List employees

What teams actually run

Checking Team Availability

Employee Onboarding Info

Compliance Audits

Attendance Review

Building your own app? The connector is yours to use.

Factorial Connector

Claude Desktop

HR Managers

Team Leads

Operations Leads

How do I connect my Factorial account?

Which AI clients can I use with this MCP?

Can I see employee leave requests?

Is my HR data secure?

Can I find specific company documents?

Can my AI automatically find the details of a specific employee just by providing their ID?

How do I monitor team leaves and availability?

Does the integration permit modifying employee data?

Factorial AI Connector

Hurma AI Connector

AssessTEAM AI Connector

Talexio AI Connector

Suggestions

Lucca (HR & Finance Suite) AI Connector

Time-Off Accrual Manager AI Connector

Gusto AI Connector

Deputy AI Connector