How to Use the IBGE Censo & SIDRA — Dados Censitários MCP in Cursor

Q: How do I search for specific census tables using IBGE Censo & SIDRA — Dados Censitários in Cursor?

Ask the Cursor Agent to locate a dataset, and it will run listagregados to search the SIDRA catalog. It returns the exact table IDs directly to your chat or inline edit session.

Q: Can I write tests using live data from the IBGE Censo & SIDRA — Dados Censitários MCP Server in Cursor?

Yes, you can have the agent use getagregadodata to pull actual economic metrics into your test suites. This ensures your assertions run against real API payloads instead of mock objects.

Q: How does Cursor handle complex geographic filters with the IBGE Censo & SIDRA — Dados Censitários tools?

Cursor uses getagregadometadados to identify the correct geographic levels, such as national or municipal. It then builds the precise query parameters for getagregadodata.

Inject live Brazilian census and economic data directly into your codebase with Cursor Agent.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect IBGE Censo & SIDRA — Dados Censitários MCP to Cursor

Create your Vinkius account to connect IBGE Censo & SIDRA — Dados Censitários to Cursor 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 Censo & SIDRA — Dados Censitários with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Browse SIDRA Datasets via MCP Server

`list_agregados` queries the official Brazilian statistical database to find active tables and survey groups directly from your editor. Instead of writing mock arrays or guessing table IDs, your AI agent runs this tool to locate the exact datasets you need for your code. It keeps you focused on your editor without browser distractions. Once the agent finds the right table, it uses `get_agregado_metadados` to inspect the schema. This tool returns the exact classifications, variables, and geographic levels available. Your code can then be written to handle the precise structure of the incoming payload, avoiding runtime errors.

Verify Time Series Ranges on the Fly

`get_agregado_periodos` pulls the exact years, quarters, or months available for any target dataset. Because Brazilian census and economic indicators use highly specific temporal schedules, this step ensures your application doesn't request missing dates. Your agent checks this metadata before generating any fetch routines. This validation step is crucial when building financial or demographic models. By knowing the available periods, the agent writes reliable loops that query data sequentially. Your code remains clean, predictable, and fully aligned with the actual API limits.

Generate Code with Live API Data

`get_agregado_data` retrieves the actual numbers from the selected SIDRA tables at the geographic resolution you specify. Your agent uses this tool to pull live economic metrics directly into your workspace. It can then generate parsing functions, test cases, or data models using real numbers instead of placeholder stubs. This direct integration speeds up development. You can test your data pipelines using live IPCA inflation rates or population counts from the start. The MCP Server acts as a bridge, giving Cursor the context it needs to write production-grade code.

Setup guide

Set up IBGE Censo & SIDRA — Dados Censitários MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the IBGE Censo & SIDRA — Dados Censitários MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent IBGE Censo & SIDRA — Dados Censitários transactions." If the MCP tools are loaded correctly, Cursor will call the IBGE Censo & SIDRA — Dados Censitários tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "ibge-censo-sidra-dados-censitarios-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. 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 Censo & SIDRA — Dados Censitários 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 Censo & SIDRA — Dados Censitários MCP in Cursor

Ask the Cursor Agent to locate a dataset, and it will run `list_agregados` to search the SIDRA catalog. It returns the exact table IDs directly to your chat or inline edit session.

Yes, you can have the agent use `get_agregado_data` to pull actual economic metrics into your test suites. This ensures your assertions run against real API payloads instead of mock objects.

Cursor uses `get_agregado_metadados` to identify the correct geographic levels, such as national or municipal. It then builds the precise query parameters for `get_agregado_data`.

No, you do not need to store credentials locally. The Vinkius platform handles all MCP Server connections securely, requiring only a single token in your global configuration file.

Queries for census, inflation, and demographic aggregates are executed in an ephemeral, isolated sandbox. Your raw statistical requests are processed securely, and no sensitive code from your editor is ever exposed.

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