Ausecon MCP
An open-source MCP server that retrieves Australian economic and financial data from the ABS, RBA, and APRA. It provides tools for fetching series, observations, derived indicators, and release calendars, supporting both local stdio and remote Streamable HTTP transports.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://mcp.auseconmcp.com/mcpWhat its tools do
14 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Retrieve Australian Bureau of Statistics data
- Fetch Reserve Bank of Australia cash rates
- Access APRA insurance statistics
- Get latest economic observations and top movers
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- ausecon-mcp-server 1.15.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 14 advertised
- Resources
- 2 advertised
- Resource templates
- 3 advertised
- Prompts
- 8 advertised
{
"tools": {
"listChanged": true
},
"logging": {},
"prompts": {
"listChanged": true
},
"resources": {
"subscribe": false,
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
14 advertised
search_datasets — Search Datasets
Search curated ABS, RBA, and APRA economic datasets.
{
"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": null,
"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
}{
"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
}{
"title": "Search Datasets",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": 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``.
{
"type": "object",
"properties": {
"tag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional curated catalogue tag filter."
},
"source": {
"anyOf": [
{
"enum": [
"abs",
"rba",
"apra"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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": null,
"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
}{
"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
}{
"title": "List Catalogue",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}list_economic_concepts — List Economic Concepts
List analyst-friendly semantic economic concepts accepted by get_economic_series.
{
"type": "object",
"properties": {
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional query for filtering semantic economic concepts."
},
"source": {
"anyOf": [
{
"enum": [
"abs",
"rba",
"apra"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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": null,
"description": "Optional curated catalogue or semantic concept category filter."
}
},
"additionalProperties": false
}{
"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
}{
"title": "List Economic Concepts",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_abs_dataset_structure — Get ABS Dataset Structure
Get ABS SDMX dataset dimensions and codelists.
{
"type": "object",
"required": [
"dataflow_id"
],
"properties": {
"dataflow_id": {
"type": "string",
"minLength": 1,
"description": "Non-empty dataset or table id."
}
},
"additionalProperties": false
}{
"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
}{
"title": "Get ABS Dataset Structure",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_abs_data — Get ABS Data
Expert/source-native ABS SDMX retrieval in a normalised response shape.
{
"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": null,
"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": null,
"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": null,
"description": "Optional ABS period bound in YYYY, YYYY-QN, YYYY-MM, or YYYY-SN format."
},
"updated_after": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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
}{
"$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",
null
],
"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
}{
"title": "Get ABS Data",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}list_rba_tables — List RBA Tables
Deprecated compatibility alias. Prefer list_catalogue(source="rba").
{
"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": null,
"description": "Optional RBA catalogue category filter."
},
"include_discontinued": {
"type": "boolean",
"default": false,
"description": "Whether to include discontinued RBA catalogue entries."
}
},
"additionalProperties": false
}{
"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
}{
"title": "List RBA Tables",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_rba_table — Get RBA Table
Expert/source-native RBA statistical table retrieval in a normalised response shape.
{
"type": "object",
"required": [
"table_id"
],
"properties": {
"last_n": {
"anyOf": [
{
"type": "integer",
"minimum": 1
},
{
"type": "null"
}
],
"default": null,
"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": null,
"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": null,
"description": "Optional list of non-empty source-native series IDs to keep after download."
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"format": "date",
"default": null,
"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
}{
"$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",
null
],
"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
}{
"title": "Get RBA Table",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"required": [
"publication_id"
],
"properties": {
"last_n": {
"anyOf": [
{
"type": "integer",
"minimum": 1
},
{
"type": "null"
}
],
"default": null,
"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": null,
"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": null,
"description": "Non-empty dataset or table id."
},
"series_ids": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
{
"type": "null"
}
],
"default": null,
"description": "Optional list of non-empty source-native series IDs to keep after download."
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"format": "date",
"default": null,
"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
}{
"$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",
null
],
"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
}{
"title": "Get APRA Data",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": 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.
{
"type": "object",
"required": [
"concept"
],
"properties": {
"end": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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": null,
"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": null,
"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": null,
"description": "Optional curated concept variant, such as headline, underlying, or target."
},
"frequency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional requested frequency for a curated concept, such as monthly, quarterly, or annual."
},
"geography": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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
}{
"$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",
null
],
"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
}{
"title": "Get Economic Series",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": 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.
{
"type": "object",
"required": [
"concept"
],
"properties": {
"end": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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": null,
"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": null,
"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
}{
"$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",
null
],
"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
}{
"title": "Get Derived Series",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": 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.
{
"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": null,
"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": null,
"description": "Optional list of non-empty source-native series IDs to keep after download."
}
},
"additionalProperties": false
}{
"$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",
null
],
"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
}{
"title": "Get Latest Observations",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": 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.
{
"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": null,
"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": null,
"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": null,
"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": null,
"description": "Optional list of non-empty source-native series IDs to keep after download."
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"format": "date",
"default": null,
"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": null,
"description": "Optional ABS period bound in YYYY, YYYY-QN, YYYY-MM, or YYYY-SN format."
}
},
"additionalProperties": false
}{
"$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",
null
],
"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
}{
"title": "Get Top Observations",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}describe_dataset — Describe Dataset
Describe a source-native ABS, RBA, or APRA dataset without hiding native IDs.
{
"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": null,
"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
}{
"type": "object",
"description": "Plain-English dataset description preserving source-native identifiers.",
"additionalProperties": true
}{
"title": "Describe Dataset",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}list_release_events — List Release Events
List source-aware release calendar or release-pulse events.
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"minimum": 1,
"description": "Positive observation count."
},
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional query for filtering semantic economic concepts."
},
"source": {
"anyOf": [
{
"enum": [
"abs",
"rba",
"apra"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"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": null,
"description": "Optional ISO date bound in YYYY-MM-DD format."
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"format": "date",
"default": null,
"description": "Optional ISO date bound in YYYY-MM-DD format."
}
},
"additionalProperties": false
}{
"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
}{
"title": "List Release Events",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}Prompts
8 advertised
summarise_latest_inflation
Summarise the most recent Australian headline and trimmed-mean CPI prints and compare them to the RBA's 2–3% target band.
- months
- Provide a value matching the following JSON schema: {"type":"integer"}. Encode non-string values as JSON.
compare_cash_rate_to_cpi
Narrate the relationship between the RBA cash rate target and headline CPI over a user-specified window.
- start
- Provide a value matching the following JSON schema: {"type":"string"}. Encode non-string values as JSON. (required)
- end
- Provide a value matching the following JSON schema: {"anyOf":[{"type":"string"},{"type":"null"}]}. Encode non-string values as JSON.
macro_snapshot
Produce a tight snapshot of the Australian macro backdrop: cash rate, headline and trimmed-mean CPI, and real GDP growth.
- as_of
- Provide a value matching the following JSON schema: {"anyOf":[{"type":"string"},{"type":"null"}]}. Encode non-string values as JSON.
living_costs_vs_cpi
Compare Selected Living Cost Indexes (SLCI) across household types against headline CPI to show cost-of-living divergence.
- start
- Provide a value matching the following JSON schema: {"anyOf":[{"type":"string"},{"type":"null"}]}. Encode non-string values as JSON.
- last_n
- Provide a value matching the following JSON schema: {"type":"integer"}. Encode non-string values as JSON.
construction_pipeline
Summarise the Australian construction pipeline across engineering, residential, and non-residential activity.
- last_n
- Provide a value matching the following JSON schema: {"type":"integer"}. Encode non-string values as JSON.
labour_slack_snapshot
Summarise Australian labour-market slack using the unemployment and underemployment rates over a recent window.
- last_n
- Provide a value matching the following JSON schema: {"type":"integer"}. Encode non-string values as JSON.
yield_curve_snapshot
Compare the 3-year and 10-year Australian Government Security yields over a recent window to describe the curve shape.
- last_n
- Provide a value matching the following JSON schema: {"type":"integer"}. Encode non-string values as JSON.
discover_dataset
Find and recommend the best ABS datasets or RBA tables for a given economic topic.
- topic
- Provide a value matching the following JSON schema: {"type":"string"}. Encode non-string values as JSON. (required)
Resources
2 advertised
Ausecon catalogue index
Flat index of every curated ABS, RBA, and APRA dataset the server exposes. Use this to browse what is available before calling search_datasets.
ausecon://catalogueAusecon semantic concepts
Every curated semantic shortcut accepted by get_economic_series, with its resolved target dataset, variant, supported frequencies, and geographies.
ausecon://conceptsABS catalogue entry
Curated metadata for a single ABS dataflow.
ausecon://abs/{dataflow_id}RBA catalogue entry
Curated metadata for a single RBA statistical table.
ausecon://rba/{table_id}APRA catalogue entry
Curated metadata for a single APRA publication.
ausecon://apra/{publication_id}90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 2 of 2 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1144 ms
- 95th percentile latency
- 1144 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1144 ms · metadata changed · 14 tool(s), 2 resource(s), 3 resource template(s), 8 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http ausecon-mcp-auseconmcp https://mcp.auseconmcp.com/mcpCodex
codex mcp add ausecon-mcp-auseconmcp --url https://mcp.auseconmcp.com/mcpCursor
{
"mcpServers": {
"ausecon-mcp-auseconmcp": {
"url": "https://mcp.auseconmcp.com/mcp"
}
}
}Cline
{
"mcpServers": {
"ausecon-mcp-auseconmcp": {
"type": "streamableHttp",
"url": "https://mcp.auseconmcp.com/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"ausecon-mcp-auseconmcp": {
"type": "http",
"url": "https://mcp.auseconmcp.com/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http ausecon-mcp-auseconmcp https://mcp.auseconmcp.com/mcpClaude Desktop
https://mcp.auseconmcp.com/mcpWindsurf
{
"mcpServers": {
"ausecon-mcp-auseconmcp": {
"serverUrl": "https://mcp.auseconmcp.com/mcp"
}
}
}Let your agent find its tools
Find servers like Ausecon MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.