How to Use the Focus Varejo MCP in Vercel AI SDK

Q: How does the Vercel AI SDK use Focus Varejo to show live invoice data?

The AI SDK streams the response from the MCP server's consultnfce tool. As the Focus Varejo API returns data, it's immediately sent to the browser and rendered in your UI, creating a live-updating experience without waiting for the full API call to finish.

Q: Can I build a complete POS system with Focus Varejo and the Vercel AI SDK?

You can build the front-end for one. Use emitnfce to issue invoices and consultnfce to check them. The Vercel AI SDK makes the user interface feel fast and responsive by streaming the results directly into your components.

Build real-time fiscal dashboards for your Next.js app with Focus Varejo tools and 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 Focus Varejo MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream Invoice Status Directly to Your UI

Stop showing loading spinners. With the Vercel AI SDK, you can stream fiscal document status right into your React components. When your user wants to check an invoice, your agent calls `consult_nfce` and the status updates on their screen, field by field, as the data arrives. This isn't just for status checks. You can build entire interfaces around issuing documents. Call `emit_nfce` and watch the authorization code and QR code link appear in your UI in real time. It's a much better user experience than waiting for a full response.

Build Interactive Manifest Tools

Let users manage inbound logistics directly from your app. This MCP Server gives your Vercel AI SDK-powered agent tools like `manifest_nfe` and `manifest_cte`. Your user can confirm receipt of goods or flag an issue, and your agent executes the correct manifest action against the Focus Varejo API. The feedback is immediate. The result of the manifest action streams back, letting you update the UI instantly to show the confirmed status. It makes complex fiscal operations feel simple and responsive.

Full Invoice Lifecycle for your AI SDK App

This server provides the essential tools for managing Brazilian retail invoices. Your agent can use `emit_nfce` to generate a new consumer invoice for a point-of-sale transaction. The entire process is handled through the API. Mistakes happen. If an invoice needs to be voided, the `cancel_nfce` tool is there to handle it. You can build a complete, user-facing workflow in your frontend that gives users full control, backed by your agent using this MCP setup.

Setup guide

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

The AI SDK streams the response from the MCP server's `consult_nfce` tool. As the Focus Varejo API returns data, it's immediately sent to the browser and rendered in your UI, creating a live-updating experience without waiting for the full API call to finish.

You can build the front-end for one. Use `emit_nfce` to issue invoices and `consult_nfce` to check them. The Vercel AI SDK makes the user interface feel fast and responsive by streaming the results directly into your components.

Create a UI where a user can review an incoming NF-e. When they click 'Confirm Receipt,' have your agent call the `manifest_nfe` tool with the 'Confirmação da Operação' event. The tool handles the API call, and you can stream the success message back to the UI.

It has 8 tools for Brazilian fiscal compliance. Key ones are `emit_nfce` for retail invoices, `emit_nfcom` for telecom, `manifest_nfe` for confirming goods receipt, and `cancel_nfce` for voiding invoices.

Yes. Your Vercel app communicates with the Vinkius MCP Server, which then calls the Focus Varejo API. The server is ephemeral and doesn't store your NFC-e or NFCom invoice data. All communication is over HTTPS.

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