How to Use the IBGE Pesquisas — Brasil Cidades MCP in Vercel AI SDK

Stream real-time Brazilian municipal data directly into your AI-SDK frontends for instant, data-backed dashboards.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect IBGE Pesquisas — Brasil Cidades MCP to Vercel AI SDK

Create your Vinkius account to connect IBGE Pesquisas — Brasil Cidades 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 IBGE Pesquisas — Brasil Cidades with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live municipal data streaming

Feed IBGE metrics straight into your UI components using `get_indicadores`. Your users won't stare at loading spinners while the data pulls; it just flows into the view. This MCP Server handles the handshake, letting you push population or agricultural stats into your React or Next.js apps the moment the agent finishes the query.

Instant regional ranking

Compare city performance side-by-side by calling `get_ranking_indicador`. It sorts the mess of raw numbers into a clear hierarchy that your app can display immediately. Your AI client interprets these rankings to explain why one municipality outperforms another. You get the raw data and the context in a single request cycle.

Survey results on demand

Access the full range of IBGE research programs using `list_pesquisas` and `get_resultados`. Your frontends can now toggle between different social domains without needing extra backend endpoints. It keeps your edge functions lean. You connect, query, and close the session, ensuring your application remains fast even when dealing with heavy government datasets.

Setup guide

Set up IBGE Pesquisas — Brasil Cidades 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 IBGE Pesquisas — Brasil Cidades 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 IBGE Pesquisas — Brasil Cidades 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 IBGE. 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 IBGE Pesquisas — Brasil Cidades 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 IBGE Pesquisas — Brasil Cidades MCP in Vercel AI SDK

You connect the server via the MCP transport layer to your AI-SDK project. Once linked, the tools become functions your agents call to fetch live stats directly into your frontend.

Yes, because the server transmits only what you request. You pull specific indicators, which prevents your client-side state from bloating with unnecessary municipal records.

It runs in a sandbox environment that isolates your data requests. Your endpoint token keeps the connection private, ensuring that no unauthorized client can ping the IBGE data.

The server returns standard error codes that you can catch in your stream logic. It allows you to display a fallback message to the user instead of breaking the UI.

No. The server only accesses public aggregate statistics provided by IBGE. It does not store or process any identifiable personal information.

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