Metadata-Version: 2.4
Name: ausecon-mcp-server
Version: 1.8.0
Summary: MCP server for Australian economic data from the ABS, RBA, and APRA.
Project-URL: Homepage, https://auseconmcp.com/
Project-URL: Documentation, https://auseconmcp.com/
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: openpyxl<4,>=3.1
Requires-Dist: platformdirs<5,>=4.0
Requires-Dist: pydantic<3,>=2
Requires-Dist: starlette<2,>=0.27
Requires-Dist: uvicorn<1,>=0.35
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: pyyaml<7,>=6.0; 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

<div align="center">

<img src="assets/banner.svg" alt="ausecon — Australian economic & financial data MCP server" width="100%" />

<br/>

[![CI](https://img.shields.io/github/actions/workflow/status/AnthonyPuggs/ausecon-mcp-server/ci.yml?branch=main&label=CI&labelColor=41464d&color=0a7d33)](https://github.com/AnthonyPuggs/ausecon-mcp-server/actions)
[![PyPI](https://img.shields.io/pypi/v/ausecon-mcp-server?label=PyPI&labelColor=41464d&color=0969da)](https://pypi.org/project/ausecon-mcp-server/)
[![Python](https://img.shields.io/badge/python-3.10%2B-0b2a52?labelColor=41464d)](https://pypi.org/project/ausecon-mcp-server/)
[![Transport](https://img.shields.io/badge/transport-stdio%20%C2%B7%20HTTP-0b2a52?labelColor=41464d)](#connect-your-client)
[![License](https://img.shields.io/badge/license-MIT-6a737d?labelColor=41464d)](LICENSE)

<p>
  <b>ausecon</b> is a Model Context Protocol server that gives any AI assistant clean, structured
  access to Australia&rsquo;s core economic and financial data &mdash; straight from the
  <b>ABS</b>, <b>RBA</b>, and <b>APRA</b>.
</p>

<a href="https://auseconmcp.com"><b>Documentation</b></a> &nbsp;·&nbsp;
<a href="https://auseconmcp.com/getting-started">Getting started</a> &nbsp;·&nbsp;
<a href="https://auseconmcp.com/tools">Tool reference</a> &nbsp;·&nbsp;
<a href="https://github.com/AnthonyPuggs/ausecon-mcp-server/blob/main/CHANGELOG.md">Changelog</a>

</div>

---

## Why this exists

Australian economic data is authoritative but awkward to reach &mdash; different portals, different
formats, and identifiers you have to memorise. **ausecon** puts a friendly, consistent layer in
front of all three regulators so you (or your AI agent) can just ask for *&ldquo;the cash rate&rdquo;*
or *&ldquo;quarterly real GDP growth&rdquo;* and get back tidy, source-traceable series &mdash;
without leaving the conversation.

<table align="center">
  <tr>
    <td align="center"><b>14</b><br/><sub>read-only tools</sub></td>
    <td align="center"><b>70</b><br/><sub>economic concepts</sub></td>
    <td align="center"><b>9</b><br/><sub>derived indicators</sub></td>
    <td align="center"><b>8</b><br/><sub>prompt templates</sub></td>
    <td align="center"><b>3</b><br/><sub>data sources</sub></td>
  </tr>
</table>

## What you get

<table>
  <tr>
    <td width="33%" valign="top">
      <h4>🔎 Ask in plain English</h4>
      Discover concepts with <code>list_economic_concepts</code>, then pull resolved series by
      name &mdash; no dataset IDs required.
    </td>
    <td width="33%" valign="top">
      <h4>🧱 Three sources, one shape</h4>
      ABS, RBA and APRA all return the same tidy
      <code>metadata · series · observations</code> structure.
    </td>
    <td width="33%" valign="top">
      <h4>🧮 Transparent derived series</h4>
      Nine formula-based indicators like <code>real_cash_rate</code> &mdash; every calculation is
      open and inspectable.
    </td>
  </tr>
  <tr>
    <td width="33%" valign="top">
      <h4>🎯 Source-native control</h4>
      Drop down to raw <code>get_abs_data</code>, <code>get_rba_table</code> or
      <code>get_apra_data</code> whenever you need exact control.
    </td>
    <td width="33%" valign="top">
      <h4>⚡ Quick-turn helpers</h4>
      Convenience tools for latest observations, top movers and release events &mdash; analysis in
      one call.
    </td>
    <td width="33%" valign="top">
      <h4>🔌 Plugs into your client</h4>
      Claude Desktop, Claude Code, Codex or Smithery. stdio locally, Streamable HTTP when hosted.
    </td>
  </tr>
</table>

## Data sources

| Source | Coverage |
| :----- | :------- |
| **ABS** &nbsp;·&nbsp; Australian Bureau of Statistics | National accounts, prices, labour force, population |
| **RBA** &nbsp;·&nbsp; Reserve Bank of Australia | Cash rate, monetary & financial aggregates, exchange rates |
| **APRA** &nbsp;·&nbsp; Aust. Prudential Regulation Authority | ADI & insurer statistics, with release-cadence estimates |

## Install

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

```bash
uvx ausecon-mcp-server
```

The server speaks MCP over standard input/output. Launched on its own, it simply waits for a client
to connect.

## Connect your client

<details open>
<summary><b>Claude Desktop</b></summary>

Add to your `claude_desktop_config.json`:

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

<details>
<summary><b>Claude Code</b></summary>

```bash
claude mcp add --transport stdio ausecon -- uvx ausecon-mcp-server
```
</details>

<details>
<summary><b>Codex</b></summary>

```bash
codex mcp add ausecon -- uvx ausecon-mcp-server
```
</details>

> **Hosting it instead?** `smithery.yaml` and `Dockerfile.smithery` ship a Streamable HTTP
> deployment at `/mcp`. See the [Smithery guide](https://auseconmcp.com/smithery).

## A quick taste

Find the concept you want, then ask for the series:

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

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

Need a transparent, formula-based indicator? Call the derived surface directly:

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

> Connected to an AI agent, you can skip the syntax entirely &mdash; ask for *&ldquo;quarterly real
> GDP growth&rdquo;* and it maps your request to the right tool calls for you.

## Develop locally

Python 3.12 is recommended; the CI matrix supports 3.10+.

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

---

<div align="center">
<sub>

[auseconmcp.com](https://auseconmcp.com) &nbsp;·&nbsp;
[Issues](https://github.com/AnthonyPuggs/ausecon-mcp-server/issues) &nbsp;·&nbsp;
MIT Licence &nbsp;·&nbsp; Made for the Australian data community

</sub>
</div>
