How to Use the HiBob MCP in Mastra AI

Q: Can I create a multi-step HiBob workflow with Mastra AI that requires human approval?

Yes, that's a core feature. You can configure requireToolApproval on sensitive tools like requesttimeoff. The workflow will pause until a human approves the step in the Mastra UI.

Q: Can my agent check an employee's leave balance before approving a request?

Definitely. Your Mastra workflow can first call getleavebalance. Then, you can use conditional logic to proceed with requesttimeoff only if the balance is sufficient.

Build resilient HR automation for HiBob with this MCP Server. Mastra AI handles retries and branching logic for your backend agent workflows.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HiBob MCP to Mastra AI

Create your Vinkius account to connect HiBob to Mastra AI 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 HiBob with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Fault-Tolerant Employee Onboarding

Automate your new hire process with a workflow that won't quit. This server gives your Mastra agent the `invite_employee` tool to kick things off. If the initial invite fails, Mastra's built-in retry logic can try again with exponential backoff. You can also build conditional steps, like checking if a profile already exists with `search_employees` before sending an invitation.

Conditional HR Task Management

This MCP Server lets your agent manage dependent HR tasks. For example, a workflow can use `get_payroll_history` to confirm a final payment was made before automatically triggering `complete_task` on an offboarding checklist. Mastra's branching logic is key here. If a payroll run hasn't completed, the agent can hold off on completing the task and notify an admin instead. It turns a simple checklist into an intelligent process.

Build Smart Time-Off Bots with Mastra AI

Create a bot that handles time-off requests from start to finish. It starts with the `request_time_off` tool. Your Mastra agent can then add logic: first, check the employee's remaining days with `get_leave_balance`. If the balance is too low, the agent can automatically deny the request and reply to the user, all without human intervention. Use `requireToolApproval` for requests that need a manager's sign-off.

Setup guide

Set up HiBob MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All HiBob tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "hibob-mcp-client",
  servers: {
    "hibob-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "HiBob Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to HiBob tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent HiBob transactions"
);
console.log(result.text);

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 HiBob. 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 HiBob 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 HiBob MCP in Mastra AI

Mastra AI has automatic retries with exponential backoff built in. If an API call to HiBob fails via this MCP server, your agent will automatically try again, preventing temporary network issues from breaking your onboarding workflow.

Yes, that's a core feature. You can configure `requireToolApproval` on sensitive tools like `request_time_off`. The workflow will pause until a human approves the step in the Mastra UI.

In your agent's configuration, just add the Vinkius server URL to the `servers` object. Mastra's `MCPClient` handles the connection and makes all the HiBob tools available to your agent automatically.

Definitely. Your Mastra workflow can first call `get_leave_balance`. Then, you can use conditional logic to proceed with `request_time_off` only if the balance is sufficient.

Vinkius manages authentication through a single token. When your agent calls `get_payroll_history` or `get_employee_compensation`, the request is proxied through a zero-trust, ephemeral instance. The data is never logged or stored on the Vinkius platform.

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