Skip to main content
Glama
ausdata-mcp

ausdata-mcp

ausdata-mcp

mcp-name: io.ausdata/ausdata-mcp

MCP server for the Australian public data API. Plug into Claude Code, Cursor, Windsurf, or any other MCP client and get one-call access to 100+ curated Australian government datasets across 9 sources.

Install

Add to your MCP client config:

{
  "mcpServers": {
    "ausdata": {
      "command": "npx",
      "args": ["-y", "ausdata-mcp"],
      "env": {
        "AUSDATA_API_KEY": "ak_xxx"
      }
    }
  }
}

Get a free API key at https://ausdata.io (500 calls/month on the free tier, no credit card).

Related MCP server: AusEcon MCP for ABS | RBA | APRA data

Tools exposed

Tool

What it does

search_datasets

Plain-English search across the catalog. "unemployment NSW" → dataset IDs to call.

list_datasets

List curated datasets for a given source (abs, rba, ato, …).

describe_dataset

Schema + filter dictionary for one dataset before you get_data it.

get_data

Generic accessor by source + dataset_id. Search first, fetch second.

releases

Upcoming + recent statistical release calendar across all sources.

real_wages

Wage Price Index minus CPI, quarterly. The Greg Jericho chart in one call.

real_cash_rate

RBA cash rate minus CPI — the real policy stance.

economic_dashboard

Cash rate, CPI, unemployment, wage growth, lending — in one response.

cost_of_living

ABS Selected Living Cost Indexes by household type.

youth_unemployment

15-24 unemployment rate, state-level.

trade_balance

Goods + services trade balance, monthly.

housing_affordability

House prices vs household disposable income, indexed.

gender_pay_context

WGEA gender pay gap by industry / employer-size context.

energy_snapshot

AEMO NEM dispatch + price snapshot, current trading interval.

health

API reachability check. Useful for debugging.

Example agent prompts

Once the MCP is connected, try asking your agent:

  • "What's the latest RBA cash rate and how does it compare to a year ago?"

  • "Show me the real wages trend since 2019."

  • "Search for AU housing approval data and pull the last 2 years for NSW."

Configuration

Env var

Purpose

Default

AUSDATA_API_KEY

Bearer token

required

AUSDATA_API_URL

Override the API base URL

https://api.ausdata.io

AUSDATA_TIMEOUT

Per-request timeout (ms)

30000

Errors

Every tool returns MCP-formatted errors that AI agents can read and recover from:

  • Missing key → Set AUSDATA_API_KEY in your MCP config. Get a free key at https://ausdata.io

  • 401 → reauth hint

  • 403 → upgrade hint

  • 429 → retry-after seconds

  • 5xx → "try again, status page is at..."

The ausdata.io ecosystem

Part of a family of MCP servers + a hosted API for Australian public data:

License

MIT — see LICENSE.

This client is independent of the upstream data; each response carries attribution metadata for the underlying ABS / RBA / APRA / AIHW / etc. source under their respective CC-BY licenses.

Development

npm install
npm run build
npm test
npm run lint

Source lives in src/. Tool definitions are in src/tools/. The HTTP routing layer is src/client.ts — it does NOT parse responses, that's the API server's job.


Built by Harrison Vass (LinkedIn). I verify automated systems: agents draft the code, I direct, review and answer for what ships.

Available Tools

28 tools
bank_deposit_shareA

Returns the AU bank-deposit market-share snapshot — APRA Monthly Authorised Deposit-taking Institutions (ADI) statistics aggregated by parent group. Single call answers 'who holds the deposits in Australia right now?'. Sources APRA. Returns deposit totals per ADI, market-share percentages, and the top-N concentration (Big Four share). Useful for banking-competition and concentration-risk analysis.

NameRequiredDescriptionDefault

No parameters

charity_sector_healthA

Returns the AU charity sector health snapshot — ACNC registered-charity aggregates: total active charities, total revenue, donations received, employment, and year-on-year deltas. Single call answers 'how is the AU not-for-profit sector tracking?'. Sources ATO/ACNC. Useful for philanthropy, NFP-policy, and grant-funder context.

NameRequiredDescriptionDefault

No parameters

cost_of_livingA

Get the AU cost-of-living snapshot in one call. Returns ABS Selected Living Cost Indexes (SLCI) for the 5 household types (Employee, Age pensioner, Other government transfer recipient, Self-funded retiree, Pensioner & beneficiary) plus headline CPI for comparison. Use this when an agent is asked 'how much are living costs rising for retirees vs workers?'.

NameRequiredDescriptionDefault

No parameters

describe_datasetA

Returns the schema of a curated Australian government dataset: the available dimensions (filters), valid values per dimension, units, frequency, and source URL. Use this when get_data returns an 'Unknown filter' or 'Unknown value' error — the response tells you exactly which filter keys and values are accepted.

NameRequiredDescriptionDefault
dataset_idYesDotted dataset ID returned by search_datasets, e.g. 'abs.LF', 'rba.F1.1', 'apra.ADI_KEY_STATS'
economic_dashboardA

Get the 5 headline AU economic indicators in one call: RBA cash rate, ABS CPI, unemployment, wage growth, and housing lending growth. Use this when an agent needs a macro economic snapshot. Cross-sources RBA + ABS in one query. Replaces 5 separate sister-MCP calls.

NameRequiredDescriptionDefault
periodNoQuarter (YYYY-Qn), year (YYYY), month (YYYY-MM), or 'latest'latest
energy_snapshotA

Get the current AU National Electricity Market (NEM) snapshot for a region: spot price, demand, renewable share, and generation mix. Use this when an agent is asked 'how much is electricity costing right now in NSW?' or 'what's the renewable share in SA?'. Sources AEMO live data.

NameRequiredDescriptionDefault
regionNoNEM region code. NSW1 = New South Wales, QLD1 = Queensland, SA1 = South Australia, TAS1 = Tasmania, VIC1 = Victoria. Omit for all regions.
gender_pay_contextA

Get the AU gender pay gap with industry context in one call. Combines WGEA national + industry gender pay gap data with ABS labour-force composition. Use this when an agent is asked 'what's the pay gap in ?' or comparing AU industries on gender equity. Cross-sources WGEA + ABS.

NameRequiredDescriptionDefault
industryNoOptional ANZSIC industry filter. Accepts industry name, ANZSIC division letter (A-S), or code. Omit for national-level data.
get_dataA

Generic accessor for any curated Australian government dataset. Use search_datasets first to find the dataset_id, then call this with filters. Two input forms are accepted: dotted (dataset_id='abs.CPI_MONTHLY') OR split (source='abs', dataset_id='CPI_MONTHLY'). Period format depends on the dataset: YYYY-MM for monthly, YYYY-Qn for quarterly, YYYY for annual. Example: dataset_id='abs.LF', filters={region:'australia', measure:'unemployment_rate'}, start_period='2024-01'.

NameRequiredDescriptionDefault
limitNoMax rows (1-1000). Default 100.
sourceNoSource slug. Required only when dataset_id is bare (no dot). One of: abs/rba/ato/apra/aihw/asic/aemo/wgea/au_weather.
filtersNoFilter dict — source-specific dimension keys passed through to the upstream sister MCP. Example: {"region": "australia", "measure": "unemployment_rate"} for abs.LF.
dataset_idYesDataset ID returned by search_datasets. Two forms accepted: dotted ('abs.CPI_MONTHLY', 'rba.F1.1') OR bare ('CPI_MONTHLY' — then pass `source` separately).
end_periodNoEnd period in dataset's native format.
start_periodNoStart period in dataset's native format (YYYY, YYYY-MM, YYYY-Qn).
healthA

Check the ausdata.io API is reachable and your API key is valid. Useful for debugging MCP connection issues. Returns the server status, API version, and your remaining quota.

NameRequiredDescriptionDefault

No parameters

housing_affordabilityA

Get the AU housing affordability snapshot: median dwelling price, household income, price-to-income ratio, mortgage serviceability at the current cash rate, and rent burden. Use this when an agent is asked 'is Australian housing more unaffordable than it was?'. Cross-sources ABS + RBA.

NameRequiredDescriptionDefault

No parameters

inflation_decompositionA

Returns the AU CPI inflation decomposition — headline CPI broken down by ABS expenditure group (housing, food, transport, recreation, etc.) plus contribution-to-total-inflation in percentage points. Single call answers 'what is actually driving inflation right now?'. Sources ABS CPI. Returns the top contributors ranked by contribution, alongside YoY growth per group. Useful for monetary-policy commentary and household-impact analysis.

NameRequiredDescriptionDefault

No parameters

list_datasetsA

Enumerate every curated dataset a source exposes (e.g. all ABS datasets, all RBA tables). Use this for surveying what's available before picking one to describe or fetch. Pairs with search_datasets (free-text discovery), describe_dataset (schema), and get_data (fetch).

NameRequiredDescriptionDefault
sourceYesSource name. One of: abs, rba, ato, apra, aihw, asic, aemo, wgea.
macro_snapshot_stateA

Returns the AU state-level macroeconomic snapshot — unemployment rate, state final demand growth, dwelling-price change, CPI (where state-level is published), and population growth for a given state. Single call answers 'how is tracking economically?'. Cross-sources ABS labour-force, national-accounts, residential-property indexes. Pass a state code to focus on one jurisdiction; omit for all eight states/territories.

NameRequiredDescriptionDefault
stateNoAustralian state/territory code (NSW, VIC, QLD, SA, WA, TAS, NT, ACT). Omit for all jurisdictions.
nem_dispatch_5minA

Returns the AEMO 5-minute NEM dispatch series — recent dispatch intervals for a region (or all regions): spot price, scheduled demand, dispatched generation by fuel/technology. Use this when an agent is asked 'what's been happening in the NEM over the last hour?' or 'show me the dispatch curve in QLD today'. Higher cadence than energy_snapshot (which is a point-in-time summary). Sources AEMO live dispatch.

NameRequiredDescriptionDefault
limitNoMaximum number of 5-minute intervals to return (1-288 — 288 covers a full 24h day). Defaults to the server-side default.
regionNoNEM region code. NSW1 = New South Wales, QLD1 = Queensland, SA1 = South Australia, TAS1 = Tasmania, VIC1 = Victoria. Omit for all regions.
real_cash_rateA

Returns the current real (inflation-adjusted) cash rate — RBA cash rate minus ABS CPI annual change. Single call answers 'is monetary policy restrictive?'. Cross-sources RBA + ABS. Returns nominal cash rate, CPI annual change, the computed real rate, and a stance flag (restrictive/neutral/accommodative).

NameRequiredDescriptionDefault

No parameters

real_mortgage_rateA

Returns the current real (inflation-adjusted) standard variable mortgage rate — RBA owner-occupier standard variable rate minus ABS CPI annual change. Single call answers 'are mortgage holders paying a real cost above inflation?'. Cross-sources RBA F-tables + ABS. Returns nominal mortgage rate, CPI annual change, the computed real rate, and a borrower-stance flag (real_cost_positive vs negative).

NameRequiredDescriptionDefault

No parameters

real_savings_rateA

Returns the current real (inflation-adjusted) bank term-deposit / savings rate — RBA retail deposit rate minus ABS CPI annual change. Single call answers 'are savers being compensated for inflation?'. Cross-sources RBA + ABS. Returns nominal savings rate, CPI annual change, the computed real savings rate, and a saver-stance flag (positive_real_return vs eroding).

NameRequiredDescriptionDefault

No parameters

real_wagesA

Get Australian real wages time series (Wage Price Index minus CPI). The flagship 'Greg Jericho chart' — published weekly by AU economic commentators. Returns nominal wage growth, CPI annual change, and the computed gap for each quarter in the range. Example: range 2019-Q1 to 2024-Q4 to see the post-pandemic real wages collapse.

NameRequiredDescriptionDefault
endNoPeriod end (YYYY-Q4 format). Omit for latest.
startNoPeriod start (YYYY-Q1 format)
seasonal_adjustmentNoABS methodology variant. 'trend' matches Greg Jericho's published charts.trend
regional_cost_of_livingA

Get the AU regional cost-of-living comparison: per-capital-city CPI changes plus the weighted-eight-capitals average. Use this when an agent is asked 'is the cost of living rising faster in Brisbane than Sydney?' or 'which capital city has the worst inflation?'. Sources ABS CPI by capital city. Returns city-by-city annual CPI deltas and a ranked comparison.

NameRequiredDescriptionDefault

No parameters

release_pulseA

Returns the AU data-release pulse — a high-signal summary of the upcoming economic release calendar across ABS, RBA, APRA, AEMO and friends, ranked by market-moving importance. Use this when an agent is asked 'what data drops this week?' or 'when's the next big print?'. Differs from releases (the raw calendar) by ranking events by impact and grouping by week. Sources cross-agency calendars.

NameRequiredDescriptionDefault
days_aheadNoHow many days ahead to scan (1-90). Defaults to the server-side default (typically 14). Pass a smaller value for the next-week pulse, larger for the monthly view.
releasesA

Get the upcoming AU economic release calendar: ABS publication dates, RBA board meeting dates, and other scheduled data releases in the next N days. Use this when an agent is asked 'when is the next CPI release?' or 'when is the RBA next deciding on rates?'. Cross-sources ABS + RBA calendars.

NameRequiredDescriptionDefault
sourceNoFilter by source agency. Omit for all sources.
dataset_idNoFilter to a specific dataset (e.g. 'abs.CPI', 'abs.LF').
days_aheadNoHow many days ahead to look (1-90). Defaults to 30.
event_typeNoFilter by event type (e.g. 'release', 'board_meeting', 'statement').
search_datasetsA

Search the catalog of curated Australian government datasets. Returns matched datasets with their IDs, sources, and example queries. Use this when you don't know the exact dataset_id for the data you need. Examples: 'unemployment nsw', 'housing approvals', 'cash rate'.

NameRequiredDescriptionDefault
qYesSearch query in plain English, e.g. 'unemployment NSW' or 'banking statistics'
limitNoMax results (1-50). Defaults to 10.
sectoral_employment_shiftA

Returns the AU sectoral employment shift — year-on-year change in employed persons by ANZSIC industry division. Single call answers 'which industries are hiring and which are shedding?'. Sources ABS Labour Force Detailed. Returns per-industry deltas (absolute + percentage), share of total employment, and a sorted ranking of growth/decline. Useful for labour-market narrative and career-pivot queries.

NameRequiredDescriptionDefault

No parameters

state_fiscal_snapshotA

Returns the AU state/territory fiscal snapshot — Government Finance Statistics (GFS) by jurisdiction: revenue, expenses, net operating balance, net debt. Single call answers 'what's the fiscal position of ?' or 'which state is running the largest deficit?'. Sources ABS GFS. Pass a single state code to focus on one jurisdiction, or omit for all eight states/territories.

NameRequiredDescriptionDefault
stateNoAustralian state/territory code (NSW, VIC, QLD, SA, WA, TAS, NT, ACT). Omit for all jurisdictions.
super_fund_real_returnA

Returns the average AU superannuation fund real return — APRA fund-level performance net of fees minus ABS CPI annual change. Single call answers 'is super outpacing inflation right now?'. Cross-sources APRA + ABS. Returns nominal return, CPI annual change, the computed real return, and a stance flag (real_growth vs eroding). Useful for retirement-planning queries.

NameRequiredDescriptionDefault

No parameters

trade_balanceA

Get the current AU trade balance: exports minus imports, with top trading partners and surplus/deficit trend. Use this when an agent is asked 'is Australia running a trade surplus?' or 'who are Australia's biggest trade partners?'. Sources ABS International Trade.

NameRequiredDescriptionDefault

No parameters

wage_vs_rent_gapA

Compares ABS Wage Price Index (WPI) annual growth against ABS rents-component CPI annual growth — single call answers 'are rents outpacing wages?'. Returns nominal wage growth, rent growth, the gap in percentage points, and a direction flag (rents_outpacing_wages vs wages_keeping_pace). Useful for affordability narrative — when negative, real housing-cost pressure is mounting.

NameRequiredDescriptionDefault

No parameters

youth_unemploymentA

Get the current AU youth (15-24) unemployment rate vs the overall rate, with the gap and trend. Use this when an agent is asked 'how bad is youth unemployment in Australia?' or comparing youth labour market conditions to the broader workforce. Sources ABS Labour Force.

NameRequiredDescriptionDefault

No parameters

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 28 tool updatesv0.4.2
    • First observedbank_deposit_share
    • First observedcharity_sector_health
    • First observedcost_of_living
    • First observeddescribe_dataset
    • First observedeconomic_dashboard
    • First observedenergy_snapshot
    • First observedgender_pay_context
    • First observedget_data
    • First observedhealth
    • First observedhousing_affordability
    • First observedinflation_decomposition
    • First observedlist_datasets
    • First observedmacro_snapshot_state
    • First observednem_dispatch_5min
    • First observedreal_cash_rate
    • First observedreal_mortgage_rate
    • First observedreal_savings_rate
    • First observedreal_wages
    • First observedregional_cost_of_living
    • First observedrelease_pulse
    • First observedreleases
    • First observedsearch_datasets
    • First observedsectoral_employment_shift
    • First observedstate_fiscal_snapshot
    • First observedsuper_fund_real_return
    • First observedtrade_balance
    • First observedwage_vs_rent_gap
    • First observedyouth_unemployment

TDQS

A3.9/5.0

Scored across 28 tools

Disambiguation4/5

Most tools have clearly distinct purposes, especially the real_* series targeting different rates. However, releases and release_pulse overlap heavily, and cost_of_living vs regional_cost_of_living could cause confusion. Overall, the boundaries are fairly clear.

Naming Consistency3/5

There is a mix of verb_noun patterns (search_datasets, describe_dataset) and noun phrases (real_wages, economic_dashboard). While all names are readable and snake_case, the lack of a consistent verb_noun style across the whole set makes it feel inconsistent.

Tool Count2/5

With 28 tools, the set is too heavy. Many tools are narrow wrappers (e.g., real_cash_rate, real_mortgage_rate, real_savings_rate) that could be consolidated into a single parameterized tool. This exceeds the typical well-scoped range and feels bloated.

Completeness4/5

The server offers broad coverage of Australian economic and social data, including discovery (search, list, describe, get) and numerous snapshot tools. Minor gaps exist (e.g., national GDP, specific demographic datasets), but they are not critical for the apparent scope.

Maintenance

ActivityNo data
ResponsivenessSyncing

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    A
    maintenance
    MCP server for structured Australian macroeconomic and financial data from the Australian Bureau of Statistics (ABS), the Reserve Bank of Australia (RBA), and the Australian Prudential Regulation Authority (APRA).
    14
    89 PyPI
    5
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    MCP server with 562 tools accessing 114 government data APIs covering economic, health, education, energy, and more from federal, state, and international sources.
    100
    414 npm
    1
    MIT