Metadata-Version: 2.4
Name: ausecon-mcp-server
Version: 1.1.0
Summary: MCP server for Australian economic data from the ABS and RBA.
Project-URL: Homepage, https://anthonypuggs.github.io/ausecon-mcp-server/
Project-URL: Documentation, https://anthonypuggs.github.io/ausecon-mcp-server/
Project-URL: Repository, https://github.com/AnthonyPuggs/ausecon-mcp-server
Project-URL: Issues, https://github.com/AnthonyPuggs/ausecon-mcp-server/issues
Author: Anthony P
License: MIT License
        
        Copyright (c) 2026 Anthony P
        
        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.
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: fastmcp>=3.2.4
Requires-Dist: httpx<1,>=0.27
Requires-Dist: platformdirs<5,>=4.0
Requires-Dist: pydantic<3,>=2
Requires-Dist: starlette<1,>=0.27
Provides-Extra: dev
Requires-Dist: jsonschema<5,>=4.26; extra == 'dev'
Requires-Dist: pytest-asyncio<2,>=0.24; extra == 'dev'
Requires-Dist: pytest<10,>=9.0.3; extra == 'dev'
Requires-Dist: respx<1,>=0.22; extra == 'dev'
Requires-Dist: ruff<1,>=0.9; extra == 'dev'
Requires-Dist: tomli>=2.0; (python_version < '3.11') and extra == 'dev'
Description-Content-Type: text/markdown

# Australian Economic Data (RBA & ABS) MCP Server

<!-- mcp-name: io.github.AnthonyPuggs/ausecon-mcp-server -->

[![CI](https://github.com/AnthonyPuggs/ausecon-mcp-server/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/AnthonyPuggs/ausecon-mcp-server/actions/workflows/ci.yml)
[![Release](https://img.shields.io/github/v/tag/AnthonyPuggs/ausecon-mcp-server?sort=semver&label=release)](https://github.com/AnthonyPuggs/ausecon-mcp-server/tags)
[![Docs](https://img.shields.io/badge/docs-GitHub%20Pages-blue)](https://anthonypuggs.github.io/ausecon-mcp-server/)
[![PyPI](https://img.shields.io/pypi/v/ausecon-mcp-server?label=PyPI)](https://pypi.org/project/ausecon-mcp-server/)
[![Transport](https://img.shields.io/badge/Transport-stdio%20%2B%20HTTP-blue)]()
[![License-MIT](https://img.shields.io/badge/License-MIT-lightgrey)]()

`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](https://anthonypuggs.github.io/ausecon-mcp-server/).

Useful links:

- [Getting started](https://anthonypuggs.github.io/ausecon-mcp-server/getting-started/)
- [Client setup](https://anthonypuggs.github.io/ausecon-mcp-server/client-setup/)
- [Tool reference](https://anthonypuggs.github.io/ausecon-mcp-server/reference/tools/)
- [Semantic concepts](https://anthonypuggs.github.io/ausecon-mcp-server/reference/semantic-concepts/)
- [Response schema](https://anthonypuggs.github.io/ausecon-mcp-server/reference/response-schema/)
- [Changelog](CHANGELOG.md)

## Install

The package is published to [PyPI](https://pypi.org/project/ausecon-mcp-server/) and is intended to
be launched by an MCP client on demand via [`uvx`](https://docs.astral.sh/uv/):

```bash
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:

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

Claude Code:

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

Codex:

```bash
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.

## Basic Workflow

For normal economic concepts, discover the supported concept first:

```text
list_economic_concepts(query="cash rate")
```

Then retrieve the resolved series:

```text
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+.

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

## Repository

- Repository: [github.com/AnthonyPuggs/ausecon-mcp-server](https://github.com/AnthonyPuggs/ausecon-mcp-server)
- Issues: [GitHub Issues](https://github.com/AnthonyPuggs/ausecon-mcp-server/issues)
- Licence: [MIT](LICENSE)
