Servers Playground How we check Add a server Log in

Open Economics

Working · 5.3 s

io.github.felipegambettadesouza6-jpg/open-economicsv2.0.2

Discover, resolve, and query official Brazilian economic data with semantic search and provenance.

Data & Databases

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://open-economics-data.knbf982hkn.chatgpt.site/api/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

describe_official_dataset Read-only

Get identity, publisher, collection, provenance links, query capability, and any stable Open Economics series shortcuts for an exact dataset ID returned by search_official_data. This does not fetch observations.

dataset_idstring, required

Exact ID returned by search_official_data, such as bcb-sgs:432, ibge-aggregates:5932, siconfi:dca, tesouro-rtn:government-central, tesouro-dpf:debt-profile, comexstat:general, anp:fuel-prices, epe:electricity-consumption, mte:formal-employment, or cvm:investment-funds.

Open Economics MCP server | mcptry

Tools (19)

describe_official_dataset

read-only

Argument	Type	Description
dataset_id*	string	Exact ID returned by search_official_data, such as bcb-sgs:432, ibge-aggregates:5932, siconfi:dca, tesouro-rtn:government-central, tesouro-dpf:debt-profile, comexstat:general, anp:fuel-prices, epe:electricity-consumption, mte:formal-employment, or cvm:investment-funds.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "dataset_id": {
      "type": "string",
      "pattern": "^(?:(?:bcb-sgs|ibge-aggregates):\\d+|siconfi:(?:rreo|rgf|dca|entes)|tesouro-rtn:government-central|tesouro-dpf:debt-profile|comexstat:general|anp:fuel-prices|epe:electricity-consumption|mte:formal-employment|cvm:investment-funds)$",
      "description": "Exact ID returned by search_official_data, such as bcb-sgs:432, ibge-aggregates:5932, siconfi:dca, tesouro-rtn:government-central, tesouro-dpf:debt-profile, comexstat:general, anp:fuel-prices, epe:electricity-consumption, mte:formal-employment, or cvm:investment-funds."
    }
  }
}

get_anp_fuel_prices

Retrieve auditable fuel and GLP price statistics calculated from official ANP station observations. Omit year and month for the rolling latest four weeks, or provide both for a published monthly file from 2023 onward. Results retain period, product, geography, unit, sample count, source URL, and the disclosed aggregation method while excluding station identity and addresses.

read-only

Argument	Type	Description
year	integer	Published source year; provide with month for a monthly file.
limit	integer	Maximum aggregate rows to return.
month	integer	Published source month; provide with year for a monthly file.
state	string	Two-letter Brazilian state code when geography is state or municipality.
period	string	Reporting period granularity.
product	string	Exact ANP product label, for example GASOLINA or ETANOL.
geography	string	Geographic aggregation level.
dataset_id*	string	The official ANP fuel-prices dataset identifier.
fuel_group*	string	ANP product group to retrieve.
municipality	string	Municipality name when geography is municipality.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id",
    "fuel_group"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 2023,
      "description": "Published source year; provide with month for a monthly file."
    },
    "limit": {
      "type": "integer",
      "default": 1000,
      "maximum": 5000,
      "minimum": 1,
      "description": "Maximum aggregate rows to return."
    },
    "month": {
      "type": "integer",
      "maximum": 12,
      "minimum": 1,
      "description": "Published source month; provide with year for a monthly file."
    },
    "state": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Two-letter Brazilian state code when geography is state or municipality."
    },
    "period": {
      "enum": [
        "week",
        "month"
      ],
      "type": "string",
      "default": "week",
      "description": "Reporting period granularity."
    },
    "product": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Exact ANP product label, for example GASOLINA or ETANOL."
    },
    "geography": {
      "enum": [
        "country",
        "region",
        "state",
        "municipality"
      ],
      "type": "string",
      "default": "country",
      "description": "Geographic aggregation level."
    },
    "dataset_id": {
      "type": "string",
      "const": "anp:fuel-prices",
      "description": "The official ANP fuel-prices dataset identifier."
    },
    "fuel_group": {
      "enum": [
        "gasoline-ethanol",
        "diesel-gnv",
        "glp"
      ],
      "type": "string",
      "description": "ANP product group to retrieve."
    },
    "municipality": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Municipality name when geography is municipality."
    }
  }
}

get_bcb_schema

Fetch authoritative metadata for an exact BCB SGS series, including full name, subject hierarchy, periodicity, unit, source, coverage dates, decimals, formula, and warnings. Use when interpreting a BCB series without retrieving observations.

read-only

Argument	Type	Description
dataset_id*	string	Exact BCB dataset ID returned by search_official_data.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "dataset_id": {
      "type": "string",
      "pattern": "^bcb-sgs:\\d+$",
      "description": "Exact BCB dataset ID returned by search_official_data."
    }
  }
}

get_bcb_series

Retrieve official observations and authoritative schema metadata for an exact BCB SGS dataset ID. Use only after search_official_data identifies the series. Dates, units, periodicity, source, and raw values are preserved; generic access does not guess transformations.

read-only

Argument	Type	Description
end	string	Inclusive end date; defaults to today.
limit	integer	Maximum number of observations to return.
order	string	Observation order by date.
start	string	Inclusive start date; defaults to three years ago.
dataset_id*	string	Exact BCB dataset ID returned by search_official_data.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "end": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Inclusive end date; defaults to today."
    },
    "limit": {
      "type": "integer",
      "default": 5000,
      "maximum": 5000,
      "minimum": 1,
      "description": "Maximum number of observations to return."
    },
    "order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "asc",
      "description": "Observation order by date."
    },
    "start": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Inclusive start date; defaults to three years ago."
    },
    "dataset_id": {
      "type": "string",
      "pattern": "^bcb-sgs:\\d+$",
      "description": "Exact BCB dataset ID returned by search_official_data."
    }
  }
}

get_comexstat_data

Retrieve a bounded, explicit MDIC Comex Stat export or import slice from 1997 onward. Use comexstat:general only after search_official_data. Select period, dimensions, metrics, and optional official filter codes; partner, product, state, transport, classification, and raw metric fields remain attached to the result.

read-only

Argument	Type	Description
to*	string	Last month, YYYY-MM.
flow*	string	Trade direction to retrieve.
from*	string	First month, YYYY-MM.
details	array	Official dimensions to include, up to eight.
filters	array	Optional official dimension filters.
metrics	array	Official Comex Stat metrics to return.
language	string	Language for labels in the upstream response.
dataset_id*	string	The official MDIC Comex Stat dataset identifier.

get_cvm_investment_funds

Retrieve daily CVM aggregates by official fund classification or resolve a fund/class latest report by CNPJ or name. Net assets and flows are additive; quota values stay fund-level; reported holder totals are not deduplicated people.

read-only

Argument	Type	Description
to	string	Inclusive last report date, YYYY-MM-DD.
from	string	Inclusive first report date, YYYY-MM-DD.
funds	array	Unformatted 14-digit fund/class CNPJ values.
limit	integer	Maximum fund or classification rows to return.
query	string	Fund-name search; use only with breakdown=fund.
breakdown	string	Whether to aggregate by official classification or resolve a fund.
dataset_id*	string	The official CVM investment-funds dataset identifier.
classifications	array	Official fund classifications to include.

Input schema (JSON)

get_cvm_investment_funds_schema

Inspect the synchronized CVM daily-report window, official classifications, fund-search contract, measure meanings, and aggregation constraints. Use before querying a fund by name or comparing classes.

read-only

Argument	Type	Description
dataset_id*	string	The official CVM investment-funds dataset identifier.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "dataset_id": {
      "type": "string",
      "const": "cvm:investment-funds",
      "description": "The official CVM investment-funds dataset identifier."
    }
  }
}

get_epe_electricity_consumption

Retrieve monthly EPE electricity consumption and consumer counts from 2004 onward. Select a bounded period, country/region/UF geography, consumption classes, and regulated/free market. The response identifies the exact synchronized official workbook version and discloses aggregation across source system rows.

read-only

Argument	Type	Description
to	string	Inclusive last month, YYYY-MM.
from	string	Inclusive first month, YYYY-MM.
limit	integer	Maximum rows to return.
states	array	Optional official state codes when geography is state.
classes	array	Consumption classes to include.
markets	array	Electricity-market segments to include.
regions	array	Optional official regions when geography is region.
geography	string	Geographic aggregation level.
dataset_id*

get_ibge_data

Retrieve an explicit slice of an IBGE aggregate after inspecting its schema. Returns variables containing classification selections, geographies, and observations; official suppression, missing, quality-flag, and zero states remain distinct.

read-only

Argument	Type	Description
periods	string	Recent-period shorthand such as -12, or explicit official period IDs separated by \|.
locality	string	BR or an explicit IBGE geography selection such as N3[35].
variable*	string	One or more official variable IDs separated by \|.
dataset_id*	string	Exact IBGE aggregate ID returned by search_official_data.
classification	string	Explicit classification selections from the schema, such as 11255[90707].

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id",
    "variable"
  ],
  "properties": {
    "periods": {
      "type": "string",
      "default": "-12",
      "pattern": "^(?:-\\d{1,3}|\\d{4,6}(?:\\|\\d{4,6}){0,119})$",
      "description": "Recent-period shorthand such as -12, or explicit official period IDs separated by |."
    },
    "locality": {
      "type": "string",
      "default": "BR",
      "pattern": "^(?:BR|N\\d{1,2}\\[(?:all|\\d+(?:,\\d+)*)\\])$",
      "description": "BR or an explicit IBGE geography selection such as N3[35]."
    },
    "variable": {
      "type": "string",
      "pattern": "^\\d+(?:\\|\\d+)*$",
      "description": "One or more official variable IDs separated by |."
    },
    "dataset_id": {
      "type": "string",
      "pattern": "^ibge-aggregates:\\d+$",
      "description": "Exact IBGE aggregate ID returned by search_official_data."
    },
    "classification": {
      "type": "string",
      "pattern": "^\\d+\\[(?:all|\\d+(?:,\\d+)*)\\](?:\\|\\d+\\[(?:all|\\d+(?:,\\d+)*)\\])*$",
      "description": "Explicit classification selections from the schema, such as 11255[90707]."
    }
  }
}

get_ibge_schema

Fetch official metadata for an IBGE aggregate selected by search_official_data. Always use this before get_ibge_data unless the official variable, locality, and classification IDs are already known. It prevents guessing a measure or dimensional slice.

read-only

Argument	Type	Description
dataset_id*	string	Exact IBGE aggregate ID returned by search_official_data.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "dataset_id": {
      "type": "string",
      "pattern": "^ibge-aggregates:\\d+$",
      "description": "Exact IBGE aggregate ID returned by search_official_data."
    }
  }
}

get_mte_formal_employment

Retrieve revised monthly Novo Caged stock, admissions, dismissals, balance, and relative change from 2020 onward. Select exactly one official breakdown: country, region, state, or economic activity. The response preserves the MTE workbook vintage and never synthesizes state-by-industry values.

read-only

Argument	Type	Description
to	string	Inclusive last month, YYYY-MM.
from	string	Inclusive first month, YYYY-MM.
limit	integer	Maximum rows to return.
states	array	Optional official state codes when breakdown is state.
regions	array	Optional official regions when breakdown is region.
breakdown	string	Official breakdown for the employment result.
dataset_id*	string	The official MTE Novo Caged dataset identifier.
industries	array	Exact official activity IDs returned by get_mte_formal_employment_schema; empty means all activities.

get_mte_formal_employment_schema

Inspect the official adjusted Novo Caged selection contract, source vintage, measure meanings, available industry IDs, and the constraint that geography and industry come from separate official tables. Use before an industry query.

read-only

Argument	Type	Description
dataset_id*	string	The official MTE Novo Caged dataset identifier.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "dataset_id": {
      "type": "string",
      "const": "mte:formal-employment",
      "description": "The official MTE Novo Caged dataset identifier."
    }
  }
}

get_siconfi_data

Retrieve an explicit official SICONFI DCA, RREO, RGF, or entity-registry selection. First inspect the schema. This tool preserves account, column, annex, period, entity, raw value fields, and upstream provenance without aggregating or substituting concepts.

read-only

Argument	Type	Description
year	integer	Calendar year of the official report.
annex	string	Exact official annex name from the SICONFI documentation.
power	string	RGF government branch.
entity	integer	Official IBGE entity code.
period	integer	RREO bimestre (1-6) or RGF period (1-3).
sphere	string	Government sphere: municipal, state, federal, or consortium.
dataset_id*	string	Exact SICONFI dataset ID returned by search_official_data.
periodicity	string	RGF only: four-month (Q) or half-year (S).
report_type

get_siconfi_schema

Get the meaning and required selection fields for an exact SICONFI dataset returned by search_official_data. Use this before get_siconfi_data so entity, reporting period, report type, government branch, and annex are explicit rather than guessed.

read-only

Argument	Type	Description
dataset_id*	string	Exact SICONFI dataset ID returned by search_official_data.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "dataset_id": {
      "type": "string",
      "pattern": "^siconfi:(?:rreo|rgf|dca|entes)$",
      "description": "Exact SICONFI dataset ID returned by search_official_data."
    }
  }
}

get_tesouro_dpf

Retrieve one official monthly RMD table at a time: debt composition, DPMFi holders, average maturity, average maturity by indexer, monthly cost, or twelve-month cost. Units remain table-specific and are never combined.

read-only

Argument	Type	Description
to	string	Inclusive last month, YYYY-MM.
from	string	Inclusive first month, YYYY-MM.
limit	integer	Maximum debt-statistics rows to return.
query	string	Category-label search; useful when category IDs are unknown.
table	string	Versioned RMD table to retrieve.
categories	array	Exact category IDs returned for the selected table by get_tesouro_dpf_schema.
dataset_id*	string	The official Tesouro Nacional DPF debt-profile dataset identifier.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$",
      "description": "Inclusive last month, YYYY-MM."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$",
      "description": "Inclusive first month, YYYY-MM."
    },
    "limit": {
      "type": "integer",
      "default": 1000,
      "maximum": 5000,
      "minimum": 1,
      "description": "Maximum debt-statistics rows to return."
    },
    "query": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2,
      "description": "Category-label search; useful when category IDs are unknown."
    },
    "table": {
      "enum": [
        "composition",
        "holders",
        "average-maturity",
        "average-maturity-by-indexer",
        "monthly-cost",
        "twelve-month-cost"
      ],
      "type": "string",
      "default": "composition",
      "description": "Versioned RMD table to retrieve."
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
      },
      "default": [],
      "maxItems": 8,
      "description": "Exact category IDs returned for the selected table by get_tesouro_dpf_schema."
    },
    "dataset_id": {
      "type": "string",
      "const": "tesouro-dpf:debt-profile",
      "description": "The official Tesouro Nacional DPF debt-profile dataset identifier."
    }
  }
}

get_tesouro_dpf_schema

Inspect the six versioned RMD annex tables, their distinct units and coverage, category IDs, holder definitions, source publication, and methodological constraints before selecting data.

read-only

Argument	Type	Description
dataset_id*	string	The official Tesouro Nacional DPF debt-profile dataset identifier.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "dataset_id": {
      "type": "string",
      "const": "tesouro-dpf:debt-profile",
      "description": "The official Tesouro Nacional DPF debt-profile dataset identifier."
    }
  }
}

get_tesouro_rtn

Retrieve monthly current-value RTN accounts from 1997 onward. Defaults to total revenue, transfers, net revenue, total expenditure, and the above-the-line primary result; select exact account IDs or search account labels for detail.

read-only

Argument	Type	Description
to	string	Inclusive last month, YYYY-MM.
from	string	Inclusive first month, YYYY-MM.
limit	integer	Maximum account rows to return.
query	string	Account-label search; omit accounts to search the full tree.
accounts	array	Exact account IDs returned by get_tesouro_rtn_schema.
dataset_id*	string	The official Tesouro Nacional RTN dataset identifier.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$",
      "description": "Inclusive last month, YYYY-MM."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$",
      "description": "Inclusive first month, YYYY-MM."
    },
    "limit": {
      "type": "integer",
      "default": 1000,
      "maximum": 5000,
      "minimum": 1,
      "description": "Maximum account rows to return."
    },
    "query": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2,
      "description": "Account-label search; omit accounts to search the full tree."
    },
    "accounts": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^\\d+(?:\\.\\d+)*$"
      },
      "default": [],
      "maxItems": 8,
      "description": "Exact account IDs returned by get_tesouro_rtn_schema."
    },
    "dataset_id": {
      "type": "string",
      "const": "tesouro-rtn:government-central",
      "description": "The official Tesouro Nacional RTN dataset identifier."
    }
  }
}

get_tesouro_rtn_schema

Inspect RTN table 1.2 account IDs, hierarchy, current-value unit, coverage, source vintage, and above/below-the-line constraints. Use before selecting revenue or expenditure categories.

read-only

Argument	Type	Description
dataset_id*	string	The official Tesouro Nacional RTN dataset identifier.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "dataset_id": {
      "type": "string",
      "const": "tesouro-rtn:government-central",
      "description": "The official Tesouro Nacional RTN dataset identifier."
    }
  }
}

search_official_data

Start here for a natural-language Brazilian economic-information need in Portuguese or English. Resolves the economic concept independently of current coverage, returns ranked official datasets, stable-series shortcuts, confidence, missing source integrations, and an explicit unresolved/partial state. Use this before any data query when the exact official dataset ID is unknown.

read-only

Argument	Type	Description
limit	integer	Maximum official dataset candidates to return.
query*	string	The user's complete economic-data need, including measure, geography, period, and breakdown when known.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "description": "Maximum official dataset candidates to return."
    },
    "query": {
      "type": "string",
      "maxLength": 300,
      "minLength": 2,
      "description": "The user's complete economic-data need, including measure, geography, period, and breakdown when known."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id",
    "flow",
    "from",
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$",
      "description": "Last month, YYYY-MM."
    },
    "flow": {
      "enum": [
        "export",
        "import"
      ],
      "type": "string",
      "description": "Trade direction to retrieve."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$",
      "description": "First month, YYYY-MM."
    },
    "details": {
      "type": "array",
      "items": {
        "enum": [
          "country",
          "economicBlock",
          "state",
          "via",
          "urf",
          "ncm",
          "subHeading",
          "heading",
          "chapter",
          "section",
          "BECLevel3",
          "BECLevel2",
          "BECLevel1",
          "SITCBasicHeading",
          "SITCSubGroup",
          "SITCGroup",
          "SITCDivision",
          "SITCSection",
          "ISICClass",
          "ISICGroup",
          "ISICDivision",
          "ISICSection"
        ],
        "type": "string"
      },
      "default": [],
      "maxItems": 8,
      "description": "Official dimensions to include, up to eight."
    },
    "filters": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "filter",
          "values"
        ],
        "properties": {
          "filter": {
            "enum": [
              "country",
              "economicBlock",
              "state",
              "via",
              "urf",
              "ncm",
              "subHeading",
              "heading",
              "chapter",
              "section",
              "BECLevel3",
              "BECLevel2",
              "BECLevel1",
              "SITCBasicHeading",
              "SITCSubGroup",
              "SITCGroup",
              "SITCDivision",
              "SITCSection",
              "ISICClass",
              "ISICGroup",
              "ISICDivision",
              "ISICSection"
            ],
            "type": "string",
            "description": "Official dimension code to filter."
          },
          "values": {
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 30
                },
                {
                  "type": "number"
                }
              ]
            },
            "maxItems": 50,
            "minItems": 1,
            "description": "One or more official filter values."
          }
        }
      },
      "default": [],
      "maxItems": 6,
      "description": "Optional official dimension filters."
    },
    "metrics": {
      "type": "array",
      "items": {
        "enum": [
          "metricFOB",
          "metricKG",
          "metricStatistic",
          "metricFreight",
          "metricInsurance",
          "metricCIF"
        ],
        "type": "string"
      },
      "default": [
        "metricFOB"
      ],
      "maxItems": 6,
      "description": "Official Comex Stat metrics to return."
    },
    "language": {
      "enum": [
        "pt",
        "en",
        "es"
      ],
      "type": "string",
      "default": "pt",
      "description": "Language for labels in the upstream response."
    },
    "dataset_id": {
      "type": "string",
      "const": "comexstat:general",
      "description": "The official MDIC Comex Stat dataset identifier."
    },
    "month_detail": {
      "type": "boolean",
      "default": true,
      "description": "Whether to keep month-level detail in the response."
    }
  }
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Inclusive last report date, YYYY-MM-DD."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Inclusive first report date, YYYY-MM-DD."
    },
    "funds": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^\\d{14}$"
      },
      "default": [],
      "maxItems": 8,
      "description": "Unformatted 14-digit fund/class CNPJ values."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum fund or classification rows to return."
    },
    "query": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2,
      "description": "Fund-name search; use only with breakdown=fund."
    },
    "breakdown": {
      "enum": [
        "classification",
        "fund"
      ],
      "type": "string",
      "default": "classification",
      "description": "Whether to aggregate by official classification or resolve a fund."
    },
    "dataset_id": {
      "type": "string",
      "const": "cvm:investment-funds",
      "description": "The official CVM investment-funds dataset identifier."
    },
    "classifications": {
      "type": "array",
      "items": {
        "enum": [
          "Ações",
          "Cambial",
          "FMP-FGTS",
          "Multimercado",
          "Não classificado",
          "Renda Fixa"
        ],
        "type": "string"
      },
      "default": [],
      "maxItems": 6,
      "description": "Official fund classifications to include."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$",
      "description": "Inclusive last month, YYYY-MM."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$",
      "description": "Inclusive first month, YYYY-MM."
    },
    "limit": {
      "type": "integer",
      "default": 1000,
      "maximum": 5000,
      "minimum": 1,
      "description": "Maximum rows to return."
    },
    "states": {
      "type": "array",
      "items": {
        "enum": [
          "AC",
          "AL",
          "AM",
          "AP",
          "BA",
          "CE",
          "DF",
          "ES",
          "GO",
          "MA",
          "MG",
          "MS",
          "MT",
          "PA",
          "PB",
          "PE",
          "PI",
          "PR",
          "RJ",
          "RN",
          "RO",
          "RR",
          "RS",
          "SC",
          "SE",
          "SP",
          "TO"
        ],
        "type": "string"
      },
      "default": [],
      "maxItems": 8,
      "description": "Optional official state codes when geography is state."
    },
    "classes": {
      "type": "array",
      "items": {
        "enum": [
          "Comercial",
          "Industrial",
          "Outros",
          "Residencial",
          "Rural"
        ],
        "type": "string"
      },
      "default": [
        "Comercial",
        "Industrial",
        "Outros",
        "Residencial",
        "Rural"
      ],
      "maxItems": 5,
      "description": "Consumption classes to include."
    },
    "markets": {
      "type": "array",
      "items": {
        "enum": [
          "Cativo",
          "Livre"
        ],
        "type": "string"
      },
      "default": [
        "Cativo",
        "Livre"
      ],
      "maxItems": 2,
      "description": "Electricity-market segments to include."
    },
    "regions": {
      "type": "array",
      "items": {
        "enum": [
          "Centro-Oeste",
          "Nordeste",
          "Norte",
          "Sudeste",
          "Sul"
        ],
        "type": "string"
      },
      "default": [],
      "maxItems": 5,
      "description": "Optional official regions when geography is region."
    },
    "geography": {
      "enum": [
        "country",
        "region",
        "state"
      ],
      "type": "string",
      "default": "country",
      "description": "Geographic aggregation level."
    },
    "dataset_id": {
      "type": "string",
      "const": "epe:electricity-consumption",
      "description": "The official EPE electricity-consumption dataset identifier."
    }
  }
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "dataset_id"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$",
      "description": "Inclusive last month, YYYY-MM."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-(?:0[1-9]|1[0-2])$",
      "description": "Inclusive first month, YYYY-MM."
    },
    "limit": {
      "type": "integer",
      "default": 1000,
      "maximum": 5000,
      "minimum": 1,
      "description": "Maximum rows to return."
    },
    "states": {
      "type": "array",
      "items": {
        "enum": [
          "AC",
          "AL",
          "AM",
          "AP",
          "BA",
          "CE",
          "DF",
          "ES",
          "GO",
          "MA",
          "MG",
          "MS",
          "MT",
          "PA",
          "PB",
          "PE",
          "PI",
          "PR",
          "RJ",
          "RN",
          "RO",
          "RR",
          "RS",
          "SC",
          "SE",
          "SP",
          "TO"
        ],
        "type": "string"
      },
      "default": [],
      "maxItems": 27,
      "description": "Optional official state codes when breakdown is state."
    },
    "regions": {
      "type": "array",
      "items": {
        "enum": [
          "Centro-Oeste",
          "Nordeste",
          "Norte",
          "Sudeste",
          "Sul"
        ],
        "type": "string"
      },
      "default": [],
      "maxItems": 5,
      "description": "Optional official regions when breakdown is region."
    },
    "breakdown": {
      "enum": [
        "country",
        "region",
        "state",
        "industry"
      ],
      "type": "string",
      "default": "country",
      "description": "Official breakdown for the employment result."
    },
    "dataset_id": {
      "type": "string",
      "const": "mte:formal-employment",
      "description": "The official MTE Novo Caged dataset identifier."
    },
    "industries": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
      },
      "default": [],
      "maxItems": 26,
      "description": "Exact official activity IDs returned by get_mte_formal_employment_schema; empty means all activities."
    }
  }
}