How to Use the IBGE Serviços de Dados MCP in Mastra AI

Q: How do I manage tool approval for IBGE Serviços de Dados in Mastra AI?

You can toggle the requireToolApproval setting in your Mastra agent configuration. This gives you a human-in-the-loop gate before any data-intensive action runs.

Q: Can I chain IBGE Serviços de Dados tools in a single Mastra AI workflow?

You can. Agents can call getmetadados first to understand the structure of a report, then call getagregados to extract the specific numbers you need.

Build reliable Brazilian market research workflows in Mastra AI with official data pipelines.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect IBGE Serviços de Dados MCP to Mastra AI

Create your Vinkius account to connect IBGE Serviços de Dados to Mastra AI 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 Serviços de Dados with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated research workflows

Use `get_calendario` to trigger research tasks exactly when new IBGE data drops. Mastra AI agents can monitor these releases and kick off analysis pipelines automatically. If an API request hits a temporary snag, the workflow engine handles the retry logic for you. You don't have to write custom code to keep your data collection stable.

Conditional data branching

Create decision trees where your agent queries `get_agregados` and branches based on the result. If the economic output meets your threshold, the agent continues to the next step. This logic keeps your operations focused. You only spend compute time on regions or sectors that actually match your criteria.

Geographic data ingestion

Pull complex geographic shapes with `get_malha_estado` and feed them into your internal GIS processes. The integration allows your agent to handle multi-step spatial tasks without human intervention. Use `get_nome_geografico` to verify location data before processing. This ensures your workflow is always working with accurate, official geographic identifiers.

Setup guide

Set up IBGE Serviços de Dados MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All IBGE Serviços de Dados tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "ibge-servicos-de-dados-mcp-client",
  servers: {
    "ibge-servicos-de-dados-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "IBGE Serviços de Dados Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to IBGE Serviços de Dados tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent IBGE Serviços de Dados transactions"
);
console.log(result.text);

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 Serviços de Dados 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 Serviços de Dados MCP in Mastra AI

You can toggle the `requireToolApproval` setting in your Mastra agent configuration. This gives you a human-in-the-loop gate before any data-intensive action runs.

Absolutely. You can set up exponential backoff in your workflow definition to handle any transient connectivity issues with the IBGE API.

You can. Agents can call `get_metadados` first to understand the structure of a report, then call `get_agregados` to extract the specific numbers you need.

It is. Once you point your Mastra agent to the server URL, the tools become available for any cloud deployment you choose.

The server operates in an isolated sandbox. It only accesses public census and economic records, protecting your internal infrastructure from external data 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