Skip to content

liamfraz/au-mcp-server

Repository files navigation

AU Financial MCP Server

Ask Claude: "What's my take-home pay on $95k in NSW?" — and get the exact answer instantly.

An open-source Python MCP server that gives Claude Desktop accurate Australian tax, super, HECS, and CGT calculations — all using 2025-26 ATO rates.

Get Early Access (Free Beta) · GitHub


What It Does

Tool Example question
calculate_payg_tax "What's my PAYG tax on $95k?"
calculate_super_contribution "How much super on $120k with 5% salary sacrifice?"
calculate_hecs_repayment "I earn $82k with $35k HECS — what do I repay this year?"
calculate_cgt "I sold shares for $25k (bought $10k, held 2 years). CGT?"
salary_package_comparison "Compare $90k vs $110k in VIC after tax and stamp duty"

All figures use 2025-26 ATO rates and current legislation.


5-Second Install

1. Clone the repo

git clone https://github.com/liamfraz/au-mcp-server.git
cd au-mcp-server

2. Add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "au-financial": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/au-mcp-server", "python", "server.py"]
    }
  }
}

3. Restart Claude Desktop — done. Ask Claude any Australian tax question.

No uv? Use pip install -r requirements.txt then point command to your Python binary.


Pricing

Tier Price Who it's for
Individual (Beta) $0 / month Anyone using Claude Desktop personally
Business $29 / month (coming soon) Teams, accountants, hosted API access

Beta is free while we collect feedback. Lock in free access now:

Get Early Access — Free During Beta


Example Queries

Once connected, try asking Claude:

  • "What is my PAYG tax on a $95,000 salary?"
  • "How much super will my employer contribute on $120k?"
  • "I have $35,000 HECS debt and earn $82,000 — what's my repayment this year?"
  • "I bought shares for $10,000, sold for $25,000 after 2 years. What's my CGT if I earn $75,000?"
  • "Compare $90k vs $110k salaries in VIC including stamp duty."

Tool Reference

calculate_payg_tax

income        float   Annual taxable income (AUD)
filing_year   str     "2025-26" (default)

Returns: income_tax, medicare_levy, total_tax, net_income, effective_rate_pct, marginal_rate_pct

calculate_super_contribution

salary                float   Annual base salary (AUD)
employee_contrib_pct  float   Extra salary-sacrifice % (default 0)

Returns: employer_super, total_concessional, within_concessional_cap, cap_headroom, total_package

calculate_hecs_repayment

income      float   Annual HELP repayment income (AUD)
hecs_debt   float   Outstanding HELP balance (AUD)

Returns: repayment_rate, annual_repayment, years_to_repay

calculate_cgt

purchase_price   float   Cost base (AUD)
sale_price       float   Sale proceeds (AUD)
hold_years       float   Holding period in years
income           float   Other taxable income (AUD)

Returns: capital_gain, discount_eligible, taxable_gain, estimated_cgt, effective_cgt_rate

salary_package_comparison

salary_a   float   First salary (AUD)
salary_b   float   Second salary (AUD)
state      str     NSW | VIC | QLD | WA | SA | TAS | ACT | NT

Returns: Full after-tax breakdown for both salaries + stamp duty + difference summary


Disclaimer

These calculations are for illustrative purposes only and do not constitute financial or tax advice. Always consult a registered tax agent or financial adviser for your specific situation. Figures are based on publicly available ATO 2025-26 information.

About

MCP server for Australian tax, super, and financial calculations — use inside Claude Desktop

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors