MCP Server
Open Economics
io.github.felipegambettadesouza6-jpg/open-economics
What this MCP does
Discovers and queries official Brazilian economic datasets from agencies including BCB, IBGE, ANP, MDIC, CVM, EPE, MTE, SICONFI, and Tesouro, with schema and provenance metadata.
Capabilities
Tools
19
tools
describe_official_dataset
Describe an official dataset
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.
Read only
Idempotent
Input schema
{'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.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id', 'provider', 'sourceAgency', 'title', 'sourceUrl', 'metadataUrl', 'queryCapability'], 'properties': {'id': {'type': 'string', 'description': 'Stable official dataset ID.'}, 'title': {'type': 'string', 'description': 'Official dataset title.'}, 'provider': {'type': 'string', 'description': 'Open Economics provider identifier.'}, 'sourceUrl': {'type': 'string', 'description': 'Official source URL.'}, 'collection': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Official collection identifier, when supplied by the publisher.'}, 'metadataUrl': {'type': 'string', 'description': 'Official metadata URL.'}, 'sourceAgency': {'type': 'string', 'description': 'Official publishing agency.'}, 'collectionName': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Official collection name, when supplied by the publisher.'}, 'queryCapability': {'type': 'string', 'description': 'Supported query capability.'}}, 'description': 'Official dataset identity, source, provenance, and query capability.', 'additionalProperties': {}}
get_anp_fuel_prices
Query official 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
Open world
Idempotent
Input schema
{'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.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'meta'], 'properties': {'data': {'description': 'Source-preserving data or schema payload for the selected official dataset.'}, 'meta': {'type': 'object', 'properties': {'dataset': {'description': 'Open Economics dataset identity when supplied.'}, 'provenance': {'description': 'Upstream source URLs, versions, timestamps, and methodology details.'}}, 'description': 'Response metadata and source provenance.', 'additionalProperties': {}}, 'links': {'type': 'object', 'properties': {'self': {'type': 'string', 'description': 'Canonical URL for this response.'}, 'observations': {'type': 'string', 'description': 'Canonical observations endpoint for this dataset.'}}, 'description': 'Related API links.', 'additionalProperties': {}}}, 'description': 'REST-aligned Open Economics response with data, metadata, links, and source provenance.', 'additionalProperties': {}}
get_bcb_schema
Inspect BCB series meaning and units
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
Open world
Idempotent
Input schema
{'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.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'meta'], 'properties': {'data': {'description': 'Source-preserving data or schema payload for the selected official dataset.'}, 'meta': {'type': 'object', 'properties': {'dataset': {'description': 'Open Economics dataset identity when supplied.'}, 'provenance': {'description': 'Upstream source URLs, versions, timestamps, and methodology details.'}}, 'description': 'Response metadata and source provenance.', 'additionalProperties': {}}, 'links': {'type': 'object', 'properties': {'self': {'type': 'string', 'description': 'Canonical URL for this response.'}, 'observations': {'type': 'string', 'description': 'Canonical observations endpoint for this dataset.'}}, 'description': 'Related API links.', 'additionalProperties': {}}}, 'description': 'REST-aligned Open Economics response with data, metadata, links, and source provenance.', 'additionalProperties': {}}
get_bcb_series
Get observations from a BCB SGS 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
Open world
Idempotent
Input schema
{'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.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'meta'], 'properties': {'data': {'description': 'Source-preserving data or schema payload for the selected official dataset.'}, 'meta': {'type': 'object', 'properties': {'dataset': {'description': 'Open Economics dataset identity when supplied.'}, 'provenance': {'description': 'Upstream source URLs, versions, timestamps, and methodology details.'}}, 'description': 'Response metadata and source provenance.', 'additionalProperties': {}}, 'links': {'type': 'object', 'properties': {'self': {'type': 'string', 'description': 'Canonical URL for this response.'}, 'observations': {'type': 'string', 'description': 'Canonical observations endpoint for this dataset.'}}, 'description': 'Related API links.', 'additionalProperties': {}}}, 'description': 'REST-aligned Open Economics response with data, metadata, links, and source provenance.', 'additionalProperties': {}}
get_comexstat_data
Query official Brazilian merchandise trade
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
Open world
Idempotent
Input schema
{'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.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'meta'], 'properties': {'data': {'description': 'Source-preserving data or schema payload for the selected official dataset.'}, 'meta': {'type': 'object', 'properties': {'dataset': {'description': 'Open Economics dataset identity when supplied.'}, 'provenance': {'description': 'Upstream source URLs, versions, timestamps, and methodology details.'}}, 'description': 'Response metadata and source provenance.', 'additionalProperties': {}}, 'links': {'type': 'object', 'properties': {'self': {'type': 'string', 'description': 'Canonical URL for this response.'}, 'observations': {'type': 'string', 'description': 'Canonical observations endpoint for this dataset.'}}, 'description': 'Related API links.', 'additionalProperties': {}}}, 'description': 'REST-aligned Open Economics response with data, metadata, links, and source provenance.', 'additionalProperties': {}}
get_cvm_investment_funds
Query official CVM investment-fund reports
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
Idempotent
Input schema
{'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.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'meta'], 'properties': {'data': {'description': 'Source-preserving data or schema payload for the selected official dataset.'}, 'meta': {'type': 'object', 'properties': {'dataset': {'description': 'Open Economics dataset identity when supplied.'}, 'provenance': {'description': 'Upstream source URLs, versions, timestamps, and methodology details.'}}, 'description': 'Response metadata and source provenance.', 'additionalProperties': {}}, 'links': {'type': 'object', 'properties': {'self': {'type': 'string', 'description': 'Canonical URL for this response.'}, 'observations': {'type': 'string', 'description': 'Canonical observations endpoint for this dataset.'}}, 'description': 'Related API links.', 'additionalProperties': {}}}, 'description': 'REST-aligned Open Economics response with data, metadata, links, and source provenance.', 'additionalProperties': {}}
get_cvm_investment_funds_schema
Inspect CVM investment-fund measures and dimensions
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
Idempotent
Input schema
{'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.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'meta'], 'properties': {'data': {'description': 'Source-preserving data or schema payload for the selected official dataset.'}, 'meta': {'type': 'object', 'properties': {'dataset': {'description': 'Open Economics dataset identity when supplied.'}, 'provenance': {'description': 'Upstream source URLs, versions, timestamps, and methodology details.'}}, 'description': 'Response metadata and source provenance.', 'additionalProperties': {}}, 'links': {'type': 'object', 'properties': {'self': {'type': 'string', 'description': 'Canonical URL for this response.'}, 'observations': {'type': 'string', 'description': 'Canonical observations endpoint for this dataset.'}}, 'description': 'Related API links.', 'additionalProperties': {}}}, 'description': 'REST-aligned Open Economics response with data, metadata, links, and source provenance.', 'additionalProperties': {}}
get_epe_electricity_consumption
Query official 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
Idempotent
Input schema
{'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.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'meta'], 'properties': {'data': {'description': 'Source-preserving data or schema payload for the selected official dataset.'}, 'meta': {'type': 'object', 'properties': {'dataset': {'description': 'Open Economics dataset identity when supplied.'}, 'provenance': {'description': 'Upstream source URLs, versions, timestamps, and methodology details.'}}, 'description': 'Response metadata and source provenance.', 'additionalProperties': {}}, 'links': {'type': 'object', 'properties': {'self': {'type': 'string', 'description': 'Canonical URL for this response.'}, 'observations': {'type': 'string', 'description': 'Canonical observations endpoint for this dataset.'}}, 'description': 'Related API links.', 'additionalProperties': {}}}, 'description': 'REST-aligned Open Economics response with data, metadata, links, and source provenance.', 'additionalProperties': {}}
get_ibge_data
Query multidimensional 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
Open world
Idempotent
Input schema
{'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].'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'meta'], 'properties': {'data': {'description': 'Source-preserving data or schema payload for the selected official dataset.'}, 'meta': {'type': 'object', 'properties': {'dataset': {'description': 'Open Economics dataset identity when supplied.'}, 'provenance': {'description': 'Upstream source URLs, versions, timestamps, and methodology details.'}}, 'description': 'Response metadata and source provenance.', 'additionalProperties': {}}, 'links': {'type': 'object', 'properties': {'self': {'type': 'string', 'description': 'Canonical URL for this response.'}, 'observations': {'type': 'string', 'description': 'Canonical observations endpoint for this dataset.'}}, 'description': 'Related API links.', 'additionalProperties': {}}}, 'description': 'REST-aligned Open Economics response with data, metadata, links, and source provenance.', 'additionalProperties': {}}
get_ibge_schema
Inspect an IBGE aggregate's measures and dimensions
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
Open world
Idempotent
Input schema
{'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.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'meta'], 'properties': {'data': {'description': 'Source-preserving data or schema payload for the selected official dataset.'}, 'meta': {'type': 'object', 'properties': {'dataset': {'description': 'Open Economics dataset identity when supplied.'}, 'provenance': {'description': 'Upstream source URLs, versions, timestamps, and methodology details.'}}, 'description': 'Response metadata and source provenance.', 'additionalProperties': {}}, 'links': {'type': 'object', 'properties': {'self': {'type': 'string', 'description': 'Canonical URL for this response.'}, 'observations': {'type': 'string', 'description': 'Canonical observations endpoint for this dataset.'}}, 'description': 'Related API links.', 'additionalProperties': {}}}, 'description': 'REST-aligned Open Economics response with data, metadata, links, and source provenance.', 'additionalProperties': {}}
get_mte_formal_employment
Query official formal-employment stock and flows
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
Idempotent
Input schema
{'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.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'meta'], 'properties': {'data': {'description': 'Source-preserving data or schema payload for the selected official dataset.'}, 'meta': {'type': 'object', 'properties': {'dataset': {'description': 'Open Economics dataset identity when supplied.'}, 'provenance': {'description': 'Upstream source URLs, versions, timestamps, and methodology details.'}}, 'description': 'Response metadata and source provenance.', 'additionalProperties': {}}, 'links': {'type': 'object', 'properties': {'self': {'type': 'string', 'description': 'Canonical URL for this response.'}, 'observations': {'type': 'string', 'description': 'Canonical observations endpoint for this dataset.'}}, 'description': 'Related API links.', 'additionalProperties': {}}}, 'description': 'REST-aligned Open Economics response with data, metadata, links, and source provenance.', 'additionalProperties': {}}
get_mte_formal_employment_schema
Inspect Novo Caged dimensions and measures
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
Idempotent
Input schema
{'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.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'meta'], 'properties': {'data': {'description': 'Source-preserving data or schema payload for the selected official dataset.'}, 'meta': {'type': 'object', 'properties': {'dataset': {'description': 'Open Economics dataset identity when supplied.'}, 'provenance': {'description': 'Upstream source URLs, versions, timestamps, and methodology details.'}}, 'description': 'Response metadata and source provenance.', 'additionalProperties': {}}, 'links': {'type': 'object', 'properties': {'self': {'type': 'string', 'description': 'Canonical URL for this response.'}, 'observations': {'type': 'string', 'description': 'Canonical observations endpoint for this dataset.'}}, 'description': 'Related API links.', 'additionalProperties': {}}}, 'description': 'REST-aligned Open Economics response with data, metadata, links, and source provenance.', 'additionalProperties': {}}
get_siconfi_data
Query official SICONFI fiscal 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
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['dataset_id'], 'properties': {'year': {'type': 'integer', 'maximum': 2100, 'minimum': 2013, 'description': 'Calendar year of the official report.'}, 'annex': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Exact official annex name from the SICONFI documentation.'}, 'power': {'enum': ['E', 'L', 'J', 'M', 'D'], 'type': 'string', 'description': 'RGF government branch.'}, 'entity': {'type': 'integer', 'maximum': 9999999, 'minimum': 1, 'description': 'Official IBGE entity code.'}, 'period': {'type': 'integer', 'maximum': 6, 'minimum': 1, 'description': 'RREO bimestre (1-6) or RGF period (1-3).'}, 'sphere': {'enum': ['M', 'E', 'U', 'C'], 'type': 'string', 'description': 'Government sphere: municipal, state, federal, or consortium.'}, 'dataset_id': {'type': 'string', 'pattern': '^siconfi:(?:rreo|rgf|dca|entes)$', 'description': 'Exact SICONFI dataset ID returned by search_official_data.'}, 'periodicity': {'enum': ['Q', 'S'], 'type': 'string', 'description': 'RGF only: four-month (Q) or half-year (S).'}, 'report_type': {'enum': ['RREO', 'RREO Simplificado', 'RGF', 'RGF Simplificado'], 'type': 'string', 'description': 'Official SICONFI report type for the selected dataset.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'meta'], 'properties': {'data': {'description': 'Source-preserving data or schema payload for the selected official dataset.'}, 'meta': {'type': 'object', 'properties': {'dataset': {'description': 'Open Economics dataset identity when supplied.'}, 'provenance': {'description': 'Upstream source URLs, versions, timestamps, and methodology details.'}}, 'description': 'Response metadata and source provenance.', 'additionalProperties': {}}, 'links': {'type': 'object', 'properties': {'self': {'type': 'string', 'description': 'Canonical URL for this response.'}, 'observations': {'type': 'string', 'description': 'Canonical observations endpoint for this dataset.'}}, 'description': 'Related API links.', 'additionalProperties': {}}}, 'description': 'REST-aligned Open Economics response with data, metadata, links, and source provenance.', 'additionalProperties': {}}
get_siconfi_schema
Inspect a SICONFI fiscal report
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
Idempotent
Input schema
{'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.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'meta'], 'properties': {'data': {'description': 'Source-preserving data or schema payload for the selected official dataset.'}, 'meta': {'type': 'object', 'properties': {'dataset': {'description': 'Open Economics dataset identity when supplied.'}, 'provenance': {'description': 'Upstream source URLs, versions, timestamps, and methodology details.'}}, 'description': 'Response metadata and source provenance.', 'additionalProperties': {}}, 'links': {'type': 'object', 'properties': {'self': {'type': 'string', 'description': 'Canonical URL for this response.'}, 'observations': {'type': 'string', 'description': 'Canonical observations endpoint for this dataset.'}}, 'description': 'Related API links.', 'additionalProperties': {}}}, 'description': 'REST-aligned Open Economics response with data, metadata, links, and source provenance.', 'additionalProperties': {}}
get_tesouro_dpf
Query Federal Public Debt statistics
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
Idempotent
Input schema
{'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.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'meta'], 'properties': {'data': {'description': 'Source-preserving data or schema payload for the selected official dataset.'}, 'meta': {'type': 'object', 'properties': {'dataset': {'description': 'Open Economics dataset identity when supplied.'}, 'provenance': {'description': 'Upstream source URLs, versions, timestamps, and methodology details.'}}, 'description': 'Response metadata and source provenance.', 'additionalProperties': {}}, 'links': {'type': 'object', 'properties': {'self': {'type': 'string', 'description': 'Canonical URL for this response.'}, 'observations': {'type': 'string', 'description': 'Canonical observations endpoint for this dataset.'}}, 'description': 'Related API links.', 'additionalProperties': {}}}, 'description': 'REST-aligned Open Economics response with data, metadata, links, and source provenance.', 'additionalProperties': {}}
get_tesouro_dpf_schema
Inspect Federal Public Debt statistics
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
Idempotent
Input schema
{'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.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'meta'], 'properties': {'data': {'description': 'Source-preserving data or schema payload for the selected official dataset.'}, 'meta': {'type': 'object', 'properties': {'dataset': {'description': 'Open Economics dataset identity when supplied.'}, 'provenance': {'description': 'Upstream source URLs, versions, timestamps, and methodology details.'}}, 'description': 'Response metadata and source provenance.', 'additionalProperties': {}}, 'links': {'type': 'object', 'properties': {'self': {'type': 'string', 'description': 'Canonical URL for this response.'}, 'observations': {'type': 'string', 'description': 'Canonical observations endpoint for this dataset.'}}, 'description': 'Related API links.', 'additionalProperties': {}}}, 'description': 'REST-aligned Open Economics response with data, metadata, links, and source provenance.', 'additionalProperties': {}}
get_tesouro_rtn
Query Government Central revenue, expenditure, and result
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
Idempotent
Input schema
{'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.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'meta'], 'properties': {'data': {'description': 'Source-preserving data or schema payload for the selected official dataset.'}, 'meta': {'type': 'object', 'properties': {'dataset': {'description': 'Open Economics dataset identity when supplied.'}, 'provenance': {'description': 'Upstream source URLs, versions, timestamps, and methodology details.'}}, 'description': 'Response metadata and source provenance.', 'additionalProperties': {}}, 'links': {'type': 'object', 'properties': {'self': {'type': 'string', 'description': 'Canonical URL for this response.'}, 'observations': {'type': 'string', 'description': 'Canonical observations endpoint for this dataset.'}}, 'description': 'Related API links.', 'additionalProperties': {}}}, 'description': 'REST-aligned Open Economics response with data, metadata, links, and source provenance.', 'additionalProperties': {}}
get_tesouro_rtn_schema
Inspect Government Central fiscal accounts
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
Idempotent
Input schema
{'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.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'meta'], 'properties': {'data': {'description': 'Source-preserving data or schema payload for the selected official dataset.'}, 'meta': {'type': 'object', 'properties': {'dataset': {'description': 'Open Economics dataset identity when supplied.'}, 'provenance': {'description': 'Upstream source URLs, versions, timestamps, and methodology details.'}}, 'description': 'Response metadata and source provenance.', 'additionalProperties': {}}, 'links': {'type': 'object', 'properties': {'self': {'type': 'string', 'description': 'Canonical URL for this response.'}, 'observations': {'type': 'string', 'description': 'Canonical observations endpoint for this dataset.'}}, 'description': 'Related API links.', 'additionalProperties': {}}}, 'description': 'REST-aligned Open Economics response with data, metadata, links, and source provenance.', 'additionalProperties': {}}
search_official_data
Search Brazilian official economic 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
Open world
Idempotent
Input schema
{'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."}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query', 'normalizedQuery', 'resolution', 'concepts', 'datasets', 'availability'], 'properties': {'query': {'type': 'string', 'description': 'The original natural-language economic need.'}, 'concepts': {'type': 'array', 'items': {'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Stable Open Economics concept ID.'}}, 'additionalProperties': {}}, 'description': 'Ranked economic concepts matched to the request.'}, 'datasets': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'provider', 'sourceAgency', 'title', 'sourceUrl', 'metadataUrl'], 'properties': {'id': {'type': 'string', 'description': 'Stable official dataset ID.'}, 'title': {'type': 'string', 'description': 'Official dataset title.'}, 'provider': {'type': 'string', 'description': 'Open Economics provider identifier.'}, 'sourceUrl': {'type': 'string', 'description': 'Official source URL.'}, 'metadataUrl': {'type': 'string', 'description': 'Official metadata URL.'}, 'sourceAgency': {'type': 'string', 'description': 'Official publishing agency.'}}, 'additionalProperties': {}}, 'description': 'Ranked official datasets and their source identity.'}, 'resolution': {'type': 'object', 'required': ['status', 'explanation'], 'properties': {'status': {'type': 'string', 'description': 'Resolution state for the requested concept.'}, 'confidence': {'type': 'number', 'description': 'Resolution confidence from 0 to 1.'}, 'explanation': {'type': 'string', 'description': 'Why the concept was or was not resolved.'}}, 'description': 'Concept-resolution result.', 'additionalProperties': {}}, 'availability': {'type': 'object', 'required': ['status', 'complete', 'explanation', 'missingSources'], 'properties': {'status': {'type': 'string', 'description': 'Availability state in the current Open Economics coverage.'}, 'complete': {'type': 'boolean', 'description': 'Whether the requested need is completely covered.'}, 'explanation': {'type': 'string', 'description': 'Coverage explanation.'}, 'missingSources': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Required source integrations that are not present.'}}, 'description': 'Coverage assessment.', 'additionalProperties': {}}, 'normalizedQuery': {'type': 'string', 'description': 'Normalized form used for semantic resolution.'}}, 'description': 'Semantic discovery result with ranked concepts, official datasets, and coverage state.', 'additionalProperties': {}}
History
Recent tool changes
Added
get_cvm_investment_funds
Sept. 17, 2026, 12:41 p.m.
Added
get_tesouro_dpf
Sept. 17, 2026, 12:41 p.m.
Added
get_tesouro_dpf_schema
Sept. 17, 2026, 12:41 p.m.
Added
get_tesouro_rtn
Sept. 17, 2026, 12:41 p.m.
Added
get_tesouro_rtn_schema
Sept. 17, 2026, 12:41 p.m.
Added
get_cvm_investment_funds_schema
Sept. 17, 2026, 12:41 p.m.
Added
get_mte_formal_employment
Sept. 17, 2026, 12:41 p.m.
Added
get_mte_formal_employment_schema
Sept. 17, 2026, 12:41 p.m.
Added
get_epe_electricity_consumption
Sept. 17, 2026, 12:41 p.m.
Added
get_anp_fuel_prices
Sept. 17, 2026, 12:41 p.m.
Added
get_comexstat_data
Sept. 17, 2026, 12:41 p.m.
Added
get_siconfi_data
Sept. 17, 2026, 12:41 p.m.
Added
get_siconfi_schema
Sept. 17, 2026, 12:41 p.m.
Added
get_ibge_data
Sept. 17, 2026, 12:41 p.m.
Added
get_ibge_schema
Sept. 17, 2026, 12:41 p.m.
Added
get_bcb_schema
Sept. 17, 2026, 12:41 p.m.
Added
get_bcb_series
Sept. 17, 2026, 12:41 p.m.
Added
describe_official_dataset
Sept. 17, 2026, 12:41 p.m.
Added
search_official_data
Sept. 17, 2026, 12:41 p.m.
Discover
Similar MCP servers
LiveDataLink
io.github.blackboxfoundry/livedatalink
Exposes public-data tools covering economics, labor, banking, transport, books, legal opinions, carriers, environmental data, and…
Stratalize Healthcare
com.stratalize/healthcare
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Governance
com.stratalize/governance
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Oracle
com.stratalize/oracle
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Real Estate
com.stratalize/realestate
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Crypto & DeFi
com.stratalize/crypto
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Valuein — SEC EDGAR Fundamentals & Smart-Money Data
io.github.valuein/mcp-sec-edgar
Provides point-in-time SEC EDGAR fundamentals, filings, ownership signals, financial analysis, valuation models, research reports…
equibles
io.github.daniel3303/equibles
Provides equity and market research tools covering SEC filings, company financials, portfolios, prices, options, macroeconomic da…