Servidor MCP

Australian Economic Data (ABS, RBA & APRA)

io.github.AnthonyPuggs/ausecon-mcp-server

Qué hace este MCP

Retrieves and explores official Australian economic datasets from ABS, RBA, and APRA, including inflation, GDP, labour, interest rates, and financial indicators.

describe_dataset
Describe Dataset
Describe a source-native ABS, RBA, or APRA dataset without hiding native IDs.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['source', 'identifier'], 'properties': {'source': {'enum': ['abs', 'rba', 'apra'], 'type': 'string', 'description': 'Source selector. Use abs for Australian Bureau of Statistics, rba for Reserve Bank of Australia, or apra for Australian Prudential Regulation Authority.'}, 'table_id': {'anyOf': [{'type': 'string', 'minLength': 1, 'description': 'Non-empty dataset or table id.'}, {'type': 'null'}], 'default': None, 'description': 'Non-empty dataset or table id.'}, 'identifier': {'type': 'string', 'minLength': 1, 'description': 'Non-empty dataset or table id.'}, 'include_structure': {'type': 'boolean', 'default': False, 'description': 'Whether ABS descriptions should include source-native structure details.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'description': 'Plain-English dataset description preserving source-native identifiers.', 'additionalProperties': True}
get_abs_data
Get ABS Data
Expert/source-native ABS SDMX retrieval in a normalised response shape.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['dataflow_id'], 'properties': {'key': {'type': 'string', 'default': 'all', 'minLength': 1, 'description': 'ABS SDMX key, or "all" for all series.'}, 'last_n': {'anyOf': [{'type': 'integer', 'minimum': 1}, {'type': 'null'}], 'default': None, 'description': 'Optional limit returning only the most recent N observations per series; metadata.truncated is true when older observations were dropped.'}, 'end_period': {'anyOf': [{'type': 'string', 'pattern': '^(\\d{4}|\\d{4}-Q[1-4]|\\d{4}-(0[1-9]|1[0-2])|\\d{4}-S[1-2])$'}, {'type': 'null'}], 'default': None, 'description': 'Optional ABS period bound in YYYY, YYYY-QN, YYYY-MM, or YYYY-SN format.'}, 'dataflow_id': {'type': 'string', 'minLength': 1, 'description': 'Non-empty dataset or table id.'}, 'start_period': {'anyOf': [{'type': 'string', 'pattern': '^(\\d{4}|\\d{4}-Q[1-4]|\\d{4}-(0[1-9]|1[0-2])|\\d{4}-S[1-2])$'}, {'type': 'null'}], 'default': None, 'description': 'Optional ABS period bound in YYYY, YYYY-QN, YYYY-MM, or YYYY-SN format.'}, 'updated_after': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional ISO date or datetime accepted by the ABS updatedAfter API.'}, 'include_observation_dimensions': {'type': 'boolean', 'default': False, 'description': 'Whether to repeat the full dimension dict on every observation. Off by default because the same dimensions already appear on each series descriptor and are encoded in series_id.'}}, 'additionalProperties': False}
Esquema de salida
{'$id': 'https://github.com/AnthonyPuggs/ausecon-mcp-server/schemas/response.schema.json', 'type': 'object', 'title': 'Ausecon Retrieval Response', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['metadata', 'series', 'observations'], 'properties': {'series': {'type': 'array', 'items': {'type': 'object', 'required': ['series_id', 'label', 'dimensions'], 'properties': {'unit': {'type': ['string', 'null']}, 'label': {'type': 'string'}, 'decimals': {'type': ['integer', 'null'], 'description': 'ABS DECIMALS value when supplied by the source.'}, 'frequency': {'type': ['string', 'null']}, 'series_id': {'type': 'string'}, 'dimensions': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'source_key': {'type': ['string', 'null']}, 'base_period': {'type': ['string', 'null'], 'description': 'ABS BASE_PERIOD value when supplied by the source.'}, 'unit_multiplier': {'type': ['integer', 'null'], 'description': 'ABS UNIT_MULT value when supplied by the source.'}}, 'additionalProperties': False}, 'description': 'Series descriptors keyed by series_id.'}, 'metadata': {'type': 'object', 'required': ['source', 'dataset_id', 'server_version', 'truncated'], 'properties': {'stale': {'type': 'boolean'}, 'title': {'type': ['string', 'null']}, 'bundle': {'type': ['string', 'array', 'object', 'null']}, 'source': {'enum': ['abs', 'rba', 'apra', 'derived'], 'type': 'string'}, 'derived': {'type': 'object', 'required': ['concept', 'description', 'formula', 'operands', 'source_concepts', 'alignment_frequency', 'alignment_method', 'units', 'requested_bounds', 'resolved_bounds', 'dropped_observations'], 'properties': {'units': {'type': 'string'}, 'concept': {'type': 'string'}, 'formula': {'type': 'string'}, 'operands': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'concept', 'source', 'dataset_id', 'upstream_id', 'abs_key', 'rba_series_ids', 'series_ids'], 'properties': {'name': {'type': 'string'}, 'source': {'enum': ['abs', 'rba', None], 'type': ['string', 'null']}, 'abs_key': {'type': ['string', 'null']}, 'concept': {'type': 'string'}, 'dataset_id': {'type': ['string', 'null']}, 'series_ids': {'type': 'array', 'items': {'type': 'string'}}, 'upstream_id': {'type': ['string', 'null']}, 'rba_series_ids': {'type': ['array', 'null'], 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'description': {'type': 'string'}, 'resolved_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'source_concepts': {'type': 'array', 'items': {'type': 'string'}}, 'alignment_method': {'enum': ['locf', 'exact_month', 'period_intersection', 'year_ended_lag'], 'type': 'string'}, 'requested_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'alignment_frequency': {'type': 'string'}, 'dropped_observations': {'type': 'object', 'required': ['input', 'derived', 'returned', 'dropped'], 'properties': {'input': {'type': 'integer', 'minimum': 0}, 'derived': {'type': 'integer', 'minimum': 0}, 'dropped': {'type': 'integer', 'minimum': 0}, 'returned': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'description': 'Derived-series provenance when returned by get_derived_series.', 'additionalProperties': False}, 'semantic': {'type': 'object', 'required': ['concept', 'variant', 'geography', 'frequency', 'requested_bounds', 'resolved_bounds', 'target'], 'properties': {'target': {'type': 'object', 'required': ['source', 'dataset_id', 'upstream_id', 'abs_key', 'rba_series_ids'], 'properties': {'source': {'enum': ['abs', 'rba', 'apra'], 'type': 'string'}, 'abs_key': {'type': ['string', 'null']}, 'dataset_id': {'type': 'string'}, 'upstream_id': {'type': 'string'}, 'apra_table_id': {'type': ['string', 'null']}, 'rba_series_ids': {'type': ['array', 'null'], 'items': {'type': 'string'}}, 'apra_series_ids': {'type': ['array', 'null'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'concept': {'type': 'string'}, 'variant': {'type': ['string', 'null']}, 'frequency': {'type': ['string', 'null']}, 'geography': {'type': ['string', 'null']}, 'resolved_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'requested_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'description': 'Semantic concept provenance when returned by get_economic_series.', 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Plain-English source warnings relevant to the payload.'}, 'cached_at': {'type': 'number'}, 'frequency': {'type': ['string', 'null']}, 'selection': {'oneOf': [{'type': 'object', 'required': ['type', 'n', 'direction', 'numeric_observation_count', 'returned_observation_count', 'dropped_non_numeric_count'], 'properties': {'n': {'type': 'integer', 'minimum': 1}, 'type': {'enum': ['top_n'], 'type': 'string'}, 'direction': {'enum': ['highest', 'lowest'], 'type': 'string'}, 'dropped_non_numeric_count': {'type': 'integer', 'minimum': 0}, 'numeric_observation_count': {'type': 'integer', 'minimum': 0}, 'returned_observation_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, {'type': 'object', 'required': ['type', 'n', 'series_count', 'returned_observation_count'], 'properties': {'n': {'type': 'integer', 'minimum': 1}, 'type': {'enum': ['latest'], 'type': 'string'}, 'series_count': {'type': 'integer', 'minimum': 0}, 'returned_observation_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}], 'description': 'Observation-selection provenance when returned by convenience tools.'}, 'truncated': {'type': 'boolean'}, 'dataset_id': {'type': 'string'}, 'expires_at': {'type': 'number'}, 'retrieved_at': {'type': 'string', 'format': 'date-time'}, 'retrieval_url': {'type': 'string'}, 'updated_after': {'type': ['string', 'null']}, 'server_version': {'type': 'string'}, 'framework_breaks': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'label', 'description'], 'properties': {'date': {'type': 'string'}, 'label': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'Known source framework or reporting-definition breaks relevant to the payload.'}, 'publication_date': {'type': ['string', 'null']}, 'apra_url_resolution': {'type': 'object', 'required': ['strategy', 'seed_checked_at'], 'properties': {'strategy': {'enum': ['landing_page', 'seed_manifest', 'catalogue_fallback'], 'type': 'string'}, 'seed_checked_at': {'type': ['string', 'null']}}, 'description': 'APRA workbook URL resolution strategy used for this retrieval.', 'additionalProperties': False}, 'observations_dropped': {'type': 'integer', 'minimum': 0, 'description': 'Number of observations removed by last_n selection; truncated is true when this is non-zero.'}}, 'description': 'Source, provenance, cache, and retrieval metadata for this response.', 'additionalProperties': False}, 'observations': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'series_id', 'value'], 'properties': {'date': {'oneOf': [{'type': 'string', 'format': 'date', 'pattern': '^\\d{4}-(0[1-9]|1[0-2])-[0-3][0-9]$'}, {'type': 'string', 'pattern': '^\\d{4}$'}, {'type': 'string', 'pattern': '^\\d{4}-Q[1-4]$'}, {'type': 'string', 'pattern': '^\\d{4}-(0[1-9]|1[0-2])$'}, {'type': 'string', 'pattern': '^\\d{4}-S[1-2]$'}], 'description': 'Observation date as an ISO date or source-native ABS period.'}, 'value': {'type': ['number', 'null']}, 'status': {'type': ['string', 'null']}, 'comment': {'type': ['string', 'null'], 'description': 'ABS observation comment when supplied by the source.'}, 'raw_value': {'type': ['string', 'null']}, 'series_id': {'type': 'string'}, 'dimensions': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'description': 'Long-form observations keyed by date and series_id.'}}, 'description': 'Normalised retrieval response returned by ABS, RBA, APRA, semantic, and derived data tools.', 'additionalProperties': False}
get_abs_dataset_structure
Get ABS Dataset Structure
Get ABS SDMX dataset dimensions and codelists.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['dataflow_id'], 'properties': {'dataflow_id': {'type': 'string', 'minLength': 1, 'description': 'Non-empty dataset or table id.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Resolved ABS data structure identifier.'}, 'dimensions': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'Dataset dimensions with positions and allowed values.'}}, 'description': 'ABS SDMX dataset structure with dimensions and codelists.', 'additionalProperties': True}
get_apra_data
Get APRA Data
Expert/source-native APRA public XLSX publication retrieval. Only curated official APRA publication IDs are accepted; arbitrary URLs are not.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['publication_id'], 'properties': {'last_n': {'anyOf': [{'type': 'integer', 'minimum': 1}, {'type': 'null'}], 'default': None, 'description': 'Optional limit returning only the most recent N observations per series; metadata.truncated is true when older observations were dropped.'}, 'end_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'format': 'date', 'default': None, 'description': 'Optional ISO date bound in YYYY-MM-DD format.'}, 'table_id': {'anyOf': [{'type': 'string', 'minLength': 1, 'description': 'Non-empty dataset or table id.'}, {'type': 'null'}], 'default': None, 'description': 'Non-empty dataset or table id.'}, 'series_ids': {'anyOf': [{'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, {'type': 'null'}], 'default': None, 'description': 'Optional list of non-empty source-native series IDs to keep after download.'}, 'start_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'format': 'date', 'default': None, 'description': 'Optional ISO date bound in YYYY-MM-DD format.'}, 'publication_id': {'type': 'string', 'minLength': 1, 'description': 'Non-empty dataset or table id.'}, 'include_observation_dimensions': {'type': 'boolean', 'default': False, 'description': 'Whether to repeat the full dimension dict on every observation. Off by default because the same dimensions already appear on each series descriptor and are encoded in series_id.'}}, 'additionalProperties': False}
Esquema de salida
{'$id': 'https://github.com/AnthonyPuggs/ausecon-mcp-server/schemas/response.schema.json', 'type': 'object', 'title': 'Ausecon Retrieval Response', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['metadata', 'series', 'observations'], 'properties': {'series': {'type': 'array', 'items': {'type': 'object', 'required': ['series_id', 'label', 'dimensions'], 'properties': {'unit': {'type': ['string', 'null']}, 'label': {'type': 'string'}, 'decimals': {'type': ['integer', 'null'], 'description': 'ABS DECIMALS value when supplied by the source.'}, 'frequency': {'type': ['string', 'null']}, 'series_id': {'type': 'string'}, 'dimensions': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'source_key': {'type': ['string', 'null']}, 'base_period': {'type': ['string', 'null'], 'description': 'ABS BASE_PERIOD value when supplied by the source.'}, 'unit_multiplier': {'type': ['integer', 'null'], 'description': 'ABS UNIT_MULT value when supplied by the source.'}}, 'additionalProperties': False}, 'description': 'Series descriptors keyed by series_id.'}, 'metadata': {'type': 'object', 'required': ['source', 'dataset_id', 'server_version', 'truncated'], 'properties': {'stale': {'type': 'boolean'}, 'title': {'type': ['string', 'null']}, 'bundle': {'type': ['string', 'array', 'object', 'null']}, 'source': {'enum': ['abs', 'rba', 'apra', 'derived'], 'type': 'string'}, 'derived': {'type': 'object', 'required': ['concept', 'description', 'formula', 'operands', 'source_concepts', 'alignment_frequency', 'alignment_method', 'units', 'requested_bounds', 'resolved_bounds', 'dropped_observations'], 'properties': {'units': {'type': 'string'}, 'concept': {'type': 'string'}, 'formula': {'type': 'string'}, 'operands': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'concept', 'source', 'dataset_id', 'upstream_id', 'abs_key', 'rba_series_ids', 'series_ids'], 'properties': {'name': {'type': 'string'}, 'source': {'enum': ['abs', 'rba', None], 'type': ['string', 'null']}, 'abs_key': {'type': ['string', 'null']}, 'concept': {'type': 'string'}, 'dataset_id': {'type': ['string', 'null']}, 'series_ids': {'type': 'array', 'items': {'type': 'string'}}, 'upstream_id': {'type': ['string', 'null']}, 'rba_series_ids': {'type': ['array', 'null'], 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'description': {'type': 'string'}, 'resolved_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'source_concepts': {'type': 'array', 'items': {'type': 'string'}}, 'alignment_method': {'enum': ['locf', 'exact_month', 'period_intersection', 'year_ended_lag'], 'type': 'string'}, 'requested_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'alignment_frequency': {'type': 'string'}, 'dropped_observations': {'type': 'object', 'required': ['input', 'derived', 'returned', 'dropped'], 'properties': {'input': {'type': 'integer', 'minimum': 0}, 'derived': {'type': 'integer', 'minimum': 0}, 'dropped': {'type': 'integer', 'minimum': 0}, 'returned': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'description': 'Derived-series provenance when returned by get_derived_series.', 'additionalProperties': False}, 'semantic': {'type': 'object', 'required': ['concept', 'variant', 'geography', 'frequency', 'requested_bounds', 'resolved_bounds', 'target'], 'properties': {'target': {'type': 'object', 'required': ['source', 'dataset_id', 'upstream_id', 'abs_key', 'rba_series_ids'], 'properties': {'source': {'enum': ['abs', 'rba', 'apra'], 'type': 'string'}, 'abs_key': {'type': ['string', 'null']}, 'dataset_id': {'type': 'string'}, 'upstream_id': {'type': 'string'}, 'apra_table_id': {'type': ['string', 'null']}, 'rba_series_ids': {'type': ['array', 'null'], 'items': {'type': 'string'}}, 'apra_series_ids': {'type': ['array', 'null'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'concept': {'type': 'string'}, 'variant': {'type': ['string', 'null']}, 'frequency': {'type': ['string', 'null']}, 'geography': {'type': ['string', 'null']}, 'resolved_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'requested_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'description': 'Semantic concept provenance when returned by get_economic_series.', 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Plain-English source warnings relevant to the payload.'}, 'cached_at': {'type': 'number'}, 'frequency': {'type': ['string', 'null']}, 'selection': {'oneOf': [{'type': 'object', 'required': ['type', 'n', 'direction', 'numeric_observation_count', 'returned_observation_count', 'dropped_non_numeric_count'], 'properties': {'n': {'type': 'integer', 'minimum': 1}, 'type': {'enum': ['top_n'], 'type': 'string'}, 'direction': {'enum': ['highest', 'lowest'], 'type': 'string'}, 'dropped_non_numeric_count': {'type': 'integer', 'minimum': 0}, 'numeric_observation_count': {'type': 'integer', 'minimum': 0}, 'returned_observation_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, {'type': 'object', 'required': ['type', 'n', 'series_count', 'returned_observation_count'], 'properties': {'n': {'type': 'integer', 'minimum': 1}, 'type': {'enum': ['latest'], 'type': 'string'}, 'series_count': {'type': 'integer', 'minimum': 0}, 'returned_observation_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}], 'description': 'Observation-selection provenance when returned by convenience tools.'}, 'truncated': {'type': 'boolean'}, 'dataset_id': {'type': 'string'}, 'expires_at': {'type': 'number'}, 'retrieved_at': {'type': 'string', 'format': 'date-time'}, 'retrieval_url': {'type': 'string'}, 'updated_after': {'type': ['string', 'null']}, 'server_version': {'type': 'string'}, 'framework_breaks': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'label', 'description'], 'properties': {'date': {'type': 'string'}, 'label': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'Known source framework or reporting-definition breaks relevant to the payload.'}, 'publication_date': {'type': ['string', 'null']}, 'apra_url_resolution': {'type': 'object', 'required': ['strategy', 'seed_checked_at'], 'properties': {'strategy': {'enum': ['landing_page', 'seed_manifest', 'catalogue_fallback'], 'type': 'string'}, 'seed_checked_at': {'type': ['string', 'null']}}, 'description': 'APRA workbook URL resolution strategy used for this retrieval.', 'additionalProperties': False}, 'observations_dropped': {'type': 'integer', 'minimum': 0, 'description': 'Number of observations removed by last_n selection; truncated is true when this is non-zero.'}}, 'description': 'Source, provenance, cache, and retrieval metadata for this response.', 'additionalProperties': False}, 'observations': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'series_id', 'value'], 'properties': {'date': {'oneOf': [{'type': 'string', 'format': 'date', 'pattern': '^\\d{4}-(0[1-9]|1[0-2])-[0-3][0-9]$'}, {'type': 'string', 'pattern': '^\\d{4}$'}, {'type': 'string', 'pattern': '^\\d{4}-Q[1-4]$'}, {'type': 'string', 'pattern': '^\\d{4}-(0[1-9]|1[0-2])$'}, {'type': 'string', 'pattern': '^\\d{4}-S[1-2]$'}], 'description': 'Observation date as an ISO date or source-native ABS period.'}, 'value': {'type': ['number', 'null']}, 'status': {'type': ['string', 'null']}, 'comment': {'type': ['string', 'null'], 'description': 'ABS observation comment when supplied by the source.'}, 'raw_value': {'type': ['string', 'null']}, 'series_id': {'type': 'string'}, 'dimensions': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'description': 'Long-form observations keyed by date and series_id.'}}, 'description': 'Normalised retrieval response returned by ABS, RBA, APRA, semantic, and derived data tools.', 'additionalProperties': False}
get_derived_series
Get Derived Series
Read-only retrieval for the narrow transparent derived series layer. Date bounds accept YYYY, YYYY-QN, YYYY-SN, YYYY-MM, or YYYY-MM-DD and are normalised to the derived series frequency.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['concept'], 'properties': {'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional analyst-friendly bound for a derived series: YYYY, YYYY-QN, YYYY-SN, YYYY-MM, or YYYY-MM-DD. Bounds are normalised to the derived series frequency.'}, 'start': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional analyst-friendly bound for a derived series: YYYY, YYYY-QN, YYYY-SN, YYYY-MM, or YYYY-MM-DD. Bounds are normalised to the derived series frequency.'}, 'last_n': {'anyOf': [{'type': 'integer', 'minimum': 1}, {'type': 'null'}], 'default': None, 'description': 'Optional limit returning only the most recent N observations per series; metadata.truncated is true when older observations were dropped.'}, 'concept': {'type': 'string', 'minLength': 1, 'description': 'Derived concept name.'}}, 'additionalProperties': False}
Esquema de salida
{'$id': 'https://github.com/AnthonyPuggs/ausecon-mcp-server/schemas/response.schema.json', 'type': 'object', 'title': 'Ausecon Retrieval Response', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['metadata', 'series', 'observations'], 'properties': {'series': {'type': 'array', 'items': {'type': 'object', 'required': ['series_id', 'label', 'dimensions'], 'properties': {'unit': {'type': ['string', 'null']}, 'label': {'type': 'string'}, 'decimals': {'type': ['integer', 'null'], 'description': 'ABS DECIMALS value when supplied by the source.'}, 'frequency': {'type': ['string', 'null']}, 'series_id': {'type': 'string'}, 'dimensions': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'source_key': {'type': ['string', 'null']}, 'base_period': {'type': ['string', 'null'], 'description': 'ABS BASE_PERIOD value when supplied by the source.'}, 'unit_multiplier': {'type': ['integer', 'null'], 'description': 'ABS UNIT_MULT value when supplied by the source.'}}, 'additionalProperties': False}, 'description': 'Series descriptors keyed by series_id.'}, 'metadata': {'type': 'object', 'required': ['source', 'dataset_id', 'server_version', 'truncated'], 'properties': {'stale': {'type': 'boolean'}, 'title': {'type': ['string', 'null']}, 'bundle': {'type': ['string', 'array', 'object', 'null']}, 'source': {'enum': ['abs', 'rba', 'apra', 'derived'], 'type': 'string'}, 'derived': {'type': 'object', 'required': ['concept', 'description', 'formula', 'operands', 'source_concepts', 'alignment_frequency', 'alignment_method', 'units', 'requested_bounds', 'resolved_bounds', 'dropped_observations'], 'properties': {'units': {'type': 'string'}, 'concept': {'type': 'string'}, 'formula': {'type': 'string'}, 'operands': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'concept', 'source', 'dataset_id', 'upstream_id', 'abs_key', 'rba_series_ids', 'series_ids'], 'properties': {'name': {'type': 'string'}, 'source': {'enum': ['abs', 'rba', None], 'type': ['string', 'null']}, 'abs_key': {'type': ['string', 'null']}, 'concept': {'type': 'string'}, 'dataset_id': {'type': ['string', 'null']}, 'series_ids': {'type': 'array', 'items': {'type': 'string'}}, 'upstream_id': {'type': ['string', 'null']}, 'rba_series_ids': {'type': ['array', 'null'], 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'description': {'type': 'string'}, 'resolved_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'source_concepts': {'type': 'array', 'items': {'type': 'string'}}, 'alignment_method': {'enum': ['locf', 'exact_month', 'period_intersection', 'year_ended_lag'], 'type': 'string'}, 'requested_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'alignment_frequency': {'type': 'string'}, 'dropped_observations': {'type': 'object', 'required': ['input', 'derived', 'returned', 'dropped'], 'properties': {'input': {'type': 'integer', 'minimum': 0}, 'derived': {'type': 'integer', 'minimum': 0}, 'dropped': {'type': 'integer', 'minimum': 0}, 'returned': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'description': 'Derived-series provenance when returned by get_derived_series.', 'additionalProperties': False}, 'semantic': {'type': 'object', 'required': ['concept', 'variant', 'geography', 'frequency', 'requested_bounds', 'resolved_bounds', 'target'], 'properties': {'target': {'type': 'object', 'required': ['source', 'dataset_id', 'upstream_id', 'abs_key', 'rba_series_ids'], 'properties': {'source': {'enum': ['abs', 'rba', 'apra'], 'type': 'string'}, 'abs_key': {'type': ['string', 'null']}, 'dataset_id': {'type': 'string'}, 'upstream_id': {'type': 'string'}, 'apra_table_id': {'type': ['string', 'null']}, 'rba_series_ids': {'type': ['array', 'null'], 'items': {'type': 'string'}}, 'apra_series_ids': {'type': ['array', 'null'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'concept': {'type': 'string'}, 'variant': {'type': ['string', 'null']}, 'frequency': {'type': ['string', 'null']}, 'geography': {'type': ['string', 'null']}, 'resolved_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'requested_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'description': 'Semantic concept provenance when returned by get_economic_series.', 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Plain-English source warnings relevant to the payload.'}, 'cached_at': {'type': 'number'}, 'frequency': {'type': ['string', 'null']}, 'selection': {'oneOf': [{'type': 'object', 'required': ['type', 'n', 'direction', 'numeric_observation_count', 'returned_observation_count', 'dropped_non_numeric_count'], 'properties': {'n': {'type': 'integer', 'minimum': 1}, 'type': {'enum': ['top_n'], 'type': 'string'}, 'direction': {'enum': ['highest', 'lowest'], 'type': 'string'}, 'dropped_non_numeric_count': {'type': 'integer', 'minimum': 0}, 'numeric_observation_count': {'type': 'integer', 'minimum': 0}, 'returned_observation_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, {'type': 'object', 'required': ['type', 'n', 'series_count', 'returned_observation_count'], 'properties': {'n': {'type': 'integer', 'minimum': 1}, 'type': {'enum': ['latest'], 'type': 'string'}, 'series_count': {'type': 'integer', 'minimum': 0}, 'returned_observation_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}], 'description': 'Observation-selection provenance when returned by convenience tools.'}, 'truncated': {'type': 'boolean'}, 'dataset_id': {'type': 'string'}, 'expires_at': {'type': 'number'}, 'retrieved_at': {'type': 'string', 'format': 'date-time'}, 'retrieval_url': {'type': 'string'}, 'updated_after': {'type': ['string', 'null']}, 'server_version': {'type': 'string'}, 'framework_breaks': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'label', 'description'], 'properties': {'date': {'type': 'string'}, 'label': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'Known source framework or reporting-definition breaks relevant to the payload.'}, 'publication_date': {'type': ['string', 'null']}, 'apra_url_resolution': {'type': 'object', 'required': ['strategy', 'seed_checked_at'], 'properties': {'strategy': {'enum': ['landing_page', 'seed_manifest', 'catalogue_fallback'], 'type': 'string'}, 'seed_checked_at': {'type': ['string', 'null']}}, 'description': 'APRA workbook URL resolution strategy used for this retrieval.', 'additionalProperties': False}, 'observations_dropped': {'type': 'integer', 'minimum': 0, 'description': 'Number of observations removed by last_n selection; truncated is true when this is non-zero.'}}, 'description': 'Source, provenance, cache, and retrieval metadata for this response.', 'additionalProperties': False}, 'observations': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'series_id', 'value'], 'properties': {'date': {'oneOf': [{'type': 'string', 'format': 'date', 'pattern': '^\\d{4}-(0[1-9]|1[0-2])-[0-3][0-9]$'}, {'type': 'string', 'pattern': '^\\d{4}$'}, {'type': 'string', 'pattern': '^\\d{4}-Q[1-4]$'}, {'type': 'string', 'pattern': '^\\d{4}-(0[1-9]|1[0-2])$'}, {'type': 'string', 'pattern': '^\\d{4}-S[1-2]$'}], 'description': 'Observation date as an ISO date or source-native ABS period.'}, 'value': {'type': ['number', 'null']}, 'status': {'type': ['string', 'null']}, 'comment': {'type': ['string', 'null'], 'description': 'ABS observation comment when supplied by the source.'}, 'raw_value': {'type': ['string', 'null']}, 'series_id': {'type': 'string'}, 'dimensions': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'description': 'Long-form observations keyed by date and series_id.'}}, 'description': 'Normalised retrieval response returned by ABS, RBA, APRA, semantic, and derived data tools.', 'additionalProperties': False}
get_economic_series
Get Economic Series
Preferred analyst-facing retrieval tool for curated ABS/RBA economic concepts. Use list_economic_concepts for discovery. Date bounds accept YYYY, YYYY-QN, YYYY-SN, YYYY-MM, or YYYY-MM-DD and are normalised to the resolved source.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['concept'], 'properties': {'end': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional analyst-friendly date bound: YYYY, YYYY-QN, YYYY-SN, YYYY-MM, or YYYY-MM-DD. Semantic retrieval normalises this to the resolved source frequency.'}, 'start': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional analyst-friendly date bound: YYYY, YYYY-QN, YYYY-SN, YYYY-MM, or YYYY-MM-DD. Semantic retrieval normalises this to the resolved source frequency.'}, 'last_n': {'anyOf': [{'type': 'integer', 'minimum': 1}, {'type': 'null'}], 'default': None, 'description': 'Optional limit returning only the most recent N observations per series; metadata.truncated is true when older observations were dropped.'}, 'concept': {'type': 'string', 'minLength': 1, 'description': 'Curated semantic concept name.'}, 'variant': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional curated concept variant, such as headline, underlying, or target.'}, 'frequency': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional requested frequency for a curated concept, such as monthly, quarterly, or annual.'}, 'geography': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional geography selector for a curated concept, usually aus for Australia.'}, 'include_observation_dimensions': {'type': 'boolean', 'default': False, 'description': 'Whether to repeat the full dimension dict on every observation. Off by default because the same dimensions already appear on each series descriptor and are encoded in series_id.'}}, 'additionalProperties': False}
Esquema de salida
{'$id': 'https://github.com/AnthonyPuggs/ausecon-mcp-server/schemas/response.schema.json', 'type': 'object', 'title': 'Ausecon Retrieval Response', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['metadata', 'series', 'observations'], 'properties': {'series': {'type': 'array', 'items': {'type': 'object', 'required': ['series_id', 'label', 'dimensions'], 'properties': {'unit': {'type': ['string', 'null']}, 'label': {'type': 'string'}, 'decimals': {'type': ['integer', 'null'], 'description': 'ABS DECIMALS value when supplied by the source.'}, 'frequency': {'type': ['string', 'null']}, 'series_id': {'type': 'string'}, 'dimensions': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'source_key': {'type': ['string', 'null']}, 'base_period': {'type': ['string', 'null'], 'description': 'ABS BASE_PERIOD value when supplied by the source.'}, 'unit_multiplier': {'type': ['integer', 'null'], 'description': 'ABS UNIT_MULT value when supplied by the source.'}}, 'additionalProperties': False}, 'description': 'Series descriptors keyed by series_id.'}, 'metadata': {'type': 'object', 'required': ['source', 'dataset_id', 'server_version', 'truncated'], 'properties': {'stale': {'type': 'boolean'}, 'title': {'type': ['string', 'null']}, 'bundle': {'type': ['string', 'array', 'object', 'null']}, 'source': {'enum': ['abs', 'rba', 'apra', 'derived'], 'type': 'string'}, 'derived': {'type': 'object', 'required': ['concept', 'description', 'formula', 'operands', 'source_concepts', 'alignment_frequency', 'alignment_method', 'units', 'requested_bounds', 'resolved_bounds', 'dropped_observations'], 'properties': {'units': {'type': 'string'}, 'concept': {'type': 'string'}, 'formula': {'type': 'string'}, 'operands': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'concept', 'source', 'dataset_id', 'upstream_id', 'abs_key', 'rba_series_ids', 'series_ids'], 'properties': {'name': {'type': 'string'}, 'source': {'enum': ['abs', 'rba', None], 'type': ['string', 'null']}, 'abs_key': {'type': ['string', 'null']}, 'concept': {'type': 'string'}, 'dataset_id': {'type': ['string', 'null']}, 'series_ids': {'type': 'array', 'items': {'type': 'string'}}, 'upstream_id': {'type': ['string', 'null']}, 'rba_series_ids': {'type': ['array', 'null'], 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'description': {'type': 'string'}, 'resolved_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'source_concepts': {'type': 'array', 'items': {'type': 'string'}}, 'alignment_method': {'enum': ['locf', 'exact_month', 'period_intersection', 'year_ended_lag'], 'type': 'string'}, 'requested_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'alignment_frequency': {'type': 'string'}, 'dropped_observations': {'type': 'object', 'required': ['input', 'derived', 'returned', 'dropped'], 'properties': {'input': {'type': 'integer', 'minimum': 0}, 'derived': {'type': 'integer', 'minimum': 0}, 'dropped': {'type': 'integer', 'minimum': 0}, 'returned': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'description': 'Derived-series provenance when returned by get_derived_series.', 'additionalProperties': False}, 'semantic': {'type': 'object', 'required': ['concept', 'variant', 'geography', 'frequency', 'requested_bounds', 'resolved_bounds', 'target'], 'properties': {'target': {'type': 'object', 'required': ['source', 'dataset_id', 'upstream_id', 'abs_key', 'rba_series_ids'], 'properties': {'source': {'enum': ['abs', 'rba', 'apra'], 'type': 'string'}, 'abs_key': {'type': ['string', 'null']}, 'dataset_id': {'type': 'string'}, 'upstream_id': {'type': 'string'}, 'apra_table_id': {'type': ['string', 'null']}, 'rba_series_ids': {'type': ['array', 'null'], 'items': {'type': 'string'}}, 'apra_series_ids': {'type': ['array', 'null'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'concept': {'type': 'string'}, 'variant': {'type': ['string', 'null']}, 'frequency': {'type': ['string', 'null']}, 'geography': {'type': ['string', 'null']}, 'resolved_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'requested_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'description': 'Semantic concept provenance when returned by get_economic_series.', 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Plain-English source warnings relevant to the payload.'}, 'cached_at': {'type': 'number'}, 'frequency': {'type': ['string', 'null']}, 'selection': {'oneOf': [{'type': 'object', 'required': ['type', 'n', 'direction', 'numeric_observation_count', 'returned_observation_count', 'dropped_non_numeric_count'], 'properties': {'n': {'type': 'integer', 'minimum': 1}, 'type': {'enum': ['top_n'], 'type': 'string'}, 'direction': {'enum': ['highest', 'lowest'], 'type': 'string'}, 'dropped_non_numeric_count': {'type': 'integer', 'minimum': 0}, 'numeric_observation_count': {'type': 'integer', 'minimum': 0}, 'returned_observation_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, {'type': 'object', 'required': ['type', 'n', 'series_count', 'returned_observation_count'], 'properties': {'n': {'type': 'integer', 'minimum': 1}, 'type': {'enum': ['latest'], 'type': 'string'}, 'series_count': {'type': 'integer', 'minimum': 0}, 'returned_observation_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}], 'description': 'Observation-selection provenance when returned by convenience tools.'}, 'truncated': {'type': 'boolean'}, 'dataset_id': {'type': 'string'}, 'expires_at': {'type': 'number'}, 'retrieved_at': {'type': 'string', 'format': 'date-time'}, 'retrieval_url': {'type': 'string'}, 'updated_after': {'type': ['string', 'null']}, 'server_version': {'type': 'string'}, 'framework_breaks': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'label', 'description'], 'properties': {'date': {'type': 'string'}, 'label': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'Known source framework or reporting-definition breaks relevant to the payload.'}, 'publication_date': {'type': ['string', 'null']}, 'apra_url_resolution': {'type': 'object', 'required': ['strategy', 'seed_checked_at'], 'properties': {'strategy': {'enum': ['landing_page', 'seed_manifest', 'catalogue_fallback'], 'type': 'string'}, 'seed_checked_at': {'type': ['string', 'null']}}, 'description': 'APRA workbook URL resolution strategy used for this retrieval.', 'additionalProperties': False}, 'observations_dropped': {'type': 'integer', 'minimum': 0, 'description': 'Number of observations removed by last_n selection; truncated is true when this is non-zero.'}}, 'description': 'Source, provenance, cache, and retrieval metadata for this response.', 'additionalProperties': False}, 'observations': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'series_id', 'value'], 'properties': {'date': {'oneOf': [{'type': 'string', 'format': 'date', 'pattern': '^\\d{4}-(0[1-9]|1[0-2])-[0-3][0-9]$'}, {'type': 'string', 'pattern': '^\\d{4}$'}, {'type': 'string', 'pattern': '^\\d{4}-Q[1-4]$'}, {'type': 'string', 'pattern': '^\\d{4}-(0[1-9]|1[0-2])$'}, {'type': 'string', 'pattern': '^\\d{4}-S[1-2]$'}], 'description': 'Observation date as an ISO date or source-native ABS period.'}, 'value': {'type': ['number', 'null']}, 'status': {'type': ['string', 'null']}, 'comment': {'type': ['string', 'null'], 'description': 'ABS observation comment when supplied by the source.'}, 'raw_value': {'type': ['string', 'null']}, 'series_id': {'type': 'string'}, 'dimensions': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'description': 'Long-form observations keyed by date and series_id.'}}, 'description': 'Normalised retrieval response returned by ABS, RBA, APRA, semantic, and derived data tools.', 'additionalProperties': False}
get_latest_observations
Get Latest Observations
Source-aware convenience wrapper for the latest observations. For a single curated indicator prefer get_economic_series(concept=...), which resolves one series; pass series_ids=[...] to narrow a broad dataset instead of returning every series it contains.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['source', 'identifier'], 'properties': {'key': {'type': 'string', 'default': 'all', 'minLength': 1, 'description': 'ABS SDMX key, or "all" for all series.'}, 'count': {'type': 'integer', 'default': 1, 'minimum': 1, 'description': 'Number of most recent observations to return per series; metadata.truncated is true when older observations were dropped.'}, 'source': {'enum': ['abs', 'rba', 'apra'], 'type': 'string', 'description': 'Source selector. Use abs for Australian Bureau of Statistics, rba for Reserve Bank of Australia, or apra for Australian Prudential Regulation Authority.'}, 'table_id': {'anyOf': [{'type': 'string', 'minLength': 1, 'description': 'Non-empty dataset or table id.'}, {'type': 'null'}], 'default': None, 'description': 'Non-empty dataset or table id.'}, 'identifier': {'type': 'string', 'minLength': 1, 'description': 'Non-empty dataset or table id.'}, 'series_ids': {'anyOf': [{'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, {'type': 'null'}], 'default': None, 'description': 'Optional list of non-empty source-native series IDs to keep after download.'}}, 'additionalProperties': False}
Esquema de salida
{'$id': 'https://github.com/AnthonyPuggs/ausecon-mcp-server/schemas/response.schema.json', 'type': 'object', 'title': 'Ausecon Retrieval Response', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['metadata', 'series', 'observations'], 'properties': {'series': {'type': 'array', 'items': {'type': 'object', 'required': ['series_id', 'label', 'dimensions'], 'properties': {'unit': {'type': ['string', 'null']}, 'label': {'type': 'string'}, 'decimals': {'type': ['integer', 'null'], 'description': 'ABS DECIMALS value when supplied by the source.'}, 'frequency': {'type': ['string', 'null']}, 'series_id': {'type': 'string'}, 'dimensions': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'source_key': {'type': ['string', 'null']}, 'base_period': {'type': ['string', 'null'], 'description': 'ABS BASE_PERIOD value when supplied by the source.'}, 'unit_multiplier': {'type': ['integer', 'null'], 'description': 'ABS UNIT_MULT value when supplied by the source.'}}, 'additionalProperties': False}, 'description': 'Series descriptors keyed by series_id.'}, 'metadata': {'type': 'object', 'required': ['source', 'dataset_id', 'server_version', 'truncated'], 'properties': {'stale': {'type': 'boolean'}, 'title': {'type': ['string', 'null']}, 'bundle': {'type': ['string', 'array', 'object', 'null']}, 'source': {'enum': ['abs', 'rba', 'apra', 'derived'], 'type': 'string'}, 'derived': {'type': 'object', 'required': ['concept', 'description', 'formula', 'operands', 'source_concepts', 'alignment_frequency', 'alignment_method', 'units', 'requested_bounds', 'resolved_bounds', 'dropped_observations'], 'properties': {'units': {'type': 'string'}, 'concept': {'type': 'string'}, 'formula': {'type': 'string'}, 'operands': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'concept', 'source', 'dataset_id', 'upstream_id', 'abs_key', 'rba_series_ids', 'series_ids'], 'properties': {'name': {'type': 'string'}, 'source': {'enum': ['abs', 'rba', None], 'type': ['string', 'null']}, 'abs_key': {'type': ['string', 'null']}, 'concept': {'type': 'string'}, 'dataset_id': {'type': ['string', 'null']}, 'series_ids': {'type': 'array', 'items': {'type': 'string'}}, 'upstream_id': {'type': ['string', 'null']}, 'rba_series_ids': {'type': ['array', 'null'], 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'description': {'type': 'string'}, 'resolved_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'source_concepts': {'type': 'array', 'items': {'type': 'string'}}, 'alignment_method': {'enum': ['locf', 'exact_month', 'period_intersection', 'year_ended_lag'], 'type': 'string'}, 'requested_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'alignment_frequency': {'type': 'string'}, 'dropped_observations': {'type': 'object', 'required': ['input', 'derived', 'returned', 'dropped'], 'properties': {'input': {'type': 'integer', 'minimum': 0}, 'derived': {'type': 'integer', 'minimum': 0}, 'dropped': {'type': 'integer', 'minimum': 0}, 'returned': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'description': 'Derived-series provenance when returned by get_derived_series.', 'additionalProperties': False}, 'semantic': {'type': 'object', 'required': ['concept', 'variant', 'geography', 'frequency', 'requested_bounds', 'resolved_bounds', 'target'], 'properties': {'target': {'type': 'object', 'required': ['source', 'dataset_id', 'upstream_id', 'abs_key', 'rba_series_ids'], 'properties': {'source': {'enum': ['abs', 'rba', 'apra'], 'type': 'string'}, 'abs_key': {'type': ['string', 'null']}, 'dataset_id': {'type': 'string'}, 'upstream_id': {'type': 'string'}, 'apra_table_id': {'type': ['string', 'null']}, 'rba_series_ids': {'type': ['array', 'null'], 'items': {'type': 'string'}}, 'apra_series_ids': {'type': ['array', 'null'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'concept': {'type': 'string'}, 'variant': {'type': ['string', 'null']}, 'frequency': {'type': ['string', 'null']}, 'geography': {'type': ['string', 'null']}, 'resolved_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'requested_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'description': 'Semantic concept provenance when returned by get_economic_series.', 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Plain-English source warnings relevant to the payload.'}, 'cached_at': {'type': 'number'}, 'frequency': {'type': ['string', 'null']}, 'selection': {'oneOf': [{'type': 'object', 'required': ['type', 'n', 'direction', 'numeric_observation_count', 'returned_observation_count', 'dropped_non_numeric_count'], 'properties': {'n': {'type': 'integer', 'minimum': 1}, 'type': {'enum': ['top_n'], 'type': 'string'}, 'direction': {'enum': ['highest', 'lowest'], 'type': 'string'}, 'dropped_non_numeric_count': {'type': 'integer', 'minimum': 0}, 'numeric_observation_count': {'type': 'integer', 'minimum': 0}, 'returned_observation_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, {'type': 'object', 'required': ['type', 'n', 'series_count', 'returned_observation_count'], 'properties': {'n': {'type': 'integer', 'minimum': 1}, 'type': {'enum': ['latest'], 'type': 'string'}, 'series_count': {'type': 'integer', 'minimum': 0}, 'returned_observation_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}], 'description': 'Observation-selection provenance when returned by convenience tools.'}, 'truncated': {'type': 'boolean'}, 'dataset_id': {'type': 'string'}, 'expires_at': {'type': 'number'}, 'retrieved_at': {'type': 'string', 'format': 'date-time'}, 'retrieval_url': {'type': 'string'}, 'updated_after': {'type': ['string', 'null']}, 'server_version': {'type': 'string'}, 'framework_breaks': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'label', 'description'], 'properties': {'date': {'type': 'string'}, 'label': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'Known source framework or reporting-definition breaks relevant to the payload.'}, 'publication_date': {'type': ['string', 'null']}, 'apra_url_resolution': {'type': 'object', 'required': ['strategy', 'seed_checked_at'], 'properties': {'strategy': {'enum': ['landing_page', 'seed_manifest', 'catalogue_fallback'], 'type': 'string'}, 'seed_checked_at': {'type': ['string', 'null']}}, 'description': 'APRA workbook URL resolution strategy used for this retrieval.', 'additionalProperties': False}, 'observations_dropped': {'type': 'integer', 'minimum': 0, 'description': 'Number of observations removed by last_n selection; truncated is true when this is non-zero.'}}, 'description': 'Source, provenance, cache, and retrieval metadata for this response.', 'additionalProperties': False}, 'observations': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'series_id', 'value'], 'properties': {'date': {'oneOf': [{'type': 'string', 'format': 'date', 'pattern': '^\\d{4}-(0[1-9]|1[0-2])-[0-3][0-9]$'}, {'type': 'string', 'pattern': '^\\d{4}$'}, {'type': 'string', 'pattern': '^\\d{4}-Q[1-4]$'}, {'type': 'string', 'pattern': '^\\d{4}-(0[1-9]|1[0-2])$'}, {'type': 'string', 'pattern': '^\\d{4}-S[1-2]$'}], 'description': 'Observation date as an ISO date or source-native ABS period.'}, 'value': {'type': ['number', 'null']}, 'status': {'type': ['string', 'null']}, 'comment': {'type': ['string', 'null'], 'description': 'ABS observation comment when supplied by the source.'}, 'raw_value': {'type': ['string', 'null']}, 'series_id': {'type': 'string'}, 'dimensions': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'description': 'Long-form observations keyed by date and series_id.'}}, 'description': 'Normalised retrieval response returned by ABS, RBA, APRA, semantic, and derived data tools.', 'additionalProperties': False}
get_rba_table
Get RBA Table
Expert/source-native RBA statistical table retrieval in a normalised response shape.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['table_id'], 'properties': {'last_n': {'anyOf': [{'type': 'integer', 'minimum': 1}, {'type': 'null'}], 'default': None, 'description': 'Optional limit returning only the most recent N observations per series; metadata.truncated is true when older observations were dropped.'}, 'end_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'format': 'date', 'default': None, 'description': 'Optional ISO date bound in YYYY-MM-DD format.'}, 'table_id': {'type': 'string', 'minLength': 1, 'description': 'Non-empty dataset or table id.'}, 'series_ids': {'anyOf': [{'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, {'type': 'null'}], 'default': None, 'description': 'Optional list of non-empty source-native series IDs to keep after download.'}, 'start_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'format': 'date', 'default': None, 'description': 'Optional ISO date bound in YYYY-MM-DD format.'}, 'include_observation_dimensions': {'type': 'boolean', 'default': False, 'description': 'Whether to repeat the full dimension dict on every observation. Off by default because the same dimensions already appear on each series descriptor and are encoded in series_id.'}}, 'additionalProperties': False}
Esquema de salida
{'$id': 'https://github.com/AnthonyPuggs/ausecon-mcp-server/schemas/response.schema.json', 'type': 'object', 'title': 'Ausecon Retrieval Response', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['metadata', 'series', 'observations'], 'properties': {'series': {'type': 'array', 'items': {'type': 'object', 'required': ['series_id', 'label', 'dimensions'], 'properties': {'unit': {'type': ['string', 'null']}, 'label': {'type': 'string'}, 'decimals': {'type': ['integer', 'null'], 'description': 'ABS DECIMALS value when supplied by the source.'}, 'frequency': {'type': ['string', 'null']}, 'series_id': {'type': 'string'}, 'dimensions': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'source_key': {'type': ['string', 'null']}, 'base_period': {'type': ['string', 'null'], 'description': 'ABS BASE_PERIOD value when supplied by the source.'}, 'unit_multiplier': {'type': ['integer', 'null'], 'description': 'ABS UNIT_MULT value when supplied by the source.'}}, 'additionalProperties': False}, 'description': 'Series descriptors keyed by series_id.'}, 'metadata': {'type': 'object', 'required': ['source', 'dataset_id', 'server_version', 'truncated'], 'properties': {'stale': {'type': 'boolean'}, 'title': {'type': ['string', 'null']}, 'bundle': {'type': ['string', 'array', 'object', 'null']}, 'source': {'enum': ['abs', 'rba', 'apra', 'derived'], 'type': 'string'}, 'derived': {'type': 'object', 'required': ['concept', 'description', 'formula', 'operands', 'source_concepts', 'alignment_frequency', 'alignment_method', 'units', 'requested_bounds', 'resolved_bounds', 'dropped_observations'], 'properties': {'units': {'type': 'string'}, 'concept': {'type': 'string'}, 'formula': {'type': 'string'}, 'operands': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'concept', 'source', 'dataset_id', 'upstream_id', 'abs_key', 'rba_series_ids', 'series_ids'], 'properties': {'name': {'type': 'string'}, 'source': {'enum': ['abs', 'rba', None], 'type': ['string', 'null']}, 'abs_key': {'type': ['string', 'null']}, 'concept': {'type': 'string'}, 'dataset_id': {'type': ['string', 'null']}, 'series_ids': {'type': 'array', 'items': {'type': 'string'}}, 'upstream_id': {'type': ['string', 'null']}, 'rba_series_ids': {'type': ['array', 'null'], 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'description': {'type': 'string'}, 'resolved_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'source_concepts': {'type': 'array', 'items': {'type': 'string'}}, 'alignment_method': {'enum': ['locf', 'exact_month', 'period_intersection', 'year_ended_lag'], 'type': 'string'}, 'requested_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'alignment_frequency': {'type': 'string'}, 'dropped_observations': {'type': 'object', 'required': ['input', 'derived', 'returned', 'dropped'], 'properties': {'input': {'type': 'integer', 'minimum': 0}, 'derived': {'type': 'integer', 'minimum': 0}, 'dropped': {'type': 'integer', 'minimum': 0}, 'returned': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'description': 'Derived-series provenance when returned by get_derived_series.', 'additionalProperties': False}, 'semantic': {'type': 'object', 'required': ['concept', 'variant', 'geography', 'frequency', 'requested_bounds', 'resolved_bounds', 'target'], 'properties': {'target': {'type': 'object', 'required': ['source', 'dataset_id', 'upstream_id', 'abs_key', 'rba_series_ids'], 'properties': {'source': {'enum': ['abs', 'rba', 'apra'], 'type': 'string'}, 'abs_key': {'type': ['string', 'null']}, 'dataset_id': {'type': 'string'}, 'upstream_id': {'type': 'string'}, 'apra_table_id': {'type': ['string', 'null']}, 'rba_series_ids': {'type': ['array', 'null'], 'items': {'type': 'string'}}, 'apra_series_ids': {'type': ['array', 'null'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'concept': {'type': 'string'}, 'variant': {'type': ['string', 'null']}, 'frequency': {'type': ['string', 'null']}, 'geography': {'type': ['string', 'null']}, 'resolved_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'requested_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'description': 'Semantic concept provenance when returned by get_economic_series.', 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Plain-English source warnings relevant to the payload.'}, 'cached_at': {'type': 'number'}, 'frequency': {'type': ['string', 'null']}, 'selection': {'oneOf': [{'type': 'object', 'required': ['type', 'n', 'direction', 'numeric_observation_count', 'returned_observation_count', 'dropped_non_numeric_count'], 'properties': {'n': {'type': 'integer', 'minimum': 1}, 'type': {'enum': ['top_n'], 'type': 'string'}, 'direction': {'enum': ['highest', 'lowest'], 'type': 'string'}, 'dropped_non_numeric_count': {'type': 'integer', 'minimum': 0}, 'numeric_observation_count': {'type': 'integer', 'minimum': 0}, 'returned_observation_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, {'type': 'object', 'required': ['type', 'n', 'series_count', 'returned_observation_count'], 'properties': {'n': {'type': 'integer', 'minimum': 1}, 'type': {'enum': ['latest'], 'type': 'string'}, 'series_count': {'type': 'integer', 'minimum': 0}, 'returned_observation_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}], 'description': 'Observation-selection provenance when returned by convenience tools.'}, 'truncated': {'type': 'boolean'}, 'dataset_id': {'type': 'string'}, 'expires_at': {'type': 'number'}, 'retrieved_at': {'type': 'string', 'format': 'date-time'}, 'retrieval_url': {'type': 'string'}, 'updated_after': {'type': ['string', 'null']}, 'server_version': {'type': 'string'}, 'framework_breaks': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'label', 'description'], 'properties': {'date': {'type': 'string'}, 'label': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'Known source framework or reporting-definition breaks relevant to the payload.'}, 'publication_date': {'type': ['string', 'null']}, 'apra_url_resolution': {'type': 'object', 'required': ['strategy', 'seed_checked_at'], 'properties': {'strategy': {'enum': ['landing_page', 'seed_manifest', 'catalogue_fallback'], 'type': 'string'}, 'seed_checked_at': {'type': ['string', 'null']}}, 'description': 'APRA workbook URL resolution strategy used for this retrieval.', 'additionalProperties': False}, 'observations_dropped': {'type': 'integer', 'minimum': 0, 'description': 'Number of observations removed by last_n selection; truncated is true when this is non-zero.'}}, 'description': 'Source, provenance, cache, and retrieval metadata for this response.', 'additionalProperties': False}, 'observations': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'series_id', 'value'], 'properties': {'date': {'oneOf': [{'type': 'string', 'format': 'date', 'pattern': '^\\d{4}-(0[1-9]|1[0-2])-[0-3][0-9]$'}, {'type': 'string', 'pattern': '^\\d{4}$'}, {'type': 'string', 'pattern': '^\\d{4}-Q[1-4]$'}, {'type': 'string', 'pattern': '^\\d{4}-(0[1-9]|1[0-2])$'}, {'type': 'string', 'pattern': '^\\d{4}-S[1-2]$'}], 'description': 'Observation date as an ISO date or source-native ABS period.'}, 'value': {'type': ['number', 'null']}, 'status': {'type': ['string', 'null']}, 'comment': {'type': ['string', 'null'], 'description': 'ABS observation comment when supplied by the source.'}, 'raw_value': {'type': ['string', 'null']}, 'series_id': {'type': 'string'}, 'dimensions': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'description': 'Long-form observations keyed by date and series_id.'}}, 'description': 'Normalised retrieval response returned by ABS, RBA, APRA, semantic, and derived data tools.', 'additionalProperties': False}
get_top_observations
Get Top Observations
Source-aware convenience wrapper for highest or lowest numeric observations. For a single curated indicator prefer get_economic_series(concept=...), which resolves one series; pass series_ids=[...] to narrow a broad dataset instead of returning every series it contains.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['source', 'identifier'], 'properties': {'n': {'type': 'integer', 'default': 10, 'minimum': 1, 'description': 'Positive observation count.'}, 'key': {'type': 'string', 'default': 'all', 'minLength': 1, 'description': 'ABS SDMX key, or "all" for all series.'}, 'source': {'enum': ['abs', 'rba', 'apra'], 'type': 'string', 'description': 'Source selector. Use abs for Australian Bureau of Statistics, rba for Reserve Bank of Australia, or apra for Australian Prudential Regulation Authority.'}, 'end_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'format': 'date', 'default': None, 'description': 'Optional ISO date bound in YYYY-MM-DD format.'}, 'table_id': {'anyOf': [{'type': 'string', 'minLength': 1, 'description': 'Non-empty dataset or table id.'}, {'type': 'null'}], 'default': None, 'description': 'Non-empty dataset or table id.'}, 'direction': {'enum': ['highest', 'lowest'], 'type': 'string', 'default': 'highest', 'description': 'Whether to return the highest or lowest numeric observations.'}, 'end_period': {'anyOf': [{'type': 'string', 'pattern': '^(\\d{4}|\\d{4}-Q[1-4]|\\d{4}-(0[1-9]|1[0-2])|\\d{4}-S[1-2])$'}, {'type': 'null'}], 'default': None, 'description': 'Optional ABS period bound in YYYY, YYYY-QN, YYYY-MM, or YYYY-SN format.'}, 'identifier': {'type': 'string', 'minLength': 1, 'description': 'Non-empty dataset or table id.'}, 'series_ids': {'anyOf': [{'type': 'array', 'items': {'type': 'string', 'minLength': 1}}, {'type': 'null'}], 'default': None, 'description': 'Optional list of non-empty source-native series IDs to keep after download.'}, 'start_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'format': 'date', 'default': None, 'description': 'Optional ISO date bound in YYYY-MM-DD format.'}, 'start_period': {'anyOf': [{'type': 'string', 'pattern': '^(\\d{4}|\\d{4}-Q[1-4]|\\d{4}-(0[1-9]|1[0-2])|\\d{4}-S[1-2])$'}, {'type': 'null'}], 'default': None, 'description': 'Optional ABS period bound in YYYY, YYYY-QN, YYYY-MM, or YYYY-SN format.'}}, 'additionalProperties': False}
Esquema de salida
{'$id': 'https://github.com/AnthonyPuggs/ausecon-mcp-server/schemas/response.schema.json', 'type': 'object', 'title': 'Ausecon Retrieval Response', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['metadata', 'series', 'observations'], 'properties': {'series': {'type': 'array', 'items': {'type': 'object', 'required': ['series_id', 'label', 'dimensions'], 'properties': {'unit': {'type': ['string', 'null']}, 'label': {'type': 'string'}, 'decimals': {'type': ['integer', 'null'], 'description': 'ABS DECIMALS value when supplied by the source.'}, 'frequency': {'type': ['string', 'null']}, 'series_id': {'type': 'string'}, 'dimensions': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}, 'source_key': {'type': ['string', 'null']}, 'base_period': {'type': ['string', 'null'], 'description': 'ABS BASE_PERIOD value when supplied by the source.'}, 'unit_multiplier': {'type': ['integer', 'null'], 'description': 'ABS UNIT_MULT value when supplied by the source.'}}, 'additionalProperties': False}, 'description': 'Series descriptors keyed by series_id.'}, 'metadata': {'type': 'object', 'required': ['source', 'dataset_id', 'server_version', 'truncated'], 'properties': {'stale': {'type': 'boolean'}, 'title': {'type': ['string', 'null']}, 'bundle': {'type': ['string', 'array', 'object', 'null']}, 'source': {'enum': ['abs', 'rba', 'apra', 'derived'], 'type': 'string'}, 'derived': {'type': 'object', 'required': ['concept', 'description', 'formula', 'operands', 'source_concepts', 'alignment_frequency', 'alignment_method', 'units', 'requested_bounds', 'resolved_bounds', 'dropped_observations'], 'properties': {'units': {'type': 'string'}, 'concept': {'type': 'string'}, 'formula': {'type': 'string'}, 'operands': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'concept', 'source', 'dataset_id', 'upstream_id', 'abs_key', 'rba_series_ids', 'series_ids'], 'properties': {'name': {'type': 'string'}, 'source': {'enum': ['abs', 'rba', None], 'type': ['string', 'null']}, 'abs_key': {'type': ['string', 'null']}, 'concept': {'type': 'string'}, 'dataset_id': {'type': ['string', 'null']}, 'series_ids': {'type': 'array', 'items': {'type': 'string'}}, 'upstream_id': {'type': ['string', 'null']}, 'rba_series_ids': {'type': ['array', 'null'], 'items': {'type': 'string'}}}, 'additionalProperties': False}}, 'description': {'type': 'string'}, 'resolved_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'source_concepts': {'type': 'array', 'items': {'type': 'string'}}, 'alignment_method': {'enum': ['locf', 'exact_month', 'period_intersection', 'year_ended_lag'], 'type': 'string'}, 'requested_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'alignment_frequency': {'type': 'string'}, 'dropped_observations': {'type': 'object', 'required': ['input', 'derived', 'returned', 'dropped'], 'properties': {'input': {'type': 'integer', 'minimum': 0}, 'derived': {'type': 'integer', 'minimum': 0}, 'dropped': {'type': 'integer', 'minimum': 0}, 'returned': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'description': 'Derived-series provenance when returned by get_derived_series.', 'additionalProperties': False}, 'semantic': {'type': 'object', 'required': ['concept', 'variant', 'geography', 'frequency', 'requested_bounds', 'resolved_bounds', 'target'], 'properties': {'target': {'type': 'object', 'required': ['source', 'dataset_id', 'upstream_id', 'abs_key', 'rba_series_ids'], 'properties': {'source': {'enum': ['abs', 'rba', 'apra'], 'type': 'string'}, 'abs_key': {'type': ['string', 'null']}, 'dataset_id': {'type': 'string'}, 'upstream_id': {'type': 'string'}, 'apra_table_id': {'type': ['string', 'null']}, 'rba_series_ids': {'type': ['array', 'null'], 'items': {'type': 'string'}}, 'apra_series_ids': {'type': ['array', 'null'], 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'concept': {'type': 'string'}, 'variant': {'type': ['string', 'null']}, 'frequency': {'type': ['string', 'null']}, 'geography': {'type': ['string', 'null']}, 'resolved_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'requested_bounds': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'description': 'Semantic concept provenance when returned by get_economic_series.', 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Plain-English source warnings relevant to the payload.'}, 'cached_at': {'type': 'number'}, 'frequency': {'type': ['string', 'null']}, 'selection': {'oneOf': [{'type': 'object', 'required': ['type', 'n', 'direction', 'numeric_observation_count', 'returned_observation_count', 'dropped_non_numeric_count'], 'properties': {'n': {'type': 'integer', 'minimum': 1}, 'type': {'enum': ['top_n'], 'type': 'string'}, 'direction': {'enum': ['highest', 'lowest'], 'type': 'string'}, 'dropped_non_numeric_count': {'type': 'integer', 'minimum': 0}, 'numeric_observation_count': {'type': 'integer', 'minimum': 0}, 'returned_observation_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, {'type': 'object', 'required': ['type', 'n', 'series_count', 'returned_observation_count'], 'properties': {'n': {'type': 'integer', 'minimum': 1}, 'type': {'enum': ['latest'], 'type': 'string'}, 'series_count': {'type': 'integer', 'minimum': 0}, 'returned_observation_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}], 'description': 'Observation-selection provenance when returned by convenience tools.'}, 'truncated': {'type': 'boolean'}, 'dataset_id': {'type': 'string'}, 'expires_at': {'type': 'number'}, 'retrieved_at': {'type': 'string', 'format': 'date-time'}, 'retrieval_url': {'type': 'string'}, 'updated_after': {'type': ['string', 'null']}, 'server_version': {'type': 'string'}, 'framework_breaks': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'label', 'description'], 'properties': {'date': {'type': 'string'}, 'label': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'Known source framework or reporting-definition breaks relevant to the payload.'}, 'publication_date': {'type': ['string', 'null']}, 'apra_url_resolution': {'type': 'object', 'required': ['strategy', 'seed_checked_at'], 'properties': {'strategy': {'enum': ['landing_page', 'seed_manifest', 'catalogue_fallback'], 'type': 'string'}, 'seed_checked_at': {'type': ['string', 'null']}}, 'description': 'APRA workbook URL resolution strategy used for this retrieval.', 'additionalProperties': False}, 'observations_dropped': {'type': 'integer', 'minimum': 0, 'description': 'Number of observations removed by last_n selection; truncated is true when this is non-zero.'}}, 'description': 'Source, provenance, cache, and retrieval metadata for this response.', 'additionalProperties': False}, 'observations': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'series_id', 'value'], 'properties': {'date': {'oneOf': [{'type': 'string', 'format': 'date', 'pattern': '^\\d{4}-(0[1-9]|1[0-2])-[0-3][0-9]$'}, {'type': 'string', 'pattern': '^\\d{4}$'}, {'type': 'string', 'pattern': '^\\d{4}-Q[1-4]$'}, {'type': 'string', 'pattern': '^\\d{4}-(0[1-9]|1[0-2])$'}, {'type': 'string', 'pattern': '^\\d{4}-S[1-2]$'}], 'description': 'Observation date as an ISO date or source-native ABS period.'}, 'value': {'type': ['number', 'null']}, 'status': {'type': ['string', 'null']}, 'comment': {'type': ['string', 'null'], 'description': 'ABS observation comment when supplied by the source.'}, 'raw_value': {'type': ['string', 'null']}, 'series_id': {'type': 'string'}, 'dimensions': {'type': 'object', 'additionalProperties': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string'}, 'label': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'description': 'Long-form observations keyed by date and series_id.'}}, 'description': 'Normalised retrieval response returned by ABS, RBA, APRA, semantic, and derived data tools.', 'additionalProperties': False}
list_catalogue
List Catalogue
List curated ABS, RBA, and APRA catalogue entries, optionally filtered by source, category, or tag. Unranked complement to ``search_datasets``.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'properties': {'tag': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional curated catalogue tag filter.'}, 'source': {'anyOf': [{'enum': ['abs', 'rba', 'apra'], 'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional source filter. Use abs for Australian Bureau of Statistics, rba for Reserve Bank of Australia, or apra for Australian Prudential Regulation Authority.'}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional curated catalogue or semantic concept category filter.'}, 'include_ceased': {'type': 'boolean', 'default': False, 'description': 'Whether to include ceased ABS catalogue entries.'}, 'include_discontinued': {'type': 'boolean', 'default': False, 'description': 'Whether to include discontinued RBA catalogue entries.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'Curated ABS, RBA, and APRA catalogue entries.'}}, 'description': 'Curated ABS, RBA, and APRA catalogue entries.', 'additionalProperties': False, 'x-fastmcp-wrap-result': True}
list_economic_concepts
List Economic Concepts
List analyst-friendly semantic economic concepts accepted by get_economic_series.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'properties': {'query': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional query for filtering semantic economic concepts.'}, 'source': {'anyOf': [{'enum': ['abs', 'rba', 'apra'], 'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional source filter. Use abs for Australian Bureau of Statistics, rba for Reserve Bank of Australia, or apra for Australian Prudential Regulation Authority.'}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional curated catalogue or semantic concept category filter.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'Curated semantic economic concepts.'}}, 'description': 'Curated semantic economic concepts.', 'additionalProperties': False, 'x-fastmcp-wrap-result': True}
list_rba_tables
List RBA Tables
Deprecated compatibility alias. Prefer list_catalogue(source="rba").
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'properties': {'category': {'anyOf': [{'enum': ['exchange_rates', 'external_sector', 'household_finance', 'inflation', 'interest_rates', 'monetary_policy', 'money_credit', 'output_labour', 'payments'], 'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional RBA catalogue category filter.'}, 'include_discontinued': {'type': 'boolean', 'default': False, 'description': 'Whether to include discontinued RBA catalogue entries.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'Curated RBA table catalogue entries.'}}, 'description': 'Curated RBA table catalogue entries.', 'additionalProperties': False, 'x-fastmcp-wrap-result': True}
list_release_events
List Release Events
List source-aware release calendar or release-pulse events.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 50, 'minimum': 1, 'description': 'Positive observation count.'}, 'query': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional query for filtering semantic economic concepts.'}, 'source': {'anyOf': [{'enum': ['abs', 'rba', 'apra'], 'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional source filter. Use abs for Australian Bureau of Statistics, rba for Reserve Bank of Australia, or apra for Australian Prudential Regulation Authority.'}, 'end_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'format': 'date', 'default': None, 'description': 'Optional ISO date bound in YYYY-MM-DD format.'}, 'start_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'format': 'date', 'default': None, 'description': 'Optional ISO date bound in YYYY-MM-DD format.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'ABS, RBA, and APRA release calendar events.'}}, 'description': 'ABS, RBA, and APRA release calendar events.', 'additionalProperties': False, 'x-fastmcp-wrap-result': True}
search_datasets
Search Datasets
Search curated ABS, RBA, and APRA economic datasets.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'minLength': 1, 'description': 'Discovery query text.'}, 'source': {'anyOf': [{'enum': ['abs', 'rba', 'apra'], 'type': 'string'}, {'type': 'null'}], 'default': None, 'description': 'Optional source filter. Use abs for Australian Bureau of Statistics, rba for Reserve Bank of Australia, or apra for Australian Prudential Regulation Authority.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'Ranked ABS, RBA, and APRA catalogue search results.'}}, 'description': 'Ranked ABS, RBA, and APRA catalogue search results.', 'additionalProperties': False, 'x-fastmcp-wrap-result': True}
Añadido
list_release_events
17 de September de 2026 a las 12:40
Añadido
describe_dataset
17 de September de 2026 a las 12:40
Añadido
get_top_observations
17 de September de 2026 a las 12:40
Añadido
get_latest_observations
17 de September de 2026 a las 12:40
Añadido
get_derived_series
17 de September de 2026 a las 12:40
Añadido
get_economic_series
17 de September de 2026 a las 12:40
Añadido
get_apra_data
17 de September de 2026 a las 12:40
Añadido
get_rba_table
17 de September de 2026 a las 12:40
Añadido
list_rba_tables
17 de September de 2026 a las 12:40
Añadido
get_abs_data
17 de September de 2026 a las 12:40
Añadido
get_abs_dataset_structure
17 de September de 2026 a las 12:40
Añadido
list_economic_concepts
17 de September de 2026 a las 12:40
Añadido
list_catalogue
17 de September de 2026 a las 12:40
Añadido
search_datasets
17 de September de 2026 a las 12:40