How to Use the Lucca (HR & Finance Suite) MCP in Vercel AI SDK
Build real-time HR interfaces using Vercel AI SDK to stream Lucca expense reports and leave balances directly into your frontend.
Works with every AI agent you already use
…and any MCP-compatible client
Connect Lucca (HR & Finance Suite) MCP to Vercel AI SDK
Create your Vinkius account to connect Lucca (HR & Finance Suite) 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.
Live HR Directory Streaming with Vercel AI SDK
The `list_users` tool fetches your entire employee directory from Lucca and feeds it straight to your Vercel AI SDK chat interface. Your frontend streams the list of active team members in real-time as the model processes the query. This setup removes the latency of traditional REST calls by letting users filter departments or search profiles dynamically without waiting for a full payload download. Under the hood, you initialize the connection with `createMCPClient` and pass the tools to `streamText`. When a user asks about a coworker, the agent calls `get_user` to grab specific UUID details. You close the connection using `mcpClient.close()` once the edge function finishes executing.
Real-Time Expense Tracking and UI Rendering
The `list_expense_reports` tool retrieves active Cleemy reports and feeds them directly into your streaming UI components. Instead of displaying a blank loading card, your application renders expense line items one by one as they come back from the Lucca API. Your agent can instantly call `list_expense_claims` to break down individual costs for any flagged report. Because Vercel AI SDK supports edge environments, these calls execute in lightweight runtimes close to your users. You configure the MCP server endpoint with your Vinkius token, ensuring secure, low-latency financial lookups. The agent parses the expense fields and formats them into clean, interactive UI tables on the fly.
Instant Leave Balance Checks on the Edge
The `get_leave_balances` tool pulls active vacation arrays from Timmi Absences directly into your user-facing chat widget. Your agent reads the current balances and calculates remaining time off instantly. It can also call `list_leaves` to show pending requests alongside the current balance. You implement this by wrapping the Vinkius MCP server tools in your standard `streamText` call. If a user asks to plan a trip, the agent checks their balance, verifies department coverage using `list_departments`, and outputs the recommended dates. OAuth tokens are managed securely through the `authProvider` configuration.
Set up Lucca (HR & Finance Suite) MCP in Vercel AI SDK
Prerequisites
- Node.js 18+ and a TypeScript project
-
ai+@modelcontextprotocol/sdkpackages - Active Vinkius subscription with a valid endpoint token
- 1
Install dependencies
Run
npm install ai @modelcontextprotocol/sdkplus your preferred model provider (e.g.@ai-sdk/openai). - 2
Create the Streamable HTTP transport
Use
StreamableHTTPClientTransportwith 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 Lucca (HR & Finance Suite) tools. Pass them directly togenerateText()orstreamText()— 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.
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 Lucca (HR & Finance Suite) transactions",
});
console.log(text);
await mcpClient.close();Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Lucca. 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.
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 Lucca (HR & Finance Suite) MCP in Vercel AI SDK
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the Lucca (HR & Finance Suite) MCP today
We host it, we monitor it, we maintain it. You just paste one token.
