How to Use the IBGE Nomes MCP in AutoGen

Q: How do I install the IBGE Nomes MCP Server tools for AutoGen?

Run pip install -U "autogen-extmcp" to get the extension. Then, use the mcpservertools function with the server URL to register the tools with your AssistantAgent.

Let your AutoGen agents debate and analyze Brazilian naming trends using official IBGE 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 Nomes MCP to AutoGen

Create your Vinkius account to connect IBGE Nomes 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 Nomes with AutoGen

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Resolve demographic debates with historical frequency data

The `get_name_frequency` tool provides the hard numbers needed to settle disagreements between your conversational agents. One agent might argue a naming trend peaked in the 1980s, while another queries this tool to prove otherwise. By feeding pipe-separated names into the tool, your AutoGen agents compare multiple historical trajectories simultaneously. The resulting data fuels structured arguments based on actual census records.

Filter regional rankings using an AutoGen MCP Server

The `get_names_ranking` tool allows specialized agents to request localized popularity data for specific regions in Brazil. A researcher agent requests the data, while a critic agent analyzes it for regional bias. This MCP Server fits into your multi-agent workflow by converting tool schemas automatically via the McpToolAdapter. Your agents collaborate on complex sociological profiles without manual coding.

Coordinate multi-agent consensus on naming trends

The `get_names_ranking` and `get_name_frequency` tools give your conversational team the exact data points required for consensus. An analyst agent drafts a report, a statistician queries the IBGE tools to verify the facts, and a writer refines the final output. You register these MCP tools with the AssistantAgent constructor. The agents dynamically decide when to call the API to verify a claim during their group chat.

Setup guide

Set up IBGE Nomes 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 Nomes 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 Nomes_assistant",
    model_client=OpenAIChatCompletionClient(model="gpt-4o"),
    tools=tools,
)

result = await agent.run("List recent IBGE Nomes 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 Nomes_assistant",
        model_client=OpenAIChatCompletionClient(model="gpt-4o"),
        workbench=workbench,
    )

    result = await agent.run("List recent IBGE Nomes 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. 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 Nomes 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 Nomes MCP in AutoGen

Run pip install -U "autogen-ext[mcp]" to get the extension. Then, use the mcp_server_tools function with the server URL to register the tools with your AssistantAgent.

Yes, that is the whole point of a multi-agent group chat. Any agent you configure with the tools can invoke `get_name_frequency` or `get_names_ranking` to back up its arguments.

The agent automatically formats the name string with pipe characters when calling `get_name_frequency`. This allows it to fetch statistics for multiple Brazilian names in a single step.

The integration supports both stdio and Streamable HTTP transports. You configure this using the StreamableHttpServerParams when initializing the server tools in your code.

No, this server only processes public aggregate Brazilian name statistics. It runs in a secure, ephemeral sandbox environment that guarantees no private user information is ever exposed or stored.

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