Skip to main content

MCP server for the Reserve Bank of Australia statistical tables (F-tables). Plain-English access to interest rates, FX rates, deposit/lending rates.

Project description

rba-mcp

tests PyPI Python License: MIT Glama MCP server quality

Ask Claude about Australian interest rates, exchange rates, and lending rates and get real, current numbers — not "I don't have access to that data." This MCP server gives Claude (and other MCP clients like Cursor) live access to the Reserve Bank of Australia's statistical tables, with curated mappings for the most-asked indicators.

rba-mcp answering "Show me AUD against USD, EUR, GBP and the trade-weighted index since 2024" in Claude Desktop — four metric cards, rebased line chart, macro-context analysis

Companion to abs-mcp (ABS macro stats) and ato-mcp (ATO tax + ACNC charity data) — together the three cover the most-asked Australian official data.

What you can ask

Once installed, your LLM can answer questions like:

Question Real response
What's the current RBA cash rate? RBA Cash Rate Target, latest month
What's AUD/USD today? Latest daily exchange rate
Show me AUD vs major currencies in 2024 Multi-series query with monthly observations
What's the average mortgage rate? Owner-occupier variable, outstanding loans
What rate are 12-month term deposits at? Latest from F4
What's the trade-weighted index trend? TWI series back to 1983

Every answer comes with the period, units (Per cent per annum, USD per AUD, etc.), and a link back to the RBA source.

Install

# After publish:
uvx --upgrade rba-mcp

# Local dev:
uv pip install -e .

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Why --upgrade? uvx rba-mcp (without the flag) uses whatever wheel is cached and never adopts new PyPI releases on its own — Claude Desktop's MCP child process keeps running the same wheel until you fully quit the app and refresh the cache by hand. --upgrade makes uvx check PyPI on each launch and pull a newer release if one exists. Recommended for everyone except offline-first / pinned-version workflows. To verify which version is currently serving you, look at the server_version field on any DataResponse (added in 0.1.5).

If you also have abs-mcp installed, both servers run side-by-side. Claude disambiguates with the server prefix (rba:get_data vs abs:get_data).

For local dev (pre-PyPI):

{
  "mcpServers": {
    "rba": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/rba-mcp", "rba-mcp"]
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json (or workspace .cursor/mcp.json):

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

Tools

Tool What it does
search_tables(query, limit=10) Fuzzy-search RBA F-tables by name or topic.
describe_table(table_id) Plain-English series listing for one F-table.
get_data(table_id, series, start_date, end_date, format) Query data. series=None returns all curated series; format = records / series / csv.
latest(table_id, series) Most-recent observation for the requested series.
list_curated() The 5 F-table IDs with hand-curated plain-English support.

Curated F-tables

For these five, series accepts plain-English keys (e.g. "aud_usd" instead of "FXRUSD"):

  • F1.1 — Money Market — Monthly: cash rate target, cash rate, bank bills, OIS rates, treasury notes
  • F4 — Retail Deposit & Investment Rates: transaction accounts, savings, term deposits, cash management trusts
  • F6 — Housing Lending Rates: owner-occupier vs investor, variable vs fixed, outstanding vs new loans
  • F11 — Exchange Rates — Monthly History (1983+): AUD/USD, AUD/EUR, AUD/GBP, AUD/JPY, AUD/CNY, AUD/NZD, TWI
  • F11.1 — Exchange Rates — Daily (2023+): same series, daily resolution

Any other F-table works too — pass raw RBA series IDs (e.g. "FXRUSD") instead of curated keys.

Worked examples

"What's the current RBA cash rate?"

latest(table_id="F1.1", series="cash_rate_target")

"AUD to USD over the last year"

get_data(table_id="F11.1", series="aud_usd", start_date="2024")

"Compare AUD against USD, EUR and GBP since 2020"

get_data(
  table_id="F11",
  series=["aud_usd", "aud_eur", "aud_gbp"],
  start_date="2020"
)

Period formats

RBA series use ISO-style date formats. Pass start_date / end_date as:

Format Example Use for
YYYY "2024" Year start
YYYY-MM "2024-03" Month start
YYYY-MM-DD "2024-03-15" Specific day (daily tables only)

Development

git clone https://github.com/Bigred97/rba-mcp.git
cd rba-mcp
uv sync --extra dev
uv pip install -e .

# Unit tests (no network)
uv run pytest

# Live integration tests (hits RBA CDN)
uv run pytest -m live

The SQLite cache lives at ~/.rba-mcp/cache.db. Data refreshes every 6h, latest 15min. Delete to force a refresh.

How it works

Claude picks the right tool, fills in the curated series keys, calls the live RBA CDN, and synthesises the answer. When the curated table is stale relative to a rate decision (RBA's monthly F1.1 publishes around the 5th business day, but Board meetings can hike between publications), Claude fluidly composes web-search results with this server's data:

Claude querying rba-mcp for cash rate, noticing the F1.1 monthly is at 4.10%, and web-searching to learn the Board hiked 25bp at the 5 May meeting → reports 4.35% effective 6 May 2026 with citations

You don't have to know what FIRMMCRT or FXRUSD mean — and neither does Claude. The server's curated YAMLs map plain-English keys (cash_rate_target, aud_usd) to RBA series IDs and surface unit attribution + the CC-BY 4.0 attribution string in every response.

Sister servers

The three packages run side-by-side in any MCP client; Claude disambiguates via the server prefix (rba:latest vs abs:latest vs ato:get_data).

  • abs-mcp — Australian Bureau of Statistics. Labour force, CPI, GDP, wages, housing approvals, lending, population.
  • ato-mcp — Australian Taxation Office + ACNC. Personal tax by postcode, company tax by industry, corporate tax transparency for every $100M+ entity, super contributions by age, live charity register.

See examples/claude_desktop_config_both.json for an example multi-server config.

Data attribution

RBA data is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0). Every DataResponse from this server includes an attribution field with the required notice. If you redistribute responses, credit the RBA.

Changelog

See CHANGELOG.md for release history.

License

MIT — Harry Vass, 2026.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rba_mcp-0.1.8.tar.gz (789.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

rba_mcp-0.1.8-py3-none-any.whl (33.4 kB view details)

Uploaded Python 3

File details

Details for the file rba_mcp-0.1.8.tar.gz.

File metadata

  • Download URL: rba_mcp-0.1.8.tar.gz
  • Upload date:
  • Size: 789.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for rba_mcp-0.1.8.tar.gz
Algorithm Hash digest
SHA256 f7969c0cc671a052033b8f9fc2c84af4cbddc2a76b748f9f4e00ff762efc707f
MD5 fba5359ac0635261b45af053bfb68387
BLAKE2b-256 5bce55f8db080c6b0a65723ac5db2e872a45a0ac433e97ef02abbd2dc2bffbaa

See more details on using hashes here.

Provenance

The following attestation bundles were made for rba_mcp-0.1.8.tar.gz:

Publisher: release.yml on Bigred97/rba-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file rba_mcp-0.1.8-py3-none-any.whl.

File metadata

  • Download URL: rba_mcp-0.1.8-py3-none-any.whl
  • Upload date:
  • Size: 33.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for rba_mcp-0.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 7fe1a4b5a0931aece5c12b815e8d2e55b1a82d440ad57c3a606e4ac1d8ab76e1
MD5 3e8111601f68da4c5b358170c4cbd2fe
BLAKE2b-256 e6f726e6887f35c6ec081834c45dddac5caded5e8a4227af13b989e2a49de9f0

See more details on using hashes here.

Provenance

The following attestation bundles were made for rba_mcp-0.1.8-py3-none-any.whl:

Publisher: release.yml on Bigred97/rba-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page