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

Q: How do I query IBGE Agregados (SIDRA) data using Claude Desktop?

Start by telling your agent to find a dataset using listagregados. Once you identify the table, Claude Desktop will automatically call getmetadados and getvariaveis to construct the exact query parameters for the statistical data you need.

Q: How do I configure this MCP Server in Claude Desktop?

Open your claudedesktopconfig.json file and add the server configuration under the mcpServers key. Include the command and arguments provided in your Vinkius dashboard, then restart Claude Desktop to load the tools.

Q: What happens if a SIDRA query returns too many rows?

The getvariaveis and getperiodos tools help narrow your search beforehand. Your agent uses these to split large requests into smaller, geographic or temporal chunks, preventing Claude Desktop from hitting context window limits.

Pull Brazilian census and economic data from SIDRA directly into Claude Desktop to build instant charts and reports.

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 Claude Desktop

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Discover SIDRA tables in Claude Desktop

The `list_agregados` tool lets your agent search through the massive catalog of IBGE surveys and tables without leaving your chat window. It queries the official Brazilian statistical database using specific filters, returning clean lists of available aggregates. When you run this inside Claude Desktop, the local stdio transport processes the search parameters instantly. You get the exact table IDs you need to start pulling census or inflation numbers.

Map geographic hierarchies inside your chat

The `get_localidades` tool extracts the specific geographic levels and regional divisions available for any given IBGE table. It breaks down data availability by state, municipality, or microregion so you know exactly how granular your query can get. Your local Claude Desktop client reads this structural data to prepare precise API requests. This prevents errors from requesting geographic breakdowns that do not exist for older surveys.

Extract exact variables and timeframes

The `get_variaveis` tool fetches the precise statistical variables, while `get_periodos` pulls the available years or months for your chosen SIDRA table. These tools work together to define the exact coordinates of the data points you want to pull. By running this MCP Server locally, your agent combines these variables and periods to construct valid queries. You avoid massive, raw payloads by filtering the schema before fetching the actual numbers.

Setup guide

Set up IBGE Agregados (SIDRA) MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The IBGE Agregados (SIDRA) MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the IBGE Agregados (SIDRA) MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under ibge-agregados-sidra-mcp.

json

{
  "mcpServers": {
    "ibge-agregados-sidra-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Claude Desktop

Start by telling your agent to find a dataset using `list_agregados`. Once you identify the table, Claude Desktop will automatically call `get_metadados` and `get_variaveis` to construct the exact query parameters for the statistical data you need.

Yes, you can connect this server to claude.ai as a custom connector. Paste the hosted HTTPS URL provided by Vinkius into your Claude integration settings, and the five SIDRA tools will become active in your browser.

Open your `claude_desktop_config.json` file and add the server configuration under the `mcpServers` key. Include the command and arguments provided in your Vinkius dashboard, then restart Claude Desktop to load the tools.

The `get_variaveis` and `get_periodos` tools help narrow your search beforehand. Your agent uses these to split large requests into smaller, geographic or temporal chunks, preventing Claude Desktop from hitting context window limits.

This server only processes public IBGE metadata, geographic codes, and aggregate statistical parameters. No personal data or proprietary code from your Claude Desktop workspace is ever transmitted to the external SIDRA API.

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