ausdata-mcp
This server gives one-call access to 100+ curated Australian public datasets from ABS, RBA, ATO, APRA, AIHW, ASIC, AEMO, WGEA, and more. You can discover, inspect, and fetch data for macro, state, sectoral, energy, and financial analysis.
Dataset Discovery & Access:
search_datasets(plain‑English search),list_datasets(by source),describe_dataset(schema & filters),get_data(fetch with filters).Macro & Policy:
economic_dashboard(cash rate, CPI, unemployment, wages, lending),real_wages(WPI minus CPI),real_cash_rate,real_mortgage_rate,real_savings_rate,inflation_decomposition(CPI drivers).State & Regional:
macro_snapshot_state(unemployment, demand, dwelling prices, CPI, population),state_fiscal_snapshot(GFS revenue/expenses/debt),regional_cost_of_living(capital city CPI).Labour & Wages:
sectoral_employment_shift(YoY by industry),gender_pay_context(pay gap by industry),youth_unemployment,wage_vs_rent_gap.Housing & Cost of Living:
housing_affordability(price-to-income, serviceability, rent),cost_of_living(by household type).Trade, Finance & Super:
trade_balance(exports/imports, partners),bank_deposit_share(ADI concentration),super_fund_real_return.Energy:
energy_snapshot(NEM spot price, demand, renewable share, generation mix),nem_dispatch_5min(intraday).Charity Sector:
charity_sector_health(ACNC aggregates).Releases & Health:
releases(upcoming calendar),release_pulse(market‑moving events ranked),health(API status).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ausdata-mcpWhat's the latest RBA cash rate?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Plain-English search across the catalog. "unemployment NSW" → dataset IDs to call. |
| List curated datasets for a given source (abs, rba, ato, …). |
| Schema + filter dictionary for one dataset before you |
| Generic accessor by |
| Upcoming + recent statistical release calendar across all sources. |
| Wage Price Index minus CPI, quarterly. The Greg Jericho chart in one call. |
| RBA cash rate minus CPI — the real policy stance. |
| Cash rate, CPI, unemployment, wage growth, lending — in one response. |
| ABS Selected Living Cost Indexes by household type. |
| 15-24 unemployment rate, state-level. |
| Goods + services trade balance, monthly. |
| House prices vs household disposable income, indexed. |
| WGEA gender pay gap by industry / employer-size context. |
| AEMO NEM dispatch + price snapshot, current trading interval. |
| 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 |
| Bearer token | required |
| Override the API base URL |
|
| Per-request timeout (ms) |
|
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.io401 → 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:
Sister MCPs (free, MIT): abs · rba · ato · apra · aihw · asic · aemo · au-weather · wgea
Hosted API + cross-source endpoints: ausdata.io
Python SDK:
pip install ausdataio· Node MCP:npx -y ausdata-mcp
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 lintSource 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 toolscharity_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.
| Name | Required | Description | Default |
|---|---|---|---|
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?'.
| Name | Required | Description | Default |
|---|---|---|---|
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.
| Name | Required | Description | Default |
|---|---|---|---|
| dataset_id | Yes | Dotted 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.
| Name | Required | Description | Default |
|---|---|---|---|
| period | No | Quarter (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.
| Name | Required | Description | Default |
|---|---|---|---|
| region | No | NEM 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.
| Name | Required | Description | Default |
|---|---|---|---|
| industry | No | Optional 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'.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows (1-1000). Default 100. | |
| source | No | Source slug. Required only when dataset_id is bare (no dot). One of: abs/rba/ato/apra/aihw/asic/aemo/wgea/au_weather. | |
| filters | No | Filter dict — source-specific dimension keys passed through to the upstream sister MCP. Example: {"region": "australia", "measure": "unemployment_rate"} for abs.LF. | |
| dataset_id | Yes | Dataset ID returned by search_datasets. Two forms accepted: dotted ('abs.CPI_MONTHLY', 'rba.F1.1') OR bare ('CPI_MONTHLY' — then pass `source` separately). | |
| end_period | No | End period in dataset's native format. | |
| start_period | No | Start 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.
| Name | Required | Description | Default |
|---|---|---|---|
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.
| Name | Required | Description | Default |
|---|---|---|---|
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.
| Name | Required | Description | Default |
|---|---|---|---|
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).
| Name | Required | Description | Default |
|---|---|---|---|
| source | Yes | Source 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.
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | Australian 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.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of 5-minute intervals to return (1-288 — 288 covers a full 24h day). Defaults to the server-side default. | |
| region | No | NEM 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).
| Name | Required | Description | Default |
|---|---|---|---|
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).
| Name | Required | Description | Default |
|---|---|---|---|
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).
| Name | Required | Description | Default |
|---|---|---|---|
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.
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Period end (YYYY-Q4 format). Omit for latest. | |
| start | No | Period start (YYYY-Q1 format) | |
| seasonal_adjustment | No | ABS 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.
| Name | Required | Description | Default |
|---|---|---|---|
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.
| Name | Required | Description | Default |
|---|---|---|---|
| days_ahead | No | How 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.
| Name | Required | Description | Default |
|---|---|---|---|
| source | No | Filter by source agency. Omit for all sources. | |
| dataset_id | No | Filter to a specific dataset (e.g. 'abs.CPI', 'abs.LF'). | |
| days_ahead | No | How many days ahead to look (1-90). Defaults to 30. | |
| event_type | No | Filter 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'.
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Search query in plain English, e.g. 'unemployment NSW' or 'banking statistics' | |
| limit | No | Max 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.
| Name | Required | Description | Default |
|---|---|---|---|
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.
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | Australian 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.
| Name | Required | Description | Default |
|---|---|---|---|
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.
| Name | Required | Description | Default |
|---|---|---|---|
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.
| Name | Required | Description | Default |
|---|---|---|---|
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.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
28 tool updates
v0.4.2- First observed
bank_deposit_share - First observed
charity_sector_health - First observed
cost_of_living - First observed
describe_dataset - First observed
economic_dashboard - First observed
energy_snapshot - First observed
gender_pay_context - First observed
get_data - First observed
health - First observed
housing_affordability - First observed
inflation_decomposition - First observed
list_datasets - First observed
macro_snapshot_state - First observed
nem_dispatch_5min - First observed
real_cash_rate - First observed
real_mortgage_rate - First observed
real_savings_rate - First observed
real_wages - First observed
regional_cost_of_living - First observed
release_pulse - First observed
releases - First observed
search_datasets - First observed
sectoral_employment_shift - First observed
state_fiscal_snapshot - First observed
super_fund_real_return - First observed
trade_balance - First observed
wage_vs_rent_gap - First observed
youth_unemployment
TDQS
Scored across 28 tools
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.
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.
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.
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
Related MCP Connectors
Australian Bureau of Statistics (ABS) Data API MCP.
This MCP server provides seamless access to Malaysia's government open data, including datasets, w…
data.gov.au MCP — Australia open-data CKAN catalogue.
RBA MCP — Reserve Bank of Australia statistics (free, no auth).
Related MCP Servers
- FlicenseCqualityBmaintenanceProvides access to the Australian Bureau of Statistics (ABS) Data API. This server allows AI assistants to query and analyze ABS statistical data.19-
- AlicenseAqualityAmaintenanceMCP 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).1489 PyPI5MIT
- AlicenseBqualityDmaintenanceMCP server with 562 tools accessing 114 government data APIs covering economic, health, education, energy, and more from federal, state, and international sources.100414 npm1MIT
- AlicenseAqualityDmaintenanceA local MCP server for public Reserve Bank of Australia data, exposing six read-only tools backed by the R package readrba.6MIT