How to Use the IBGE Agregados (SIDRA) MCP in VS Code Copilot

Q: How do we share the IBGE Agregados (SIDRA) tools with our team in VS Code Copilot?

Create a .vscode/mcp.json file in your repository root and add the server configuration. When team members open the workspace in VS Code 1.96+ with Copilot, the tools are configured automatically.

Q: Does VS Code Copilot support all five IBGE Agregados (SIDRA) tools?

Yes, Copilot can call all five tools—including getlocalidades and getvariaveis—to inspect schemas, query periods, and map geographic levels directly from the chat interface.

Q: How do I debug a failed SIDRA query using VS Code Copilot?

Ask Copilot to run getmetadados for the table ID you are querying. It will inspect the returned schema to find missing classifications or invalid variable codes, then correct your query code.

Equip your engineering team with live IBGE Agregados (SIDRA) dataset schemas directly in VS Code Copilot.

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 VS Code Copilot

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Standardize IBGE data queries across your team

The `list_agregados` tool allows your development team to search and discover official Brazilian census tables directly from the sidebar. It returns standardized table IDs and descriptions based on your search criteria. By committing this MCP Server configuration to your repository, every developer using VS Code Copilot gets identical access to the SIDRA catalog. This eliminates manual copy-pasting of dataset IDs from browser tabs.

Validate temporal coverage before fetching data

The `get_periodos` tool extracts the exact years, quarters, or months populated for a specific IBGE table. It tells your agent precisely which time ranges are valid for the dataset you want to query. VS Code Copilot uses this temporal metadata to write strict validation rules. You can pre-validate date ranges in your application before firing expensive API requests to the SIDRA servers.

Inspect metadata structures inside VS Code Copilot

The `get_metadados` tool pulls the complete structural definition of an IBGE aggregate, showing how classifications and variables are organized. It maps out the exact hierarchy of the statistical table. Your agent reads this structure to generate precise parse routines and database schemas. This ensures your data ingestion pipelines handle complex multi-dimensional tables without runtime errors.

Setup guide

Set up IBGE Agregados (SIDRA) MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the IBGE Agregados (SIDRA) MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the IBGE Agregados (SIDRA) tools listed. Try asking: "List my recent IBGE Agregados (SIDRA) transactions" and Copilot will invoke them automatically.

.vscode/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 VS Code Copilot

Create a `.vscode/mcp.json` file in your repository root and add the server configuration. When team members open the workspace in VS Code 1.96+ with Copilot, the tools are configured automatically.

Yes, Copilot can call all five tools—including `get_localidades` and `get_variaveis`—to inspect schemas, query periods, and map geographic levels directly from the chat interface.

Ask Copilot to run `get_metadados` for the table ID you are querying. It will inspect the returned schema to find missing classifications or invalid variable codes, then correct your query code.

No, the server requires an outbound internet connection to reach the official IBGE SIDRA API endpoints. However, the connection is managed securely via Vinkius, requiring only a single endpoint token.

The server only handles public statistical queries, table metadata, and geographic identifiers. Your application source code, proprietary environment variables, and VS Code Copilot session logs are never exposed to the external IBGE 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