How to Use the Factorial MCP in Vercel AI SDK

Q: Do I need to write custom React hooks for Factorial data?

No. You just pass the tools from createMCPClient directly into streamText or generateText. The SDK handles the execution of tools like listdocumentfolders and returns the structured JSON straight to your UI.

Pipe live Factorial HR records directly into your Next.js UI using Vercel AI SDK to render employee details instantly.

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

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Render live team rosters in your Vercel AI SDK app

Your Next.js frontend shows live team setups using `list_employees` to fetch active workers directly. By pairing this MCP Server with Vercel AI SDK, you pipe raw list data straight to React components. The server pulls active workers and maps out team structures using `list_company_teams` on the fly. Instead of staring at a blank loading spinner, your users watch the staff roster populate card by card. Your React components receive the raw JSON payload and render the UI elements dynamically as the data streams in.

Direct shift tracking inside your React components

Track shift schedules directly inside your app by invoking `list_attendance_shifts` to stream live logs. When your agent calls this tool, the Vercel AI SDK streams the active shift logs directly into your custom calendar components. This keeps your edge functions fast and prevents your database from getting clogged with constant polling requests. You pull individual profiles using `get_employee_details` to show who is late or missing. Because this runs on edge-compatible infrastructure, the UI updates happen in milliseconds, giving managers an instant look at the floor schedule.

Instantly display HR documents in the client UI

Query `list_document_folders` directly from your client UI to display company files instantly. This MCP integration queries folders and fetches specific files with `list_hr_documents` to display them directly in your Svelte or Next.js layout. Your AI client handles the search query, finds the correct folder, and streams the document metadata right to the user's screen. If they need to check contract terms, the agent pulls the details using `list_employee_contracts` and formats the dates nicely in the browser.

Setup guide

Set up Factorial 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 Factorial 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 Factorial 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 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 Vercel AI SDK

Yes. By combining the MCP server with the Vercel AI SDK, you call `list_attendance_shifts` and stream the raw shift data directly into your frontend components in real-time.

The SDK manages the connection to our hosted MCP endpoint, which handles the underlying API throttling. When querying `list_employees`, the server balances the requests so your Next.js edge functions don't trigger API blocks.

No. You just pass the tools from `createMCPClient` directly into `streamText` or `generateText`. The SDK handles the execution of tools like `list_document_folders` and returns the structured JSON straight to your UI.

Only if you configure your environment keys to allow it. The agent uses `list_employee_contracts` to fetch contract start dates and salaries, but it only accesses what your API token permits.

Your sensitive employee records and contract details never touch Vercel's permanent storage. The MCP server runs inside a zero-trust, isolated V8 sandbox that processes the data temporarily and discards it immediately after streaming.

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