How to Use the IBGE Censo & SIDRA — Dados Censitários MCP in Mastra AI

Q: How do I handle SIDRA rate limits when running Mastra AI workflows with IBGE Censo & SIDRA — Dados Censitários?

You can configure Mastra AI to throttle calls to getagregadodata. By using its native workflow steps, you can space out requests for different census aggregates to avoid hitting IBGE API thresholds.

Q: How does Mastra AI handle schema updates from the IBGE Censo & SIDRA — Dados Censitários MCP Server?

Mastra AI uses getagregadometadados to dynamically discover variables at runtime. This means your workflows won't break if IBGE updates the classification schema of an aggregate table.

Build resilient Brazilian economic workflows using Mastra AI and official IBGE statistical data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect IBGE Censo & SIDRA — Dados Censitários MCP to Mastra AI

Create your Vinkius account to connect IBGE Censo & SIDRA — Dados Censitários 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 Censo & SIDRA — Dados Censitários with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Resilient IBGE data collection workflows

Running resilient queries for IPCA inflation figures relies on executing `get_agregado_data` within your workflow steps. Mastra AI solves the risk of API downtime by wrapping these queries in workflows with built-in retries and exponential backoff. If the SIDRA API takes too long to return the requested numbers, your workflow doesn't crash. Mastra AI automatically retries the request or routes the agent to fallback Brazilian datasets without manual intervention.

Conditional branching based on census metadata

Inspecting the classifications of a target IBGE dataset requires calling `get_agregado_metadados` before parsing actual values. Your agent can run this inspection to understand the variables of a table before deciding how to handle the data. If the SIDRA table contains regional divisions, Mastra AI branches the execution path to trigger localized analysis. When it's national-level census data, Mastra AI routes the payload straight to your consolidated reporting engine.

Automate historical data syncs with Mastra AI

Checking if a new census release or monthly IPCA update is available relies on running `get_agregado_periodos`. This MCP Server lets your Mastra agent verify the latest temporal ranges before triggering any heavy data extractions. If a new period is detected, the Mastra AI workflow triggers `list_agregados` to verify the table structure and pulls the updated numbers. This ensures your Mastra forecasting models always run on the latest official IBGE baselines.

Setup guide

Set up IBGE Censo & SIDRA — Dados Censitários 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 Censo & SIDRA — Dados Censitários 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-censo-sidra-dados-censitarios-mcp-client",
  servers: {
    "ibge-censo-sidra-dados-censitarios-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "IBGE Censo & SIDRA — Dados Censitários Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to IBGE Censo & SIDRA — Dados Censitários tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent IBGE Censo & SIDRA — Dados Censitários 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 Censo & SIDRA — Dados Censitários 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 Censo & SIDRA — Dados Censitários MCP in Mastra AI

You can configure Mastra AI to throttle calls to `get_agregado_data`. By using its native workflow steps, you can space out requests for different census aggregates to avoid hitting IBGE API thresholds.

Yes, you can set up a human-in-the-loop step in Mastra AI before executing `get_agregado_data` on massive tables. This prevents your workflows from pulling millions of rows of census data without verification.

Mastra AI uses `get_agregado_metadados` to dynamically discover variables at runtime. This means your workflows won't break if IBGE updates the classification schema of an aggregate table.

Yes, you can connect your local Mastra agent to the hosted endpoint using the provided connection string, letting you test your data pipelines without setting up local database mirrors.

Every request for Brazilian demographic and inflation metrics is executed in an ephemeral V8 sandbox. Your queries are never cached, logged, or exposed to third parties, preserving the confidentiality of your economic research.

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