Skip to content

AnthonyPuggs/ausecon-mcp-server

Repository files navigation

Australian Economic Data (RBA & ABS) MCP Server

CI Release Docs PyPI Transport License-MIT

ausecon-mcp-server is a Python Model Context Protocol (MCP) server for structured Australian macroeconomic and financial data from the Australian Bureau of Statistics (ABS) and the Reserve Bank of Australia (RBA).

Version 1.0.0 is the stable release baseline. The server exposes eight read-only MCP tools, four read-only MCP resources, eight prompt templates, and 29 curated macroeconomic concepts for analyst-friendly retrieval through get_economic_series.

Documentation

Full user and maintainer documentation is published at anthonypuggs.github.io/ausecon-mcp-server.

Useful links:

Install

The package is published to PyPI and is intended to be launched by an MCP client on demand via uvx:

uvx ausecon-mcp-server

The server speaks MCP over standard input/output. When launched manually, it waits for a client to connect.

Client Setup

Claude Desktop:

{
  "mcpServers": {
    "ausecon": {
      "command": "uvx",
      "args": ["ausecon-mcp-server"]
    }
  }
}

Claude Code:

claude mcp add --transport stdio ausecon -- uvx ausecon-mcp-server

Codex:

codex mcp add ausecon -- uvx ausecon-mcp-server

Basic Workflow

For normal economic concepts, discover the supported concept first:

list_economic_concepts(query="cash rate")

Then retrieve the resolved series:

get_economic_series(
  concept="cash_rate_target",
  start="2020-01-01"
)

For exact ABS/RBA control, use search_datasets, list_catalogue, get_abs_dataset_structure, get_abs_data, and get_rba_table.

Development

Python 3.12 is recommended for local development. The package metadata and CI matrix support Python 3.10+.

uv sync --python 3.12 --extra dev
uv run pytest
uv run ruff check src tests scripts

Repository

About

MCP server for Reserve Bank of Australia (RBA) and Australian Bureau of Statistics (ABS) economic data

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages