Skip to main content

MCP server for Australian economic data from the ABS, RBA, and APRA.

Project description

Australian Economic Data (ABS, RBA & APRA) MCP Server

CI Release
Smithery 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), the Reserve Bank of Australia (RBA), and the Australian Prudential Regulation Authority (APRA).

Version 1.5.0 is the current release line. Transport support is stdio plus Streamable HTTP. The server exposes fourteen read-only MCP tools, four read-only MCP resources, eight prompt templates, 70 curated analyst-facing economic and financial concepts through get_economic_series, and nine transparent derived indicators through get_derived_series.

Documentation

Full user and maintainer documentation is published at auseconmcp.com.

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

Smithery:

This repository also includes smithery.yaml and Dockerfile.smithery for hosted Smithery custom container deployment over MCP Streamable HTTP at /mcp. The hosted HTTP entrypoint is ausecon-mcp-http; local users should keep using the stdio command above unless they are testing a container deployment. Maintainers can follow the deployment checklist in docs/smithery-deployment.md.

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 transparent formula-based indicators, call the derived retrieval surface directly:

get_derived_series(concept="real_cash_rate", last_n=12)

For exact source-native control, use search_datasets, list_catalogue, get_abs_dataset_structure, get_abs_data, get_rba_table, and get_apra_data.

For quick-turnaround analysis, use get_latest_observations, get_top_observations, describe_dataset, and list_release_events as additive convenience tools. These wrappers keep native ABS, RBA, and APRA identifiers visible.

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

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

ausecon_mcp_server-1.6.0.tar.gz (337.0 kB view details)

Uploaded Source

Built Distribution

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

ausecon_mcp_server-1.6.0-py3-none-any.whl (88.2 kB view details)

Uploaded Python 3

File details

Details for the file ausecon_mcp_server-1.6.0.tar.gz.

File metadata

  • Download URL: ausecon_mcp_server-1.6.0.tar.gz
  • Upload date:
  • Size: 337.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for ausecon_mcp_server-1.6.0.tar.gz
Algorithm Hash digest
SHA256 eb543b1e928e9e8d98093a0d561c25cf1c6feeeca002fda3bc1edad3ac5b5a10
MD5 fde6a5354c70245b3d6ce1530728401c
BLAKE2b-256 45638f5feb900373f37c39843f0fa4860feb185abfbd95f102af1bdd04888d2a

See more details on using hashes here.

Provenance

The following attestation bundles were made for ausecon_mcp_server-1.6.0.tar.gz:

Publisher: release.yml on AnthonyPuggs/ausecon-mcp-server

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

File details

Details for the file ausecon_mcp_server-1.6.0-py3-none-any.whl.

File metadata

File hashes

Hashes for ausecon_mcp_server-1.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 22048256dd5a21e0bf6dd9febee829c6c75f0acf49da6e4f8890d1a731ed7e34
MD5 14005183df5e855a27daa55189fd0b6d
BLAKE2b-256 77687b9c2b57b6a58c4e87cc437a7e2d4bc2d4b610042875121208d351e8c61d

See more details on using hashes here.

Provenance

The following attestation bundles were made for ausecon_mcp_server-1.6.0-py3-none-any.whl:

Publisher: release.yml on AnthonyPuggs/ausecon-mcp-server

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