# rba-mcp

> MCP server exposing Reserve Bank of Australia statistical F-tables through 5 plain-English tools — cash rate, exchange rates, mortgage rates, term deposit rates, money-market yields.

rba-mcp is the Reserve Bank of Australia (RBA) member of the Australian Public Data MCP portfolio. It wraps RBA's F-table CSV statistical tables at rba.gov.au/statistics/tables — `search_tables`, `describe_table`, `get_data`, `latest`, `list_curated`. The tool names diverge from sister-MCP convention (`_tables` instead of `_datasets`) by design because the data shape is tables, not datasets.

5 curated F-tables cover the most-asked indicators (F1.1 money market / cash rate, F4 retail deposit and investment rates, F6 housing lending rates, F11 monthly FX history, F11.1 daily FX). Plain-English series keys (`cash_rate_target`, `aud_usd`) translate to canonical RBA series IDs (`FIRMMCRT`, `FXRUSD`). Other F-tables remain accessible via raw series IDs. Every response carries CC-BY 4.0 International attribution.

## Documentation

- [README](https://github.com/Bigred97/rba-mcp/blob/main/README.md): Full setup + 5-tool usage + worked examples
- [CHANGELOG](https://github.com/Bigred97/rba-mcp/blob/main/CHANGELOG.md): Release history
- [PyPI](https://pypi.org/project/rba-mcp/): `uvx --upgrade rba-mcp`

## Tools

- 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; for curated tables shows curated keys, for raw tables fetches the CSV and lists series IDs with units + start dates
- get_data(table_id, series, start_date, end_date, format): Query a table. `series=None` returns all curated series. Multi-series via list. 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

## Example queries

- "What's the current RBA cash rate?"
- "What's the 3-month bank bill yield?"
- "AUD/USD today"
- "Trade-weighted index"
- "Average mortgage rate (owner-occupier variable)"
- "12-month term deposit rate"
- "Show me AUD vs USD, EUR, GBP and TWI since 2020"

## Optional

- [Sister MCPs](https://github.com/Bigred97?tab=repositories&q=mcp): Other AU public-data MCPs in the portfolio
- [aus-identity](https://pypi.org/project/aus-identity/): Postcode/state normalisation used across sisters (RBA's F-tables are mostly national-aggregate, so state filtering is rarely needed)
