• DISCOVERY
  • SPECIFICATION
  • CONTEXT
  • HUMAN

How to query IBGE statistical tables with your AI

Connect the IBGE Agregados (SIDRA) MCP to your agent. Once it's live, you can find specific survey tables and variables just by asking.

Ask AI about this page

Short answer

How can I find IBGE survey data with my AI?

You ask your agent for specific topics or regions, and it searches the SIDRA database to find matching tables and variables. This gives you the exact identifiers needed for your research.

The results

What your AI delivers

The AI handles the database lookups so you don't have to browse the SIDRA website manually.

DISCOVERY

Find survey tables

The AI scans the IBGE catalog to find aggregations that match your request. You get a list of relevant table IDs.

SPECIFICATION

Identify variables

The AI looks inside specific tables to find the exact indicators and metrics available. You get the precise variable names for your query.

CONTEXT

Get table metadata

The AI pulls structural details and descriptions for the tables it finds. This helps you confirm the data context.

HUMAN

Final selection

You review the list of variables and metadata the AI found. You decide which specific data points are right for your work.

The workflow

What your AI does when you ask for data.

Your agent acts as a bridge between your natural language and the IBGE database.

  1. Search for tables

    The AI looks through the IBGE system to find survey aggregations that match your keywords.

    list_agregados

  2. List variables

    Once a table is identified, the AI checks what specific metrics are contained within it.

    get_variaveis

  3. Retrieve metadata

    The AI pulls the technical descriptions and structural info for the selected tables.

    get_metadados

  4. Refine results

    The AI uses the metadata and variable lists to narrow down the search if the first results are too broad.

    list_agregadosget_variaveis

Try it

Copy these to start.

Paste these into your chat to begin searching the IBGE database.

Starting points

Replace the bracketed text with the specific Brazilian states, years, or economic topics you are researching.

IBGE Agregados (SIDRA) Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_gztrRO9h9OaBHl3vpII3qZud4Kr06xUkVSzGTi0K/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — IBGE Agregados (SIDRA) capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "ibge-agregados-sidra-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_gztrRO9h9OaBHl3vpII3qZud4Kr06xUkVSzGTi0K/mcp"
    }
  }
}
Copy into chat04

  • Find all IBGE survey tables related to [unemployment].

  • What variables are available in the [specific table ID] table?

  • Show me the metadata for the [specific survey] survey.

  • Search for tables containing [population density] data for [Rio de Janeiro].

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect IBGE Agregados (SIDRA) once, then ask.

Click the link to connect the MCP to your agent. Your credentials stay encrypted, and you can start querying immediately.

Connect IBGE Agregados (SIDRA) to your AI

FAQ

How this task behaves

  • 01

    Can my AI download the raw data files?

    No. The AI uses these tools to find and describe tables and variables. It does not download files.

  • 02

    Can the AI change any data in the IBGE system?

    No. This connection is read-only. The AI can only look up information.

  • 03

    Can I ask for data using English descriptions?

    Yes. You can ask in English, and the AI will find the corresponding Portuguese data in the SIDRA system.

  • 04

    Can the AI see the specific variables in a table?

    Yes. The AI can pull the list of available variables for any table it finds.

  • 05

    Can the AI create its own statistical tables?

    No. The AI can only search for and identify existing tables provided by IBGE.

  • More questions about IBGE Agregados (SIDRA)? The Connector page answers them. See everything the IBGE Agregados (SIDRA) Connector can do

Connect IBGE Agregados (SIDRA) to Claude, Cursor, ChatGPT & more