How to Use the Buk MCP in Claude Code

Q: How do I add the Buk MCP Server to Claude Code?

Run the CLI command claude mcp add --transport http buk-mcp -- . This registers the server in your local /.claude.json configuration file.

Q: Can I use Claude Code to approve leaves in Buk?

Yes. You can tell the command-line agent to execute approveleave with the corresponding request ID directly from your terminal prompt.

Q: Does Claude Code allow shell piping with Buk data?

Absolutely. You can ask Claude Code to list your team via listemployees and pipe that output into grep, awk, or local files on your machine.

Query Buk HR records and automate payroll pipelines directly from your terminal using Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Buk MCP to Claude Code

Create your Vinkius account to connect Buk 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 Buk with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Terminal-driven Buk MCP Server queries

This MCP setup turns Claude Code into a fast command-line tool for your HR database. You can search for any team member by telling the terminal agent to run `get_employee` with their ID. The CLI agent outputs clean JSON or formatted text directly into your shell. It can quickly run `list_employees` and pipe the results into local scripts for fast data processing.

Scriptable vacation and leave audits

Claude Code handles time-off reporting through simple terminal commands. The agent uses `list_leaves` to gather pending absence requests and displays them in your terminal window. You can run quick shell scripts to audit upcoming absences. The agent calls `list_vacations` to check who is out, allowing SREs and managers to verify coverage before scheduling system maintenance.

Automated payroll reporting pipelines

Run your payroll audits straight from your CI/CD pipeline using Claude Code. The agent queries compensation records using `get_payroll` and aggregates the financial data without opening a browser. The agent processes department metrics by calling `get_company_stats`. It formats the output so you can pipe it to terminal utilities or export it to CSV files.

Setup guide

Set up Buk 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 buk-mcp with a green status indicator.
3

Start using tools

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

Terminal

claude mcp add --transport http buk-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 Buk 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": {
    "buk-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 Buk. 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 Buk 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 Buk MCP in Claude Code

Run the CLI command `claude mcp add --transport http buk-mcp -- `. This registers the server in your local `~/.claude.json` configuration file.

Yes. You can tell the command-line agent to execute `approve_leave` with the corresponding request ID directly from your terminal prompt.

Absolutely. You can ask Claude Code to list your team via `list_employees` and pipe that output into grep, awk, or local files on your machine.

This setup supports HTTP and SSE transports. Vinkius hosts the MCP endpoint, letting your terminal client connect securely over HTTPS.

Vinkius isolates all operations in a secure V8 sandbox. Your HR records, salaries, and attendance matrices are never exposed to public networks, and the connection remains completely encrypted.

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