rba-mcp 0.1.0__tar.gz

rba_mcp-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,47 @@
+name: tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+      - name: Sync dependencies
+        run: uv sync --extra dev
+      - name: Install package
+        run: uv pip install -e .
+      - name: Run unit tests
+        run: uv run pytest -q
+
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+      - name: Build wheel + sdist
+        run: uv build
+      - name: Verify wheel installs cleanly
+        run: |
+          uv run --isolated --with ./dist/*.whl python -c \
+            "import rba_mcp.server as s; n = len(s.list_curated()); assert n >= 5, f'expected >=5 curated, got {n}'; print(f'OK ({n} curated tables)')"
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/

rba_mcp-0.1.0/.gitignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+.eggs/
+build/
+dist/
+.venv/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+*.swp
+.DS_Store
+.env

rba_mcp-0.1.0/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## 0.1.0 (2026-05-11)
+
+Initial release. MCP server for RBA F-tables; companion to `abs-mcp`.
+
+- 5 MCP tools: `search_tables`, `describe_table`, `get_data`, `latest`, `list_curated`
+- 5 curated F-tables with plain-English series mappings: **F1.1** (money market — cash rate), **F4** (deposit rates), **F6** (housing lending rates), **F11** (FX monthly history), **F11.1** (FX daily current)
+- 14 non-curated F-tables accessible via raw RBA series IDs
+- Label-driven CSV header parser (resilient to RBA adding new metadata rows)
+- SQLite-backed cache (6h data TTL, 15min latest TTL)
+- Unit attribution per series (Per cent per annum / USD per AUD / Index / etc.)
+- CC-BY 4.0 attribution surfaced in every response
+- Input validation guards (URL-injection-safe)
+- 76 unit tests + 21 live integration tests

rba_mcp-0.1.0/LICENSE

@@ -0,0 +1,28 @@
+MIT License
+
+Copyright (c) 2026 Harry Vass
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Note on RBA data: this software fetches statistical tables published by the
+Reserve Bank of Australia. RBA data is licensed under Creative Commons
+Attribution 4.0 International (CC BY 4.0) — see https://www.rba.gov.au/copyright/.
+End-users redistributing data fetched via this server must credit the RBA.

rba_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,192 @@
+Metadata-Version: 2.4
+Name: rba-mcp
+Version: 0.1.0
+Summary: MCP server for the Reserve Bank of Australia statistical tables (F-tables). Plain-English access to interest rates, FX rates, deposit/lending rates.
+Project-URL: Homepage, https://github.com/Bigred97/rba-mcp
+Project-URL: Issues, https://github.com/Bigred97/rba-mcp/issues
+Author: Harry Vass
+License: MIT
+License-File: LICENSE
+Keywords: australia,claude,fastmcp,fx,interest-rates,mcp,rba
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Requires-Python: >=3.11
+Requires-Dist: aiosqlite>=0.20
+Requires-Dist: fastmcp<4,>=2.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: pandas<3,>=2.2
+Requires-Dist: pydantic>=2.7
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rapidfuzz>=3.9
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# rba-mcp
+
+[![tests](https://github.com/Bigred97/rba-mcp/actions/workflows/test.yml/badge.svg)](https://github.com/Bigred97/rba-mcp/actions/workflows/test.yml)
+[![PyPI](https://img.shields.io/pypi/v/rba-mcp.svg)](https://pypi.org/project/rba-mcp/)
+[![Python](https://img.shields.io/pypi/pyversions/rba-mcp.svg)](https://pypi.org/project/rba-mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+**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](https://www.rba.gov.au/statistics/tables/), with curated mappings for the most-asked indicators.
+
+Companion to [abs-mcp](https://github.com/Bigred97/abs-mcp) — together they cover the most-asked Australian economic 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
+
+```bash
+# After publish:
+uvx rba-mcp
+
+# Local dev:
+uv pip install -e .
+```
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "rba": {
+      "command": "uvx",
+      "args": ["rba-mcp"]
+    }
+  }
+}
+```
+
+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):
+
+```json
+{
+  "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`):
+
+```json
+{
+  "mcpServers": {
+    "rba": {
+      "command": "uvx",
+      "args": ["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
+
+```bash
+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.
+
+## Data attribution
+
+RBA data is licensed under [Creative Commons Attribution 4.0 International (CC BY 4.0)](https://www.rba.gov.au/copyright/). Every `DataResponse` from this server includes an `attribution` field with the required notice. If you redistribute responses, credit the RBA.
+
+## License
+
+MIT — Harry Vass, 2026.

rba_mcp-0.1.0/README.md

@@ -0,0 +1,161 @@
+# rba-mcp
+
+[![tests](https://github.com/Bigred97/rba-mcp/actions/workflows/test.yml/badge.svg)](https://github.com/Bigred97/rba-mcp/actions/workflows/test.yml)
+[![PyPI](https://img.shields.io/pypi/v/rba-mcp.svg)](https://pypi.org/project/rba-mcp/)
+[![Python](https://img.shields.io/pypi/pyversions/rba-mcp.svg)](https://pypi.org/project/rba-mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+**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](https://www.rba.gov.au/statistics/tables/), with curated mappings for the most-asked indicators.
+
+Companion to [abs-mcp](https://github.com/Bigred97/abs-mcp) — together they cover the most-asked Australian economic 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
+
+```bash
+# After publish:
+uvx rba-mcp
+
+# Local dev:
+uv pip install -e .
+```
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "rba": {
+      "command": "uvx",
+      "args": ["rba-mcp"]
+    }
+  }
+}
+```
+
+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):
+
+```json
+{
+  "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`):
+
+```json
+{
+  "mcpServers": {
+    "rba": {
+      "command": "uvx",
+      "args": ["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
+
+```bash
+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.
+
+## Data attribution
+
+RBA data is licensed under [Creative Commons Attribution 4.0 International (CC BY 4.0)](https://www.rba.gov.au/copyright/). Every `DataResponse` from this server includes an `attribution` field with the required notice. If you redistribute responses, credit the RBA.
+
+## License
+
+MIT — Harry Vass, 2026.

rba_mcp-0.1.0/glama.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://glama.ai/mcp/schemas/server.json",
+  "maintainers": ["Bigred97"]
+}

rba_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "rba-mcp"
+version = "0.1.0"
+description = "MCP server for the Reserve Bank of Australia statistical tables (F-tables). Plain-English access to interest rates, FX rates, deposit/lending rates."
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [{ name = "Harry Vass" }]
+keywords = ["mcp", "rba", "australia", "interest-rates", "fx", "claude", "fastmcp"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+]
+dependencies = [
+    "fastmcp>=2.0,<4",
+    "httpx>=0.27",
+    "pydantic>=2.7",
+    "rapidfuzz>=3.9",
+    "pandas>=2.2,<3",
+    "aiosqlite>=0.20",
+    "PyYAML>=6.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8",
+    "pytest-asyncio>=0.23",
+    "respx>=0.21",
+]
+
+[project.scripts]
+rba-mcp = "rba_mcp.server:main"
+
+[project.urls]
+Homepage = "https://github.com/Bigred97/rba-mcp"
+Issues = "https://github.com/Bigred97/rba-mcp/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/rba_mcp"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+markers = ["live: hits the real RBA CDN"]
+addopts = "-m 'not live'"
+testpaths = ["tests"]
+pythonpath = ["src"]

rba_mcp-0.1.0/src/rba_mcp/__init__.py

@@ -0,0 +1,6 @@
+from importlib.metadata import PackageNotFoundError, version as _version
+
+try:
+    __version__ = _version("rba-mcp")
+except PackageNotFoundError:  # editable install before metadata is generated
+    __version__ = "0.0.0+unknown"

rba_mcp-0.1.0/src/rba_mcp/cache.py

@@ -0,0 +1,95 @@
+"""SQLite-backed HTTP cache with per-read TTL.
+
+Single table; the same row can satisfy different TTL windows because TTL is
+evaluated at read time. The `kind` column lets us run targeted invalidation
+later without renaming.
+
+Ported from abs-mcp 0.2.8 — only differences:
+- DEFAULT_DB_PATH points at ~/.rba-mcp/
+- CacheKind enum reduced to {"data", "latest"} (no SDMX catalogue/datastructure)
+- Default TTLs tuned for RBA's daily-CDN refresh cadence
+"""
+from __future__ import annotations
+
+import asyncio
+import time
+from datetime import timedelta
+from pathlib import Path
+from typing import Literal
+
+import aiosqlite
+
+CacheKind = Literal["data", "latest"]
+
+DEFAULT_DB_PATH = Path.home() / ".rba-mcp" / "cache.db"
+
+TTL: dict[CacheKind, timedelta] = {
+    "data": timedelta(hours=6),     # RBA refreshes mid-morning Sydney for daily tables
+    "latest": timedelta(minutes=15),  # post-publication freshness window
+}
+
+_SCHEMA = """
+CREATE TABLE IF NOT EXISTS http_cache (
+    cache_key  TEXT PRIMARY KEY,
+    payload    BLOB NOT NULL,
+    cached_at  REAL NOT NULL,
+    kind       TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_kind_cached_at ON http_cache(kind, cached_at);
+"""
+
+
+class Cache:
+    def __init__(self, db_path: Path = DEFAULT_DB_PATH) -> None:
+        self.db_path = db_path
+        self.db_path.parent.mkdir(parents=True, exist_ok=True)
+        self._initialized = False
+        self._init_lock = asyncio.Lock()
+
+    async def _ensure_init(self) -> None:
+        if self._initialized:
+            return
+        async with self._init_lock:
+            if self._initialized:
+                return
+            async with aiosqlite.connect(self.db_path) as conn:
+                await conn.execute("PRAGMA journal_mode=WAL")
+                await conn.executescript(_SCHEMA)
+                await conn.commit()
+            self._initialized = True
+
+    async def get(self, key: str, ttl: timedelta) -> bytes | None:
+        await self._ensure_init()
+        cutoff = time.time() - ttl.total_seconds()
+        async with aiosqlite.connect(self.db_path) as conn:
+            async with conn.execute(
+                "SELECT payload FROM http_cache WHERE cache_key = ? AND cached_at >= ?",
+                (key, cutoff),
+            ) as cur:
+                row = await cur.fetchone()
+        return row[0] if row else None
+
+    async def set(self, key: str, value: bytes, kind: CacheKind) -> None:
+        await self._ensure_init()
+        async with aiosqlite.connect(self.db_path) as conn:
+            await conn.execute(
+                """
+                INSERT INTO http_cache (cache_key, payload, cached_at, kind)
+                VALUES (?, ?, ?, ?)
+                ON CONFLICT(cache_key) DO UPDATE SET
+                    payload = excluded.payload,
+                    cached_at = excluded.cached_at,
+                    kind = excluded.kind
+                """,
+                (key, value, time.time(), kind),
+            )
+            await conn.commit()
+
+    async def clear(self, kind: CacheKind | None = None) -> None:
+        await self._ensure_init()
+        async with aiosqlite.connect(self.db_path) as conn:
+            if kind:
+                await conn.execute("DELETE FROM http_cache WHERE kind = ?", (kind,))
+            else:
+                await conn.execute("DELETE FROM http_cache")
+            await conn.commit()