How to Use the PHC GO MCP in Vercel AI SDK

Q: How do I configure the PHC GO MCP Server inside Vercel AI SDK?

Install @ai-sdk/mcp and initialize the client using createMCPClient with your Vinkius HTTP URL. Pass the tool definitions directly into streamText or generateText. Remember to call mcpClient.close() once the execution finishes so you don't run into memory leaks on your serverless function.

Q: How does this MCP Server handle Portuguese tax compliance?

This MCP Server exposes listtaxes and listseries to let your agent verify tax rates and invoice numbering series before writing data. This mechanism ensures that any document created through the SDK complies with local fiscal regulations.

Q: What is the fastest way to display product lists in Vercel AI SDK?

Use the listproducts tool to fetch your catalog. Our SDK streams the product array chunk by chunk, allowing your frontend to render the list progressively rather than waiting for the entire payload to download.

Stream live PHC GO ERP data directly to your React components in real-time with Vercel AI SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect PHC GO MCP to Vercel AI SDK

Create your Vinkius account to connect PHC GO to Vercel AI SDK — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup PHC GO with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Stream live stock updates with Vercel AI SDK

Active inventory movements flow directly from your Portuguese ERP system via the `list_stocks` tool. Your application calls this endpoint inside an Edge Function to grab exact quantities. The user sees numbers populate instantly on their screen without staring at an empty loading state. By chaining `get_product_details` with this tool, your interface renders product specs and real-time stock balances side-by-side. The Vercel AI SDK processes these chunks as they arrive. This approach prevents stale inventory displays during peak sales hours.

Query client balances in your UI

Outstanding balances and pending movements are instantly fetched by the `list_current_accounts` tool. Your agent triggers this query when a user asks about their financial status. Our SDK handles the stream, rendering the ledger line-by-line as the data feeds in. You can run `search_customers` to find the exact entity ID before pulling the ledger. This two-step process ensures your frontend displays the correct account statements. It's a clean way to eliminate database roundtrips and keep your client-side state secure.

Issue invoices directly from the edge

Commercial documents like invoices and quotes are written directly to PHC GO using the `create_document` tool. Your web app runs this tool on Vercel's edge network to process transactions instantly. Your user watches the document status transition from draft to finalized in real-time. To ensure correct taxation, the agent calls `list_taxes` and `list_series` before generating the invoice via this MCP Server. This validation step guarantees that every generated document complies with local Portuguese fiscal rules. The resulting invoice ID is passed straight back to your UI.

Setup guide

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

Install `@ai-sdk/mcp` and initialize the client using `createMCPClient` with your Vinkius HTTP URL. Pass the tool definitions directly into `streamText` or `generateText`. Remember to call `mcpClient.close()` once the execution finishes so you don't run into memory leaks on your serverless function.

Yes, you can stream the execution steps directly to your React frontend when your agent invokes `create_document`. This allows you to show users exactly when the invoice is drafted, tax-checked via `list_taxes`, and finalized.

This MCP Server exposes `list_taxes` and `list_series` to let your agent verify tax rates and invoice numbering series before writing data. This mechanism ensures that any document created through the SDK complies with local fiscal regulations.

Use the `list_products` tool to fetch your catalog. Our SDK streams the product array chunk by chunk, allowing your frontend to render the list progressively rather than waiting for the entire payload to download.

Vinkius runs your MCP Server inside an isolated V8 sandbox, routing credentials through a single secure endpoint token. Your sensitive ERP data, including customer records, product details, and financial ledgers, never touches third-party databases during transmission.

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