How to Use the HiBob MCP in Vercel AI SDK

Q: How do I use the Vercel AI SDK to search for employees in HiBob?

Import createMCPClient and point it to your Vinkius URL for this MCP server. Pass the tools from mcpClient.tools() to streamText. Your AI agent can then call searchemployees with the query.

Q: Can I build a live 'who's out' calendar with HiBob and the Vercel AI SDK?

Yes. Your agent can call the getwhosout tool. The Vercel AI SDK will stream the list of employees on leave, which you can render directly into a calendar component in real-time.

Q: Is it possible to request time off using the HiBob MCP Server and the Vercel AI SDK?

Absolutely. The requesttimeoff tool takes a JSON string with the request details. Your UI can collect the dates and policy type, then have the agent submit the request to HiBob.

Build reactive HR frontends with the Vercel AI SDK. Stream HiBob employee data and task lists directly into your UI components.

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 Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live Employee Directory Search

This tool connects your AI client to HiBob's employee directory. Your frontend can instantly find people using `search_employees` or pull a full staff list with `list_public_profiles`. Because the Vercel AI SDK streams tool output, your users see results appearing one-by-one in the UI. No waiting for a full list to load. It's perfect for building type-ahead search components that feel instant.

Interactive Time-Off Management

Give managers a live view of who is out of the office. The `get_whos_out` tool streams leave data for a specific date range right into your calendar component. Employees can also check their own time off with `get_leave_balance`. When someone submits a request with `request_time_off`, the UI can immediately update to show the pending status. It turns a static form into a responsive conversation with your HR system.

Real-Time Task Lists for your AI SDK App

Pull company-wide pending tasks into your app's dashboard. The `list_open_tasks` tool gives your agent a complete view of what needs to be done across the organization. You can build UIs where managers assign tasks and your agent uses `complete_task` to mark them as done in HiBob. The feedback is immediate, keeping everyone in sync without a page refresh. This MCP Server makes it possible.

Setup guide

Set up HiBob MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all HiBob tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent HiBob transactions",
});

console.log(text);
await mcpClient.close();

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 Vercel AI SDK

Import `createMCPClient` and point it to your Vinkius URL for this MCP server. Pass the tools from `mcpClient.tools()` to `streamText`. Your AI agent can then call `search_employees` with the query.

Yes. Your agent can call the `get_whos_out` tool. The Vercel AI SDK will stream the list of employees on leave, which you can render directly into a calendar component in real-time.

Absolutely. The `request_time_off` tool takes a JSON string with the request details. Your UI can collect the dates and policy type, then have the agent submit the request to HiBob.

This tool lets you get the values for custom dropdown fields in your HiBob instance. It's useful for populating forms with the exact options configured by your HR team, like 'office location' or 'department'.

Your Vinkius endpoint token is the only key. All requests to sensitive tools like `get_employee_compensation` and `get_payroll_history` are routed through Vinkius's ephemeral, sandboxed environment. The raw data is only passed to your authenticated AI SDK client and never stored by Vinkius.

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