apra-mcp

MCP server for Australian Prudential Regulation Authority statistics. Plain-English access to per-bank capital ratios, fund-by-fund superannuation, and post-AASB17 life + general insurance — every prudentially-regulated entity in Australia, every quarter, from a single uvx command.

"What's CBA's CET1 ratio?"
"Which super fund has the most members?"
"Top 10 banks by total capital, latest quarter"
"Gross written premium for the general insurance industry, post-AASB17"
"Largest life insurance product groups by claims"

Sister to abs-mcp, rba-mcp, ato-mcp, and au-weather-mcp.

Install

uvx --upgrade apra-mcp

Claude Desktop

{
  "mcpServers": {
    "apra": { "command": "uvx", "args": ["--upgrade", "apra-mcp"] }
  }
}

Claude Code

claude mcp add apra --command uvx --args -- --upgrade apra-mcp

What it exposes

Six tools, all plain-English in, structured out:

Every response is the same shape — dataset_id, dataset_name, query, period, unit, row_count, records, apra_url, download_url, framework (insurance only), attribution, stale flag, server_version — across every curated dataset.

Curated datasets (7 in v0.1)

Reliability — 3-tier URL resolution

APRA publishes XLSX at date-versioned paths that change every quarter. apra-mcp resolves them through three tiers:

1. Live scrape — fetch the canonical APRA landing page (with ETag conditional-GET so refreshes between releases cost zero bytes), regex-extract the .xlsx href matching the dataset's filename pattern, pick the latest-dated match. Cached 6h.

2. Bundled seed manifest — when the live scrape fails, fall back to data/seed_urls.json shipped in the wheel. CI refreshes the manifest daily. The response is flagged stale: true with an honest reason.

3. YAML default — last-resort URL from the curated YAML.

Net effect: a fresh uvx apra-mcp always gets the current quarter; a 3-month-old install still works because the seed manifest is refreshed and --upgrade pulls a new wheel.

Framework break (insurance only)

APRA changed the reporting framework on 1 July 2023 (AASB 17 Insurance Contracts + capital framework revision). Pre- and post-break data are not directly comparable — APRA's own guidance is explicit. apra-mcp ships paired datasets:

• INSURANCE_GENERAL (post-AASB17) + INSURANCE_GENERAL_HISTORICAL (pre-AASB17)

• LIFE_INSURANCE (post-AASB17) + LIFE_INSURANCE_HISTORICAL (pre-AASB17)

Every response on an insurance dataset includes a framework block surfacing the break + a historical_dataset cross-reference, so agents see the warning before splicing series.

Attribution

Data sourced from the Australian Prudential Regulation Authority. Licensed under Creative Commons Attribution 4.0 International (CC BY 4.0). apra-mcp is MIT-licensed; APRA's data carries the upstream CC-BY 4.0 license, echoed in every response's attribution field.

Sister packages

• abs-mcp — ABS census + economic statistics

• rba-mcp — RBA F-tables (cash rate, FX rates, mortgage rates)

• ato-mcp — ATO tax statistics + ACNC charities register

• apra-mcp — this one. Banks, super, insurance.

• au-weather-mcp — Australian weather

Development

git clone https://github.com/Bigred97/apra-mcp.git
cd apra-mcp
uv venv
uv pip install -e ".[dev]"
pytest                  # unit tests
pytest -m live          # integration tests against apra.gov.au

Issues and contributions welcome: github.com/Bigred97/apra-mcp/issues.