How to Use the Focus NFe MCP in Vercel AI SDK

Q: Can I emit both product and service invoices with Focus NFe in Vercel AI SDK?

Yes, you can. Use emitnfe for product tax documents and emitnfse for service invoices. The SDK streams the execution state so your users see the progress of each tax validation live.

Q: How does the Focus NFe MCP Server handle SEFAZ latency issues inside Vercel AI SDK?

The consultdocument tool allows your agent to check the status of a pending invoice if SEFAZ takes too long to respond. You can run this check asynchronously in an Edge Function without blocking your main UI thread.

Q: Can I cancel an active invoice using this setup?

Yes, the canceldocument tool lets your agent submit cancellation requests. The tool returns the authorization status from the Brazilian tax authorities immediately, so you can update your database.

Get real-time Brazilian tax invoice emissions and XML downloads streaming directly into your React UI with 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 NFe MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Real-Time Invoice Generation in Vercel AI SDK

The `emit_nfe` tool initiates product invoice creation directly from your user-facing chat interface. By pairing this tool with your frontend, users watch the Brazilian tax authority validation happen live instead of staring at a static loading spinner. Your React components render the response object immediately. Because this MCP Server runs on Vinkius, you don't have to manage complex state machines to show whether the invoice passed SEFAZ validation.

Instant Municipal Service Billing

The `emit_nfse` tool handles municipal tax document generation for services directly through your Vercel AI SDK application. It formats the complex payload required by municipal prefeituras without blocking your main application thread. Edge Function compatibility ensures your billing actions run close to your users. You get immediate status updates back from the API, allowing your frontend to display the final tax values instantly.

Direct XML Downloads in Your Chat UI

The `download_xml` tool fetches the authorized XML payload from the tax authorities. Your interface can trigger this tool automatically right after a successful invoice emission. Users click a button to grab their official Brazilian tax file without leaving the chat. No external database lookups are needed because the MCP client retrieves the raw data directly from the Focus NFe endpoint.

Setup guide

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

You need to pass your Vinkius API token when initializing the client. Set up the transport using createMCPClient with your HTTP endpoint, and then pass the tools directly into streamText or generateText.

Yes, you can. Use emit_nfe for product tax documents and emit_nfse for service invoices. The SDK streams the execution state so your users see the progress of each tax validation live.

The consult_document tool allows your agent to check the status of a pending invoice if SEFAZ takes too long to respond. You can run this check asynchronously in an Edge Function without blocking your main UI thread.

Yes, the cancel_document tool lets your agent submit cancellation requests. The tool returns the authorization status from the Brazilian tax authorities immediately, so you can update your database.

All XML payloads, tax IDs, and invoice values pass through an ephemeral, zero-trust V8 sandbox. Vinkius does not write your sensitive financial data to persistent storage, ensuring your customer tax details remain strictly private.

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