How to Use the TOTVS MCP in Vercel AI SDK

Q: What is the best way to list all available TOTVS services with Vercel AI SDK?

You use getavailableservices at the start. This method provides a manifest of every RM DataServer, letting you know exactly what data sources are connected and ready for query.

See TOTVS data appear live in your UI using the Vercel AI SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect TOTVS MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

View Employee Records with Vercel AI SDK

The `get_employee_details` tool pulls specific employee information for you. When an end-user requests details, your AI client streams the data directly into a React component. You'll see fields like department and job title appear instantly, without needing a loading spinner. This speed is crucial when building user-facing tools. Use `list_employees` first to search names, then fetch full records using `get_employee_details`. Your app feels fast because the data streams live.

Real-time Financial Data for Vercel AI SDK

Need to display accounts payable in real time? Call `list_payments` to list all open invoices. The results stream into your frontend immediately, showing the user who owes what. It works just like viewing receipts. By calling `list_receipts`, you can populate a dashboard component with current receivable data. You get live visibility of financial records that feels snappy and responsive.

Manage Workflow Status via Vercel AI SDK

Your agent needs to show the status of a process request? Use `get_process_request` to fetch all current details. The streamable result lets you update your UI right when the data arrives. If the user approves something, call `move_process_request`. This changes the state and streams back the new record immediately. You're showing process progression in real time.

Setup guide

Set up TOTVS 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 TOTVS 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 TOTVS 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 TOTVS. 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 TOTVS 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 TOTVS MCP in Vercel AI SDK

The client handles data streaming for various TOTVS modules, including HR and Finance. It's built to take structured responses from the MCP Server and display them instantly in your front-end components.

You can pull multiple data types, including employee details via `get_employee_details`, company lists using `list_companies`, and document listings from Fluig ECM with `list_documents`.

It handles state changes quickly. For example, you can call `move_process_request` to advance a process and stream the new status back immediately. It's great for showing progression in real-time.

This server touches sensitive employee records (e.g., names and job roles). Ensure your OAuth provider handles token scope restrictions properly when building the application.

You use `get_available_services` at the start. This method provides a manifest of every RM DataServer, letting you know exactly what data sources are connected and ready for query.

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