Open Economics
Server Details
Discover, resolve, and query official Brazilian economic data with semantic search and provenance.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- felipegambettadesouza6-jpg/open-economics
- GitHub Stars
- 0
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 19 tools
Most tools target a specific official source and are clearly separable (e.g., get_bcb_series vs get_ibge_data). The only mild overlap is between describe_official_dataset and the per-source *_schema tools, both of which provide metadata, but their scopes (generic dataset identity vs. source-specific query contracts) are distinguishable.
All names use snake_case with a consistent verb_noun pattern: get_<source>_<topic> for data retrieval, get_<source>_schema for metadata, and search_official_data / describe_official_dataset for discovery. Minor suffix variations (some data tools omit _data) do not break predictability.
19 tools is slightly heavy but well justified: nine official source families each have a schema and a data tool, plus top-level search and describe tools. No tool appears redundant, though the count sits at the upper edge of the ideal range.
The surface covers a broad range of Brazilian official economic sources with schema-before-data patterns for the more complex ones. Gaps exist where search_official_data may resolve a concept to an unintegrated source, but these are explicitly signalled rather than hidden.
Available Tools
19 toolsdescribe_official_datasetDescribe an official datasetARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| dataset_id | Yes | 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. |
Output Schema
| Name | Required | Description |
|---|---|---|
| id | Yes | Stable official dataset ID. |
| title | Yes | Official dataset title. |
| provider | Yes | Open Economics provider identifier. |
| sourceUrl | Yes | Official source URL. |
| collection | No | Official collection identifier, when supplied by the publisher. |
| metadataUrl | Yes | Official metadata URL. |
| sourceAgency | Yes | Official publishing agency. |
| collectionName | No | Official collection name, when supplied by the publisher. |
| queryCapability | Yes | Supported query capability. |
get_anp_fuel_pricesQuery official ANP fuel pricesARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Published source year; provide with month for a monthly file. | |
| limit | No | Maximum aggregate rows to return. | |
| month | No | Published source month; provide with year for a monthly file. | |
| state | No | Two-letter Brazilian state code when geography is state or municipality. | |
| period | No | Reporting period granularity. | week |
| product | No | Exact ANP product label, for example GASOLINA or ETANOL. | |
| geography | No | Geographic aggregation level. | country |
| dataset_id | Yes | The official ANP fuel-prices dataset identifier. | |
| fuel_group | Yes | ANP product group to retrieve. | |
| municipality | No | Municipality name when geography is municipality. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | Yes | Source-preserving data or schema payload for the selected official dataset. |
| meta | Yes | Response metadata and source provenance. |
| links | No | Related API links. |
get_bcb_schemaInspect BCB series meaning and unitsARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| dataset_id | Yes | Exact BCB dataset ID returned by search_official_data. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | Yes | Source-preserving data or schema payload for the selected official dataset. |
| meta | Yes | Response metadata and source provenance. |
| links | No | Related API links. |
get_bcb_seriesGet observations from a BCB SGS seriesARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Inclusive end date; defaults to today. | |
| limit | No | Maximum number of observations to return. | |
| order | No | Observation order by date. | asc |
| start | No | Inclusive start date; defaults to three years ago. | |
| dataset_id | Yes | Exact BCB dataset ID returned by search_official_data. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | Yes | Source-preserving data or schema payload for the selected official dataset. |
| meta | Yes | Response metadata and source provenance. |
| links | No | Related API links. |
get_comexstat_dataQuery official Brazilian merchandise tradeARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Last month, YYYY-MM. | |
| flow | Yes | Trade direction to retrieve. | |
| from | Yes | First month, YYYY-MM. | |
| details | No | Official dimensions to include, up to eight. | |
| filters | No | Optional official dimension filters. | |
| metrics | No | Official Comex Stat metrics to return. | |
| language | No | Language for labels in the upstream response. | pt |
| dataset_id | Yes | The official MDIC Comex Stat dataset identifier. | |
| month_detail | No | Whether to keep month-level detail in the response. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | Yes | Source-preserving data or schema payload for the selected official dataset. |
| meta | Yes | Response metadata and source provenance. |
| links | No | Related API links. |
get_cvm_investment_fundsQuery official CVM investment-fund reportsARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Inclusive last report date, YYYY-MM-DD. | |
| from | No | Inclusive first report date, YYYY-MM-DD. | |
| funds | No | Unformatted 14-digit fund/class CNPJ values. | |
| limit | No | Maximum fund or classification rows to return. | |
| query | No | Fund-name search; use only with breakdown=fund. | |
| breakdown | No | Whether to aggregate by official classification or resolve a fund. | classification |
| dataset_id | Yes | The official CVM investment-funds dataset identifier. | |
| classifications | No | Official fund classifications to include. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | Yes | Source-preserving data or schema payload for the selected official dataset. |
| meta | Yes | Response metadata and source provenance. |
| links | No | Related API links. |
get_cvm_investment_funds_schemaInspect CVM investment-fund measures and dimensionsARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| dataset_id | Yes | The official CVM investment-funds dataset identifier. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | Yes | Source-preserving data or schema payload for the selected official dataset. |
| meta | Yes | Response metadata and source provenance. |
| links | No | Related API links. |
get_epe_electricity_consumptionQuery official electricity consumptionARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Inclusive last month, YYYY-MM. | |
| from | No | Inclusive first month, YYYY-MM. | |
| limit | No | Maximum rows to return. | |
| states | No | Optional official state codes when geography is state. | |
| classes | No | Consumption classes to include. | |
| markets | No | Electricity-market segments to include. | |
| regions | No | Optional official regions when geography is region. | |
| geography | No | Geographic aggregation level. | country |
| dataset_id | Yes | The official EPE electricity-consumption dataset identifier. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | Yes | Source-preserving data or schema payload for the selected official dataset. |
| meta | Yes | Response metadata and source provenance. |
| links | No | Related API links. |
get_ibge_dataQuery multidimensional IBGE dataARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| periods | No | Recent-period shorthand such as -12, or explicit official period IDs separated by |. | -12 |
| locality | No | BR or an explicit IBGE geography selection such as N3[35]. | BR |
| variable | Yes | One or more official variable IDs separated by |. | |
| dataset_id | Yes | Exact IBGE aggregate ID returned by search_official_data. | |
| classification | No | Explicit classification selections from the schema, such as 11255[90707]. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | Yes | Source-preserving data or schema payload for the selected official dataset. |
| meta | Yes | Response metadata and source provenance. |
| links | No | Related API links. |
get_ibge_schemaInspect an IBGE aggregate's measures and dimensionsARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| dataset_id | Yes | Exact IBGE aggregate ID returned by search_official_data. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | Yes | Source-preserving data or schema payload for the selected official dataset. |
| meta | Yes | Response metadata and source provenance. |
| links | No | Related API links. |
get_mte_formal_employmentQuery official formal-employment stock and flowsARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Inclusive last month, YYYY-MM. | |
| from | No | Inclusive first month, YYYY-MM. | |
| limit | No | Maximum rows to return. | |
| states | No | Optional official state codes when breakdown is state. | |
| regions | No | Optional official regions when breakdown is region. | |
| breakdown | No | Official breakdown for the employment result. | country |
| dataset_id | Yes | The official MTE Novo Caged dataset identifier. | |
| industries | No | Exact official activity IDs returned by get_mte_formal_employment_schema; empty means all activities. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | Yes | Source-preserving data or schema payload for the selected official dataset. |
| meta | Yes | Response metadata and source provenance. |
| links | No | Related API links. |
get_mte_formal_employment_schemaInspect Novo Caged dimensions and measuresARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| dataset_id | Yes | The official MTE Novo Caged dataset identifier. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | Yes | Source-preserving data or schema payload for the selected official dataset. |
| meta | Yes | Response metadata and source provenance. |
| links | No | Related API links. |
get_siconfi_dataQuery official SICONFI fiscal dataARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Calendar year of the official report. | |
| annex | No | Exact official annex name from the SICONFI documentation. | |
| power | No | RGF government branch. | |
| entity | No | Official IBGE entity code. | |
| period | No | RREO bimestre (1-6) or RGF period (1-3). | |
| sphere | No | Government sphere: municipal, state, federal, or consortium. | |
| dataset_id | Yes | Exact SICONFI dataset ID returned by search_official_data. | |
| periodicity | No | RGF only: four-month (Q) or half-year (S). | |
| report_type | No | Official SICONFI report type for the selected dataset. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | Yes | Source-preserving data or schema payload for the selected official dataset. |
| meta | Yes | Response metadata and source provenance. |
| links | No | Related API links. |
get_siconfi_schemaInspect a SICONFI fiscal reportARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| dataset_id | Yes | Exact SICONFI dataset ID returned by search_official_data. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | Yes | Source-preserving data or schema payload for the selected official dataset. |
| meta | Yes | Response metadata and source provenance. |
| links | No | Related API links. |
get_tesouro_dpfQuery Federal Public Debt statisticsARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Inclusive last month, YYYY-MM. | |
| from | No | Inclusive first month, YYYY-MM. | |
| limit | No | Maximum debt-statistics rows to return. | |
| query | No | Category-label search; useful when category IDs are unknown. | |
| table | No | Versioned RMD table to retrieve. | composition |
| categories | No | Exact category IDs returned for the selected table by get_tesouro_dpf_schema. | |
| dataset_id | Yes | The official Tesouro Nacional DPF debt-profile dataset identifier. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | Yes | Source-preserving data or schema payload for the selected official dataset. |
| meta | Yes | Response metadata and source provenance. |
| links | No | Related API links. |
get_tesouro_dpf_schemaInspect Federal Public Debt statisticsARead-onlyIdempotentInspect
Inspect the six versioned RMD annex tables, their distinct units and coverage, category IDs, holder definitions, source publication, and methodological constraints before selecting data.
| Name | Required | Description | Default |
|---|---|---|---|
| dataset_id | Yes | The official Tesouro Nacional DPF debt-profile dataset identifier. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | Yes | Source-preserving data or schema payload for the selected official dataset. |
| meta | Yes | Response metadata and source provenance. |
| links | No | Related API links. |
get_tesouro_rtnQuery Government Central revenue, expenditure, and resultARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Inclusive last month, YYYY-MM. | |
| from | No | Inclusive first month, YYYY-MM. | |
| limit | No | Maximum account rows to return. | |
| query | No | Account-label search; omit accounts to search the full tree. | |
| accounts | No | Exact account IDs returned by get_tesouro_rtn_schema. | |
| dataset_id | Yes | The official Tesouro Nacional RTN dataset identifier. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | Yes | Source-preserving data or schema payload for the selected official dataset. |
| meta | Yes | Response metadata and source provenance. |
| links | No | Related API links. |
get_tesouro_rtn_schemaInspect Government Central fiscal accountsARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| dataset_id | Yes | The official Tesouro Nacional RTN dataset identifier. |
Output Schema
| Name | Required | Description |
|---|---|---|
| data | Yes | Source-preserving data or schema payload for the selected official dataset. |
| meta | Yes | Response metadata and source provenance. |
| links | No | Related API links. |
search_official_dataSearch Brazilian official economic dataARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum official dataset candidates to return. | |
| query | Yes | The user's complete economic-data need, including measure, geography, period, and breakdown when known. |
Output Schema
| Name | Required | Description |
|---|---|---|
| query | Yes | The original natural-language economic need. |
| concepts | Yes | Ranked economic concepts matched to the request. |
| datasets | Yes | Ranked official datasets and their source identity. |
| resolution | Yes | Concept-resolution result. |
| availability | Yes | Coverage assessment. |
| normalizedQuery | Yes | Normalized form used for semantic resolution. |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
19 tool updates
- Changed
describe_official_dataset1 field changed- changed
Output schema / (root)Previous value: -nullNew value: +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {}, + "description": "Official dataset identity, source, provenance, and query capability.", + "properties": { + "collection": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "description": "Official collection identifier, when supplied by the publisher." + }, + "collectionName": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "description": "Official collection name, when supplied by the publisher." + }, + "id": { + "description": "Stable official dataset ID.", + "type": "string" + }, + "metadataUrl": { + "description": "Official metadata URL.", + "type": "string" + }, + "provider": { + "description": "Open Economics provider identifier.", + "type": "string" + }, + "queryCapability": { + "description": "Supported query capability.", + "type": "string" + }, + "sourceAgency": { + "description": "Official publishing agency.", + "type": "string" + }, + "sourceUrl": { + "description": "Official source URL.", + "type": "string" + }, + "title": { + "description": "Official dataset title.", + "type": "string" + } + }, + "required": [ + "id", + "provider", + "sourceAgency", + "title", + "sourceUrl", + "metadataUrl", + "queryCapability" + ], + "type": "object" +}
- Changed
get_anp_fuel_prices10 fields changed- added
Input schema / properties / dataset_id / descriptionAdded value: +"The official ANP fuel-prices dataset identifier." - added
Input schema / properties / fuel_group / descriptionAdded value: +"ANP product group to retrieve." - added
Input schema / properties / geography / descriptionAdded value: +"Geographic aggregation level." - added
Input schema / properties / limit / descriptionAdded value: +"Maximum aggregate rows to return." - added
Input schema / properties / month / descriptionAdded value: +"Published source month; provide with year for a monthly file." - added
Input schema / properties / municipality / descriptionAdded value: +"Municipality name when geography is municipality." - added
Input schema / properties / period / descriptionAdded value: +"Reporting period granularity." - added
Input schema / properties / state / descriptionAdded value: +"Two-letter Brazilian state code when geography is state or municipality." - added
Input schema / properties / year / descriptionAdded value: +"Published source year; provide with month for a monthly file." - changed
Output schema / (root)Previous value: -nullNew value: +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {}, + "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.", + "properties": { + "data": { + "description": "Source-preserving data or schema payload for the selected official dataset." + }, + "links": { + "additionalProperties": {}, + "description": "Related API links.", + "properties": { + "observations": { + "description": "Canonical observations endpoint for this dataset.", + "type": "string" + }, + "self": { + "description": "Canonical URL for this response.", + "type": "string" + } + }, + "type": "object" + }, + "meta": { + "additionalProperties": {}, + "description": "Response metadata and source provenance.", + "properties": { + "dataset": { + "description": "Open Economics dataset identity when supplied." + }, + "provenance": { + "description": "Upstream source URLs, versions, timestamps, and methodology details." + } + }, + "type": "object" + } + }, + "required": [ + "data", + "meta" + ], + "type": "object" +}
- Changed
get_bcb_schema1 field changed- changed
Output schema / (root)Previous value: -nullNew value: +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {}, + "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.", + "properties": { + "data": { + "description": "Source-preserving data or schema payload for the selected official dataset." + }, + "links": { + "additionalProperties": {}, + "description": "Related API links.", + "properties": { + "observations": { + "description": "Canonical observations endpoint for this dataset.", + "type": "string" + }, + "self": { + "description": "Canonical URL for this response.", + "type": "string" + } + }, + "type": "object" + }, + "meta": { + "additionalProperties": {}, + "description": "Response metadata and source provenance.", + "properties": { + "dataset": { + "description": "Open Economics dataset identity when supplied." + }, + "provenance": { + "description": "Upstream source URLs, versions, timestamps, and methodology details." + } + }, + "type": "object" + } + }, + "required": [ + "data", + "meta" + ], + "type": "object" +}
- Changed
get_bcb_series3 fields changed- added
Input schema / properties / limit / descriptionAdded value: +"Maximum number of observations to return." - added
Input schema / properties / order / descriptionAdded value: +"Observation order by date." - changed
Output schema / (root)Previous value: -nullNew value: +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {}, + "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.", + "properties": { + "data": { + "description": "Source-preserving data or schema payload for the selected official dataset." + }, + "links": { + "additionalProperties": {}, + "description": "Related API links.", + "properties": { + "observations": { + "description": "Canonical observations endpoint for this dataset.", + "type": "string" + }, + "self": { + "description": "Canonical URL for this response.", + "type": "string" + } + }, + "type": "object" + }, + "meta": { + "additionalProperties": {}, + "description": "Response metadata and source provenance.", + "properties": { + "dataset": { + "description": "Open Economics dataset identity when supplied." + }, + "provenance": { + "description": "Upstream source URLs, versions, timestamps, and methodology details." + } + }, + "type": "object" + } + }, + "required": [ + "data", + "meta" + ], + "type": "object" +}
- Changed
get_comexstat_data10 fields changed- added
Input schema / properties / dataset_id / descriptionAdded value: +"The official MDIC Comex Stat dataset identifier." - added
Input schema / properties / details / descriptionAdded value: +"Official dimensions to include, up to eight." - added
Input schema / properties / filters / descriptionAdded value: +"Optional official dimension filters." - added
Input schema / properties / filters / items / properties / filter / descriptionAdded value: +"Official dimension code to filter." - added
Input schema / properties / filters / items / properties / values / descriptionAdded value: +"One or more official filter values." - added
Input schema / properties / flow / descriptionAdded value: +"Trade direction to retrieve." - added
Input schema / properties / language / descriptionAdded value: +"Language for labels in the upstream response." - added
Input schema / properties / metrics / descriptionAdded value: +"Official Comex Stat metrics to return." - added
Input schema / properties / month_detail / descriptionAdded value: +"Whether to keep month-level detail in the response." - changed
Output schema / (root)Previous value: -nullNew value: +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {}, + "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.", + "properties": { + "data": { + "description": "Source-preserving data or schema payload for the selected official dataset." + }, + "links": { + "additionalProperties": {}, + "description": "Related API links.", + "properties": { + "observations": { + "description": "Canonical observations endpoint for this dataset.", + "type": "string" + }, + "self": { + "description": "Canonical URL for this response.", + "type": "string" + } + }, + "type": "object" + }, + "meta": { + "additionalProperties": {}, + "description": "Response metadata and source provenance.", + "properties": { + "dataset": { + "description": "Open Economics dataset identity when supplied." + }, + "provenance": { + "description": "Upstream source URLs, versions, timestamps, and methodology details." + } + }, + "type": "object" + } + }, + "required": [ + "data", + "meta" + ], + "type": "object" +}
- Changed
get_cvm_investment_funds7 fields changed- added
Input schema / properties / breakdown / descriptionAdded value: +"Whether to aggregate by official classification or resolve a fund." - added
Input schema / properties / classifications / descriptionAdded value: +"Official fund classifications to include." - added
Input schema / properties / dataset_id / descriptionAdded value: +"The official CVM investment-funds dataset identifier." - added
Input schema / properties / from / descriptionAdded value: +"Inclusive first report date, YYYY-MM-DD." - added
Input schema / properties / limit / descriptionAdded value: +"Maximum fund or classification rows to return." - added
Input schema / properties / to / descriptionAdded value: +"Inclusive last report date, YYYY-MM-DD." - changed
Output schema / (root)Previous value: -nullNew value: +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {}, + "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.", + "properties": { + "data": { + "description": "Source-preserving data or schema payload for the selected official dataset." + }, + "links": { + "additionalProperties": {}, + "description": "Related API links.", + "properties": { + "observations": { + "description": "Canonical observations endpoint for this dataset.", + "type": "string" + }, + "self": { + "description": "Canonical URL for this response.", + "type": "string" + } + }, + "type": "object" + }, + "meta": { + "additionalProperties": {}, + "description": "Response metadata and source provenance.", + "properties": { + "dataset": { + "description": "Open Economics dataset identity when supplied." + }, + "provenance": { + "description": "Upstream source URLs, versions, timestamps, and methodology details." + } + }, + "type": "object" + } + }, + "required": [ + "data", + "meta" + ], + "type": "object" +}
- Changed
get_cvm_investment_funds_schema2 fields changed- added
Input schema / properties / dataset_id / descriptionAdded value: +"The official CVM investment-funds dataset identifier." - changed
Output schema / (root)Previous value: -nullNew value: +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {}, + "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.", + "properties": { + "data": { + "description": "Source-preserving data or schema payload for the selected official dataset." + }, + "links": { + "additionalProperties": {}, + "description": "Related API links.", + "properties": { + "observations": { + "description": "Canonical observations endpoint for this dataset.", + "type": "string" + }, + "self": { + "description": "Canonical URL for this response.", + "type": "string" + } + }, + "type": "object" + }, + "meta": { + "additionalProperties": {}, + "description": "Response metadata and source provenance.", + "properties": { + "dataset": { + "description": "Open Economics dataset identity when supplied." + }, + "provenance": { + "description": "Upstream source URLs, versions, timestamps, and methodology details." + } + }, + "type": "object" + } + }, + "required": [ + "data", + "meta" + ], + "type": "object" +}
- Changed
get_epe_electricity_consumption10 fields changed- added
Input schema / properties / classes / descriptionAdded value: +"Consumption classes to include." - added
Input schema / properties / dataset_id / descriptionAdded value: +"The official EPE electricity-consumption dataset identifier." - added
Input schema / properties / from / descriptionAdded value: +"Inclusive first month, YYYY-MM." - added
Input schema / properties / geography / descriptionAdded value: +"Geographic aggregation level." - added
Input schema / properties / limit / descriptionAdded value: +"Maximum rows to return." - added
Input schema / properties / markets / descriptionAdded value: +"Electricity-market segments to include." - added
Input schema / properties / regions / descriptionAdded value: +"Optional official regions when geography is region." - added
Input schema / properties / states / descriptionAdded value: +"Optional official state codes when geography is state." - added
Input schema / properties / to / descriptionAdded value: +"Inclusive last month, YYYY-MM." - changed
Output schema / (root)Previous value: -nullNew value: +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {}, + "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.", + "properties": { + "data": { + "description": "Source-preserving data or schema payload for the selected official dataset." + }, + "links": { + "additionalProperties": {}, + "description": "Related API links.", + "properties": { + "observations": { + "description": "Canonical observations endpoint for this dataset.", + "type": "string" + }, + "self": { + "description": "Canonical URL for this response.", + "type": "string" + } + }, + "type": "object" + }, + "meta": { + "additionalProperties": {}, + "description": "Response metadata and source provenance.", + "properties": { + "dataset": { + "description": "Open Economics dataset identity when supplied." + }, + "provenance": { + "description": "Upstream source URLs, versions, timestamps, and methodology details." + } + }, + "type": "object" + } + }, + "required": [ + "data", + "meta" + ], + "type": "object" +}
- Changed
get_ibge_data2 fields changed- added
Input schema / properties / dataset_id / descriptionAdded value: +"Exact IBGE aggregate ID returned by search_official_data." - changed
Output schema / (root)Previous value: -nullNew value: +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {}, + "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.", + "properties": { + "data": { + "description": "Source-preserving data or schema payload for the selected official dataset." + }, + "links": { + "additionalProperties": {}, + "description": "Related API links.", + "properties": { + "observations": { + "description": "Canonical observations endpoint for this dataset.", + "type": "string" + }, + "self": { + "description": "Canonical URL for this response.", + "type": "string" + } + }, + "type": "object" + }, + "meta": { + "additionalProperties": {}, + "description": "Response metadata and source provenance.", + "properties": { + "dataset": { + "description": "Open Economics dataset identity when supplied." + }, + "provenance": { + "description": "Upstream source URLs, versions, timestamps, and methodology details." + } + }, + "type": "object" + } + }, + "required": [ + "data", + "meta" + ], + "type": "object" +}
- Changed
get_ibge_schema1 field changed- changed
Output schema / (root)Previous value: -nullNew value: +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {}, + "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.", + "properties": { + "data": { + "description": "Source-preserving data or schema payload for the selected official dataset." + }, + "links": { + "additionalProperties": {}, + "description": "Related API links.", + "properties": { + "observations": { + "description": "Canonical observations endpoint for this dataset.", + "type": "string" + }, + "self": { + "description": "Canonical URL for this response.", + "type": "string" + } + }, + "type": "object" + }, + "meta": { + "additionalProperties": {}, + "description": "Response metadata and source provenance.", + "properties": { + "dataset": { + "description": "Open Economics dataset identity when supplied." + }, + "provenance": { + "description": "Upstream source URLs, versions, timestamps, and methodology details." + } + }, + "type": "object" + } + }, + "required": [ + "data", + "meta" + ], + "type": "object" +}
- Changed
get_mte_formal_employment8 fields changed- added
Input schema / properties / breakdown / descriptionAdded value: +"Official breakdown for the employment result." - added
Input schema / properties / dataset_id / descriptionAdded value: +"The official MTE Novo Caged dataset identifier." - added
Input schema / properties / from / descriptionAdded value: +"Inclusive first month, YYYY-MM." - added
Input schema / properties / limit / descriptionAdded value: +"Maximum rows to return." - added
Input schema / properties / regions / descriptionAdded value: +"Optional official regions when breakdown is region." - added
Input schema / properties / states / descriptionAdded value: +"Optional official state codes when breakdown is state." - added
Input schema / properties / to / descriptionAdded value: +"Inclusive last month, YYYY-MM." - changed
Output schema / (root)Previous value: -nullNew value: +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {}, + "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.", + "properties": { + "data": { + "description": "Source-preserving data or schema payload for the selected official dataset." + }, + "links": { + "additionalProperties": {}, + "description": "Related API links.", + "properties": { + "observations": { + "description": "Canonical observations endpoint for this dataset.", + "type": "string" + }, + "self": { + "description": "Canonical URL for this response.", + "type": "string" + } + }, + "type": "object" + }, + "meta": { + "additionalProperties": {}, + "description": "Response metadata and source provenance.", + "properties": { + "dataset": { + "description": "Open Economics dataset identity when supplied." + }, + "provenance": { + "description": "Upstream source URLs, versions, timestamps, and methodology details." + } + }, + "type": "object" + } + }, + "required": [ + "data", + "meta" + ], + "type": "object" +}
- Changed
get_mte_formal_employment_schema2 fields changed- added
Input schema / properties / dataset_id / descriptionAdded value: +"The official MTE Novo Caged dataset identifier." - changed
Output schema / (root)Previous value: -nullNew value: +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {}, + "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.", + "properties": { + "data": { + "description": "Source-preserving data or schema payload for the selected official dataset." + }, + "links": { + "additionalProperties": {}, + "description": "Related API links.", + "properties": { + "observations": { + "description": "Canonical observations endpoint for this dataset.", + "type": "string" + }, + "self": { + "description": "Canonical URL for this response.", + "type": "string" + } + }, + "type": "object" + }, + "meta": { + "additionalProperties": {}, + "description": "Response metadata and source provenance.", + "properties": { + "dataset": { + "description": "Open Economics dataset identity when supplied." + }, + "provenance": { + "description": "Upstream source URLs, versions, timestamps, and methodology details." + } + }, + "type": "object" + } + }, + "required": [ + "data", + "meta" + ], + "type": "object" +}
- Changed
get_siconfi_data5 fields changed- added
Input schema / properties / dataset_id / descriptionAdded value: +"Exact SICONFI dataset ID returned by search_official_data." - added
Input schema / properties / report_type / descriptionAdded value: +"Official SICONFI report type for the selected dataset." - added
Input schema / properties / sphere / descriptionAdded value: +"Government sphere: municipal, state, federal, or consortium." - added
Input schema / properties / year / descriptionAdded value: +"Calendar year of the official report." - changed
Output schema / (root)Previous value: -nullNew value: +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {}, + "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.", + "properties": { + "data": { + "description": "Source-preserving data or schema payload for the selected official dataset." + }, + "links": { + "additionalProperties": {}, + "description": "Related API links.", + "properties": { + "observations": { + "description": "Canonical observations endpoint for this dataset.", + "type": "string" + }, + "self": { + "description": "Canonical URL for this response.", + "type": "string" + } + }, + "type": "object" + }, + "meta": { + "additionalProperties": {}, + "description": "Response metadata and source provenance.", + "properties": { + "dataset": { + "description": "Open Economics dataset identity when supplied." + }, + "provenance": { + "description": "Upstream source URLs, versions, timestamps, and methodology details." + } + }, + "type": "object" + } + }, + "required": [ + "data", + "meta" + ], + "type": "object" +}
- Changed
get_siconfi_schema2 fields changed- added
Input schema / properties / dataset_id / descriptionAdded value: +"Exact SICONFI dataset ID returned by search_official_data." - changed
Output schema / (root)Previous value: -nullNew value: +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {}, + "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.", + "properties": { + "data": { + "description": "Source-preserving data or schema payload for the selected official dataset." + }, + "links": { + "additionalProperties": {}, + "description": "Related API links.", + "properties": { + "observations": { + "description": "Canonical observations endpoint for this dataset.", + "type": "string" + }, + "self": { + "description": "Canonical URL for this response.", + "type": "string" + } + }, + "type": "object" + }, + "meta": { + "additionalProperties": {}, + "description": "Response metadata and source provenance.", + "properties": { + "dataset": { + "description": "Open Economics dataset identity when supplied." + }, + "provenance": { + "description": "Upstream source URLs, versions, timestamps, and methodology details." + } + }, + "type": "object" + } + }, + "required": [ + "data", + "meta" + ], + "type": "object" +}
- Changed
get_tesouro_dpf6 fields changed- added
Input schema / properties / dataset_id / descriptionAdded value: +"The official Tesouro Nacional DPF debt-profile dataset identifier." - added
Input schema / properties / from / descriptionAdded value: +"Inclusive first month, YYYY-MM." - added
Input schema / properties / limit / descriptionAdded value: +"Maximum debt-statistics rows to return." - added
Input schema / properties / table / descriptionAdded value: +"Versioned RMD table to retrieve." - added
Input schema / properties / to / descriptionAdded value: +"Inclusive last month, YYYY-MM." - changed
Output schema / (root)Previous value: -nullNew value: +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {}, + "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.", + "properties": { + "data": { + "description": "Source-preserving data or schema payload for the selected official dataset." + }, + "links": { + "additionalProperties": {}, + "description": "Related API links.", + "properties": { + "observations": { + "description": "Canonical observations endpoint for this dataset.", + "type": "string" + }, + "self": { + "description": "Canonical URL for this response.", + "type": "string" + } + }, + "type": "object" + }, + "meta": { + "additionalProperties": {}, + "description": "Response metadata and source provenance.", + "properties": { + "dataset": { + "description": "Open Economics dataset identity when supplied." + }, + "provenance": { + "description": "Upstream source URLs, versions, timestamps, and methodology details." + } + }, + "type": "object" + } + }, + "required": [ + "data", + "meta" + ], + "type": "object" +}
- Changed
get_tesouro_dpf_schema2 fields changed- added
Input schema / properties / dataset_id / descriptionAdded value: +"The official Tesouro Nacional DPF debt-profile dataset identifier." - changed
Output schema / (root)Previous value: -nullNew value: +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {}, + "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.", + "properties": { + "data": { + "description": "Source-preserving data or schema payload for the selected official dataset." + }, + "links": { + "additionalProperties": {}, + "description": "Related API links.", + "properties": { + "observations": { + "description": "Canonical observations endpoint for this dataset.", + "type": "string" + }, + "self": { + "description": "Canonical URL for this response.", + "type": "string" + } + }, + "type": "object" + }, + "meta": { + "additionalProperties": {}, + "description": "Response metadata and source provenance.", + "properties": { + "dataset": { + "description": "Open Economics dataset identity when supplied." + }, + "provenance": { + "description": "Upstream source URLs, versions, timestamps, and methodology details." + } + }, + "type": "object" + } + }, + "required": [ + "data", + "meta" + ], + "type": "object" +}
- Changed
get_tesouro_rtn5 fields changed- added
Input schema / properties / dataset_id / descriptionAdded value: +"The official Tesouro Nacional RTN dataset identifier." - added
Input schema / properties / from / descriptionAdded value: +"Inclusive first month, YYYY-MM." - added
Input schema / properties / limit / descriptionAdded value: +"Maximum account rows to return." - added
Input schema / properties / to / descriptionAdded value: +"Inclusive last month, YYYY-MM." - changed
Output schema / (root)Previous value: -nullNew value: +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {}, + "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.", + "properties": { + "data": { + "description": "Source-preserving data or schema payload for the selected official dataset." + }, + "links": { + "additionalProperties": {}, + "description": "Related API links.", + "properties": { + "observations": { + "description": "Canonical observations endpoint for this dataset.", + "type": "string" + }, + "self": { + "description": "Canonical URL for this response.", + "type": "string" + } + }, + "type": "object" + }, + "meta": { + "additionalProperties": {}, + "description": "Response metadata and source provenance.", + "properties": { + "dataset": { + "description": "Open Economics dataset identity when supplied." + }, + "provenance": { + "description": "Upstream source URLs, versions, timestamps, and methodology details." + } + }, + "type": "object" + } + }, + "required": [ + "data", + "meta" + ], + "type": "object" +}
- Changed
get_tesouro_rtn_schema2 fields changed- added
Input schema / properties / dataset_id / descriptionAdded value: +"The official Tesouro Nacional RTN dataset identifier." - changed
Output schema / (root)Previous value: -nullNew value: +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {}, + "description": "REST-aligned Open Economics response with data, metadata, links, and source provenance.", + "properties": { + "data": { + "description": "Source-preserving data or schema payload for the selected official dataset." + }, + "links": { + "additionalProperties": {}, + "description": "Related API links.", + "properties": { + "observations": { + "description": "Canonical observations endpoint for this dataset.", + "type": "string" + }, + "self": { + "description": "Canonical URL for this response.", + "type": "string" + } + }, + "type": "object" + }, + "meta": { + "additionalProperties": {}, + "description": "Response metadata and source provenance.", + "properties": { + "dataset": { + "description": "Open Economics dataset identity when supplied." + }, + "provenance": { + "description": "Upstream source URLs, versions, timestamps, and methodology details." + } + }, + "type": "object" + } + }, + "required": [ + "data", + "meta" + ], + "type": "object" +}
- Changed
search_official_data1 field changed- changed
Output schema / (root)Previous value: -nullNew value: +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": {}, + "description": "Semantic discovery result with ranked concepts, official datasets, and coverage state.", + "properties": { + "availability": { + "additionalProperties": {}, + "description": "Coverage assessment.", + "properties": { + "complete": { + "description": "Whether the requested need is completely covered.", + "type": "boolean" + }, + "explanation": { + "description": "Coverage explanation.", + "type": "string" + }, + "missingSources": { + "description": "Required source integrations that are not present.", + "items": { + "type": "string" + }, + "type": "array" + }, + "status": { + "description": "Availability state in the current Open Economics coverage.", + "type": "string" + } + }, + "required": [ + "status", + "complete", + "explanation", + "missingSources" + ], + "type": "object" + }, + "concepts": { + "description": "Ranked economic concepts matched to the request.", + "items": { + "additionalProperties": {}, + "properties": { + "id": { + "description": "Stable Open Economics concept ID.", + "type": "string" + } + }, + "required": [ + "id" + ], + "type": "object" + }, + "type": "array" + }, + "datasets": { + "description": "Ranked official datasets and their source identity.", + "items": { + "additionalProperties": {}, + "properties": { + "id": { + "description": "Stable official dataset ID.", + "type": "string" + }, + "metadataUrl": { + "description": "Official metadata URL.", + "type": "string" + }, + "provider": { + "description": "Open Economics provider identifier.", + "type": "string" + }, + "sourceAgency": { + "description": "Official publishing agency.", + "type": "string" + }, + "sourceUrl": { + "description": "Official source URL.", + "type": "string" + }, + "title": { + "description": "Official dataset title.", + "type": "string" + } + }, + "required": [ + "id", + "provider", + "sourceAgency", + "title", + "sourceUrl", + "metadataUrl" + ], + "type": "object" + }, + "type": "array" + }, + "normalizedQuery": { + "description": "Normalized form used for semantic resolution.", + "type": "string" + }, + "query": { + "description": "The original natural-language economic need.", + "type": "string" + }, + "resolution": { + "additionalProperties": {}, + "description": "Concept-resolution result.", + "properties": { + "confidence": { + "description": "Resolution confidence from 0 to 1.", + "type": "number" + }, + "explanation": { + "description": "Why the concept was or was not resolved.", + "type": "string" + }, + "status": { + "description": "Resolution state for the requested concept.", + "type": "string" + } + }, + "required": [ + "status", + "explanation" + ], + "type": "object" + } + }, + "required": [ + "query", + "normalizedQuery", + "resolution", + "concepts", + "datasets", + "availability" + ], + "type": "object" +}
19 tool updates
- First observed
describe_official_dataset - First observed
get_anp_fuel_prices - First observed
get_bcb_schema - First observed
get_bcb_series - First observed
get_comexstat_data - First observed
get_cvm_investment_funds - First observed
get_cvm_investment_funds_schema - First observed
get_epe_electricity_consumption - First observed
get_ibge_data - First observed
get_ibge_schema - First observed
get_mte_formal_employment - First observed
get_mte_formal_employment_schema - First observed
get_siconfi_data - First observed
get_siconfi_schema - First observed
get_tesouro_dpf - First observed
get_tesouro_dpf_schema - First observed
get_tesouro_rtn - First observed
get_tesouro_rtn_schema - First observed
search_official_data
Related MCP Connectors
Macroeconomic and other official data from 170+ publishers, resolved from natural language with provenance.
Brazilian public data API for AI agents. BCB, IBGE, CVM, B3, compliance. x402 payments on Base.
IBGE: geography, census, economy and health from the official APIs, with provenance. 23 tools.
Brazil Macroeconomic and Financial Data AI Platform for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceConnects AI agents to 28 Brazilian public APIs, providing over 200 tools to access data on economy, legislation, transparency, and the judiciary. It enables complex queries and cross-referencing of government datasets like IBGE, the Central Bank, and the National Congress through natural language.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to query Brazilian municipal transparency portals for payroll, expenses, contracts, bids, revenues, and legislation using natural language in Portuguese.MIT
- AlicenseNot gradedqualityBmaintenanceEnables querying Portugal's national open data portal (dados.gov.pt) through natural language.318 npmMIT
- AlicenseAqualityFmaintenanceEnables AI agents to discover, retrieve, compare, and analyze trusted macroeconomic statistics from central banks and international organizations, resolving concepts to official series with provenance and validation.6MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.