How to Use the IBGE Agregados (SIDRA) MCP in AutoGen

Q: How do I register the IBGE Agregados (SIDRA) MCP Server tools with AutoGen?

Install the extension with pip install -U "autogen-extmcp". Use StreamableHttpServerParams to connect to Vinkius, then pass the tools directly to your AssistantAgent.

Q: Can AutoGen agents resolve conflicting regional codes from IBGE Agregados (SIDRA)?

Yes. A coordinator agent can use getlocalidades to inspect geographic structures, allowing specialized regional agents to align their spatial queries.

Let your AutoGen agents debate and verify Brazilian statistical data from IBGE Agregados (SIDRA) via MCP.

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 AutoGen

Create your Vinkius account to connect IBGE Agregados (SIDRA) to AutoGen 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 AutoGen

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Debate IBGE Table Selection with AutoGen and MCP

The `list_agregados` tool searches the IBGE survey registry to find tables matching your criteria. In AutoGen, one agent can propose a set of tables while another agent validates their relevance. This collaborative approach ensures your multi-agent system selects the best statistical source. It prevents the system from running calculations on the wrong dataset.

Verify Variables and Metadata Structure

The `get_variaveis` tool gets the variables for a table, and `get_metadados` gets the metadata to explain what those variables represent. Your data analyst agent can fetch these details to plan an extraction schema. A separate critic agent can analyze this schema to ensure the units and classifications match your project requirements. This check happens before any heavy data pull occurs.

Resolve Geographic and Temporal Scope

The `get_localidades` tool lists the geographic levels for a table, and `get_periodos` lists the available years. These tools define the physical boundaries of your dataset. AutoGen agents can negotiate which geographic levels to query based on regional data availability. This prevents errors when combining datasets that use different regional boundaries.

Setup guide

Set up IBGE Agregados (SIDRA) MCP in AutoGen

Prerequisites

Python 3.10+ installed
autogen-ext[mcp] package
Active Vinkius subscription with a valid endpoint token

1

Install AutoGen with MCP
Run pip install "autogen-ext[mcp]" autogen-agentchat. The MCP extension includes mcp_server_tools for stateless tool access.
2

Fetch tools from the MCP
Call mcp_server_tools(SseServerParams(url=...)) with your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Run your agent
Pass the tools to AssistantAgent and call agent.run(). The agent invokes IBGE Agregados (SIDRA) tools and returns structured results.

agent.py

from autogen_ext.tools.mcp import SseServerParams, mcp_server_tools
from autogen_agentchat.agents import AssistantAgent
from autogen_ext.models.openai import OpenAIChatCompletionClient

server_params = SseServerParams(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

tools = await mcp_server_tools(server_params)

agent = AssistantAgent(
    name="IBGE Agregados (SIDRA)_assistant",
    model_client=OpenAIChatCompletionClient(model="gpt-4o"),
    tools=tools,
)

result = await agent.run("List recent IBGE Agregados (SIDRA) data")
print(result.messages[-1].content)

Get your connection token →

Prerequisites

Python 3.10+ installed
autogen-ext[mcp] + autogen-agentchat
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Same packages as above. McpWorkbench is ideal when your agent needs stateful sessions across multiple tool calls.
2

Use McpWorkbench as context manager
Wrap your agent in async with McpWorkbench(...) to maintain shared state and resources. The workbench manages the full MCP session lifecycle.
3

Run with workbench
Pass workbench=workbench to your agent. State is preserved across multiple tool calls within the same session.

agent.py

from autogen_ext.tools.mcp import McpWorkbench, SseServerParams
from autogen_agentchat.agents import AssistantAgent
from autogen_ext.models.openai import OpenAIChatCompletionClient

server_params = SseServerParams(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

async with McpWorkbench(server_params) as workbench:
    agent = AssistantAgent(
        name="IBGE Agregados (SIDRA)_assistant",
        model_client=OpenAIChatCompletionClient(model="gpt-4o"),
        workbench=workbench,
    )

    result = await agent.run("List recent IBGE Agregados (SIDRA) data")
    print(result.messages[-1].content)

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 AutoGen

Install the extension with `pip install -U "autogen-ext[mcp]"`. Use `StreamableHttpServerParams` to connect to Vinkius, then pass the tools directly to your `AssistantAgent`.

Yes. A coordinator agent can use `get_localidades` to inspect geographic structures, allowing specialized regional agents to align their spatial queries.

Vinkius handles all authentication and connection pooling on its side. Your AutoGen agents only need one secure endpoint token to access all five tools.

Yes. Any agent in your AutoGen group chat can invoke tools like `get_periodos` to verify data availability before contributing to the group decision.

All Brazilian statistical queries are executed within a sandboxed V8 environment. Vinkius never logs or retains your query payloads, keeping your demographic research secure.

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