npm ausdata-mcpstdioMITupdated 24d ago
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.
What can you do with ausdata io โ Australian Public Data?
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).
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:
- 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 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.
Install
Add ausdata io โ Australian Public Data to your client. Pick the one you use.
claude mcp add ausdata-mcp -- npx -y ausdata-mcpcodex mcp add ausdata-mcp -- npx -y ausdata-mcpamp mcp add ausdata-mcp -- npx -y ausdata-mcp{
"mcpServers": {
"ausdata-mcp": {
"command": "npx",
"args": [
"-y",
"ausdata-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"ausdata-mcp": {
"command": "npx",
"args": [
"-y",
"ausdata-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"ausdata-mcp","command":"npx","args":["-y","ausdata-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"ausdata-mcp": {
"command": "npx",
"args": [
"-y",
"ausdata-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"ausdata-mcp": {
"command": "npx",
"args": [
"-y",
"ausdata-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"ausdata-mcp": {
"command": "npx",
"args": [
"-y",
"ausdata-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"ausdata-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"ausdata-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"ausdata-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"ausdata-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y ausdata-mcpRun `goose configure`, choose **Add Extension โ Command-line Extension**, and paste this command.
13 tools
ausdata io โ Australian Public Data exposes 13 tools to a connected agent.
- 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.
- 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.
Score
77 / 100
Good
- Documentation25/25
- Maintenance19/25
- Trust13/20
- Capability8/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 17 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 13 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint โ no local install
Version history
| Versions | Published |
|---|---|
| 0.4.5Latest | Aug 14, 2026 |
| 0.4.2 | May 20, 2026 |