Serveur MCP
Open Economics
io.github.felipegambettadesouza6-jpg/open-economics
Ce que fait ce MCP
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.
Capacités
Outils
19
outils
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.
Lecture seule
Idempotent
Schéma d’entrée
{'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.'}}}
Schéma de sortie
{'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.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'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.'}}}
Schéma de sortie
{'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.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'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.'}}}
Schéma de sortie
{'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.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'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.'}}}
Schéma de sortie
{'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.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'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.'}}}
Schéma de sortie
{'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.
Lecture seule
Idempotent
Schéma d’entrée
{'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.'}}}
Schéma de sortie
{'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.
Lecture seule
Idempotent
Schéma d’entrée
{'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.'}}}
Schéma de sortie
{'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.
Lecture seule
Idempotent
Schéma d’entrée
{'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.'}}}
Schéma de sortie
{'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.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'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].'}}}
Schéma de sortie
{'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.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'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.'}}}
Schéma de sortie
{'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.
Lecture seule
Idempotent
Schéma d’entrée
{'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.'}}}
Schéma de sortie
{'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.
Lecture seule
Idempotent
Schéma d’entrée
{'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.'}}}
Schéma de sortie
{'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.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'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.'}}}
Schéma de sortie
{'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.
Lecture seule
Idempotent
Schéma d’entrée
{'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.'}}}
Schéma de sortie
{'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.
Lecture seule
Idempotent
Schéma d’entrée
{'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.'}}}
Schéma de sortie
{'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.
Lecture seule
Idempotent
Schéma d’entrée
{'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.'}}}
Schéma de sortie
{'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.
Lecture seule
Idempotent
Schéma d’entrée
{'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.'}}}
Schéma de sortie
{'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.
Lecture seule
Idempotent
Schéma d’entrée
{'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.'}}}
Schéma de sortie
{'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.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'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."}}}
Schéma de sortie
{'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': {}}
Historique
Modifications récentes des outils
Ajouté
get_cvm_investment_funds
17 September 2026 12:41
Ajouté
get_tesouro_dpf
17 September 2026 12:41
Ajouté
get_tesouro_dpf_schema
17 September 2026 12:41
Ajouté
get_tesouro_rtn
17 September 2026 12:41
Ajouté
get_tesouro_rtn_schema
17 September 2026 12:41
Ajouté
get_cvm_investment_funds_schema
17 September 2026 12:41
Ajouté
get_mte_formal_employment
17 September 2026 12:41
Ajouté
get_mte_formal_employment_schema
17 September 2026 12:41
Ajouté
get_epe_electricity_consumption
17 September 2026 12:41
Ajouté
get_anp_fuel_prices
17 September 2026 12:41
Ajouté
get_comexstat_data
17 September 2026 12:41
Ajouté
get_siconfi_data
17 September 2026 12:41
Ajouté
get_siconfi_schema
17 September 2026 12:41
Ajouté
get_ibge_data
17 September 2026 12:41
Ajouté
get_ibge_schema
17 September 2026 12:41
Ajouté
get_bcb_schema
17 September 2026 12:41
Ajouté
get_bcb_series
17 September 2026 12:41
Ajouté
describe_official_dataset
17 September 2026 12:41
Ajouté
search_official_data
17 September 2026 12:41
Découvrir
Serveurs MCP similaires
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…