How to Use the BrasilAPI MCP in Vercel AI SDK

Q: How do I feed BrasilAPI data into Vercel AI SDK streamText?

Pass the getcnpjdetails and getcepdetails tools from the MCP client directly into the tools parameter of streamText. The SDK handles execution and streams the raw Brazilian registry data straight to your React frontend.

Stream real-time Brazilian address, tax registry, and banking data directly into your Next.js 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 BrasilAPI MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Instant CEP and state lookups in Vercel AI SDK

The `get_cep_details` tool fetches address details for any Brazilian postal code and streams them straight to your Vercel AI SDK frontend. By combining this with `list_brazilian_states`, your Vercel AI SDK client verifies regional data on the fly. Your users won't sit staring at a blank loading spinner while the Vercel AI SDK streams Brazilian address details. You will watch the data render in your React components chunk by chunk as your Vercel AI SDK agent processes the Brazilian address.

Stream CNPJ corporate audits via MCP Server

Running `get_cnpj_details` pulls active registration and corporate structure data directly from the official Brazilian registry into your Vercel AI SDK context. Your AI client feeds this CNPJ data straight into Vercel AI SDK's streaming text generation to build instant corporate profiles. You skip backend middleware by running the BrasilAPI lookup on Vercel Edge Functions. This allows your Vercel AI SDK agent to analyze the Brazilian corporate registry live, flagging tax status anomalies before the user even submits their checkout form.

Live FIPE vehicle valuations for your AI chat

Querying `get_fipe_vehicle_price` fetches current market values for cars, motorcycles, and trucks directly from the FIPE database to populate your Vercel AI SDK interface. Your Vercel AI SDK interface displays these Brazilian price trends dynamically as the conversation unfolds. Instead of hardcoding API requests, you let the Vercel AI SDK agent decide when to query FIPE data based on the user's chat input. These Brazilian vehicle valuation numbers feed directly into your Vercel AI SDK components without blocking the main thread.

Setup guide

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

Pass the `get_cnpj_details` and `get_cep_details` tools from the MCP client directly into the `tools` parameter of `streamText`. The SDK handles execution and streams the raw Brazilian registry data straight to your React frontend.

Yes, this MCP Server works on Edge runtimes because it relies on lightweight HTTP transport. You initialize the client with `createMCPClient` inside your route handler to fetch CEP or FIPE data with minimal latency.

Vinkius manages the connection token for you, meaning your Vercel AI SDK code only needs one endpoint configuration. You don't have to manage separate API keys or rotation schedules for Brazilian institutional lookups.

The SDK catches the tool execution error and allows your agent to explain the failure or retry. You can catch these errors in your frontend UI components to show a clean fallback instead of breaking the chat.

All CEP, CNPJ, and bank code queries run inside a zero-trust V8 sandbox on Vinkius. Your Vercel AI SDK client only receives the final sanitised JSON payload, keeping sensitive corporate and personal address data isolated from external exposure.

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