How to Use the Factorial MCP in Claude Code

Q: How do I register the Factorial MCP Server in Claude Code?

Run the command claude mcp add --transport http factorial -- in your terminal, placing all flags before the server name. You can then run claude mcp list to verify that your MCP tools are successfully registered.

Q: Can I use Claude Code to approve time-off requests in Factorial?

No, you cannot. The listtimeoffleaves tool only allows Claude Code to view leave requests, so you must still use the main web application to approve or deny time-off submissions.

Q: Where does Claude Code store the Factorial configuration?

Your configuration is stored locally in /.claude.json on your machine. This file contains the secure MCP endpoint and transport settings that Claude Code uses to communicate with the server.

Query Factorial HR data directly from your terminal using Claude Code commands.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Factorial MCP to Claude Code

Create your Vinkius account to connect Factorial to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Factorial with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Query your staff directory directly from your terminal

The `list_employees` tool lets you search your entire corporate directory without opening a web browser. From your terminal, you can ask Claude Code to find a teammate's contact info, and it will output the clean metadata instantly. If you need deeper context, Claude Code calls `get_employee_details` to fetch specific roles or profile information. It pipes this text directly into your shell, letting you grep or redirect the output to local files.

Audit leave requests and shifts via Claude Code

The `list_time_off_leaves` tool exposes all pending and approved time-off requests directly to your command line. You can quickly run cron jobs or shell scripts that ask your CLI agent to summarize who is out of the office this week. To check coverage, Claude Code can pull active shifts using `list_attendance_shifts`. It compares the active schedules against the leave requests, giving you a quick terminal summary of potential staffing gaps.

Audit compliance files using this terminal MCP Server

The `list_employee_contracts` tool enables fast, text-based auditing of employment agreements from your shell. This MCP Server lets you run quick security checks to verify contract dates and compliance statuses without clicking through an admin portal. You can also command Claude Code to check your document structure using `list_document_folders`. The agent returns a clean directory tree of your HR folders, making it easy to verify that your compliance files are organized properly.

Setup guide

Set up Factorial MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see factorial-alternative-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Factorial transactions." It will automatically discover and invoke the available Factorial tools.

Terminal

claude mcp add --transport http factorial-alternative-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Factorial MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "factorial-alternative-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Factorial now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Factorial MCP in Claude Code

Run the command `claude mcp add --transport http factorial -- ` in your terminal, placing all flags before the server name. You can then run `claude mcp list` to verify that your MCP tools are successfully registered.

No, you cannot. The `list_time_off_leaves` tool only allows Claude Code to view leave requests, so you must still use the main web application to approve or deny time-off submissions.

Your configuration is stored locally in `~/.claude.json` on your machine. This file contains the secure MCP endpoint and transport settings that Claude Code uses to communicate with the server.

Yes, you can. Since Claude Code runs entirely in your terminal, you can ask it to list employees and then pipe the resulting text into grep, awk, or local JSON files for further processing.

Your employee contracts and HR documents are secured through Vinkius's ephemeral V8 Isolate Sandbox. Claude Code connects via a single, secure token, keeping your sensitive HR credentials completely hidden from the command-line environment.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript