How to Use the IBGE Agregados (SIDRA) MCP in OpenAI Agents SDK

Q: How do I connect the IBGE Agregados (SIDRA) MCP Server to OpenAI Agents SDK?

Just run pip install openai-agents and initialize the server with MCPServerStreamableHttp using your Vinkius URL. Pass that instance directly to your agent constructor inside the servers list. That covers it.

Q: Can my agent fetch specific timeframes from IBGE Agregados (SIDRA) with OpenAI Agents SDK?

Yes, your agent calls getperiodos to inspect the available years or months for a specific table first. This prevents the agent from requesting out-of-bounds dates, which would otherwise trigger silent failures.

Q: How does OpenAI Agents SDK handle variable schema validation for IBGE Agregados (SIDRA)?

The agent calls getvariaveis to check the exact variables available for an aggregate. It matches these variables against its internal schema to ensure it only requests data points relevant to your analysis.

Query official Brazilian census and economic data directly from your OpenAI Agents SDK workflows.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect IBGE Agregados (SIDRA) MCP to OpenAI Agents SDK

Create your Vinkius account to connect IBGE Agregados (SIDRA) to OpenAI Agents 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 Agregados (SIDRA) with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Discover Brazilian datasets with `list_agregados`

The `list_agregados` tool lets your agent search and filter the entire IBGE SIDRA database of economic surveys and demographic tables. It acts as the entry point for your agent to find specific statistical series without hardcoding IDs. Your agent runs this query first, registers the exact table IDs, and automatically configures its next steps. This discovery phase runs inside the OpenAI SDK sandbox, keeping your automated pipelines predictable and contained.

Map geographic hierarchies for OpenAI Agents SDK

The `get_localidades` tool resolves complex Brazilian regional structures like states, municipalities, and microregions for any aggregate table. Your agent uses it to map data points to exact administrative divisions before pulling raw numbers. This MCP server ensures your agent only queries regions that actually exist in the IBGE dataset. By validating these geographic levels, the agent avoids requesting invalid regional combinations.

Inspect variables using `get_metadados`

The `get_metadados` tool pulls structural metadata, while `get_variaveis` and `get_periodos` pull specific table variables and temporal coverage. Your agent inspects these endpoints to build precise query schemas before hitting the live database. This MCP tool validation step prevents bad API calls and payload bloat. OpenAI's agent dashboard traces these metadata queries, giving you a clear view of how the model structures its data-gathering steps.

Setup guide

Set up IBGE Agregados (SIDRA) MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all IBGE Agregados (SIDRA) tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives IBGE Agregados (SIDRA) tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate IBGE Agregados (SIDRA) tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="IBGE Agregados (SIDRA) Agent",
            instructions="You have access to IBGE Agregados (SIDRA) tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 Agregados (SIDRA). 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 Agregados (SIDRA) 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 Agregados (SIDRA) MCP in OpenAI Agents SDK

Just run `pip install openai-agents` and initialize the server with `MCPServerStreamableHttp` using your Vinkius URL. Pass that instance directly to your agent constructor inside the servers list. That covers it.

Yes, your agent calls `get_periodos` to inspect the available years or months for a specific table first. This prevents the agent from requesting out-of-bounds dates, which would otherwise trigger silent failures.

The agent calls `get_variaveis` to check the exact variables available for an aggregate. It matches these variables against its internal schema to ensure it only requests data points relevant to your analysis.

You can configure tool access directly in your agent system. This prevents the agent from running arbitrary discovery queries when you only want it pulling metadata via the MCP server.

Your queries for Brazilian census and economic data run through Vinkius's secure, ephemeral sandbox. No raw data is cached or stored on the platform, and your connection uses a single secure endpoint token.

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