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.

Inputs: no named 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.

Inputs: no named 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?'.

Inputs: no named 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.

Inputs: dataset_id (required).

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.

Inputs: period.

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.

Inputs: region.

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.

Inputs: industry.

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'.

Inputs: dataset_id (required), limit, source, filters, +2 more.

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.

Inputs: no named 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.

Inputs: no named 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.

Inputs: no named 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).

Inputs: source (required).

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.

Inputs: state.

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.

Inputs: limit, region.

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).

Inputs: no named 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).

Inputs: no named 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).

Inputs: no named 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.

Inputs: end, start, seasonal_adjustment.

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.

Inputs: no named 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.

Inputs: days_ahead.

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.

Inputs: source, dataset_id, days_ahead, event_type.

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'.

Inputs: q (required), limit.

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.

Inputs: no named 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.

Inputs: state.

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.

Inputs: no named 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.

Inputs: no named 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.

Inputs: no named 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.

Inputs: no named parameters.

Tool Schema Changelog

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

Loading tool schema changelog…

    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