`aggregated_data`

Pack: ibge-br · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/aggregated_data for the schema, then POST the same URL with its arguments for the data.

Pull official IBGE/SIDRA statistical series (inflation, GDP, population, etc.). Specify the aggregate table, variable, periods, and locality. Common examples: IPCA monthly inflation = aggregate “1737” variable “63”; population estimate = aggregate “6579” variable “9324”. Returns time series keyed by period.

Parameters

Name	Type	Required	Description
`aggregate`	string	yes	SIDRA aggregate (table) id, e.g. “1737” (IPCA) or “6579” (population estimate). Discover ids via list_aggregates.
`variable`	string	yes	Variable id within the aggregate, e.g. “63” (IPCA monthly variation %). Use “all” for every variable.
`periods`	string	no	Periods: “-1” (latest), “-6” (last 6), or explicit like “202604” or “202601-202604”. Default “-1”.
`localities`	string	no	Locality filter, e.g. “N1[all]” (Brazil), “N3[35]” (state SP), “N6[3550308]” (a municipality). Default “N1[all]”. Brackets are auto-encoded.

Example call

Arguments

{
  "aggregate": "1737",
  "variable": "63",
  "periods": "-1",
  "localities": "N1[all]"
}

curl

curl -X POST https://gateway.pipeworx.io/ibge-br/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"aggregated_data","arguments":{"aggregate":"1737","variable":"63","periods":"-1","localities":"N1[all]"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('aggregated_data', {
  "aggregate": "1737",
  "variable": "63",
  "periods": "-1",
  "localities": "N1[all]"
});

More examples

{
  "aggregate": "6579",
  "variable": "9324",
  "periods": "-6",
  "localities": "N3[35]"
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the ibge-br pack

{
  "mcpServers": {
    "ibge-br": {
      "url": "https://gateway.pipeworx.io/ibge-br/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

aggregated_data