convez.ai
MCP ServerFinanceiroIntermediário
william-laverty

ATO MCP — Base de Conhecimento Tributário Australiano

william-laverty/ato-mcp

Base tributária australiana com 29k+ docs, citações e ferramentas de compliance

Ver no GitHub
BomPluginScore · de 0 a 100

MCP server que conecta agentes de IA a 29k+ documentos da Autoridade Tributária Australiana (ATO), legislação ITAA 1997 e rulings com citações verificáveis. Inclui ferramentas de workflow para descoberta de deduções, cálculo de depreciação, preparação de BAS e auditoria de risco — sempre com contexto pessoal do contribuinte.

Instalação

$npx convez-ai william-laverty/ato-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
19
Forks
3
Acompanhando
1
Saúde
85%
Último commit
há 2 dias
Versão
v2.3.1
Issues abertas
1
Contribuidores
1

Casos de uso

  • Assistência a contribuintes na identificação de deduções elegíveis com citações ATO
  • Cálculo de depreciação de ativos segundo regras australianas
  • Preparação de Business Activity Statements (BAS) com checklist citado
  • Análise de risco de auditoria em declarações de imposto

Veredito

Solução robusta e especializada para o contexto tributário australiano, com corpus bem estruturado (29k docs, legislação completa, 2,1k rulings) e ferramentas práticas orientadas a workflows. Destaca-se pela citação verificável e personalização por perfil de contribuinte, eliminando respostas genéricas. Alcance limitado ao mercado australiano.

README

A tradução para o português deste README ainda está na fila.

ato-mcp

The Australian tax knowledge base for AI agents.

Give Claude (or any MCP host) cited, current retrieval over 29,000+ ATO documents — plus a personal-facts layer and four tax workflow tools that know your situation.

ato-mcp.com.au · Tool reference · Changelog

CI npm License: MIT Node 22+


Ask your agent "can I claim my home office?" and it answers from the actual ATO guidance, the actual ITAA 1997 section, and the actual ruling — with citations you can resolve and read — instead of from training-data vibes. Tell it once that you're a GST-registered sole trader with crypto, and every answer is branched for your taxpayer shape.

What's in the corpus

SourceContents
ato.gov.au24,500+ guidance pages, forms & instructions, occupation guides, myTax help
ITAA 19974,638 sections + 1,929 statutory definitions (point-in-time aware)
ATO public rulings2,127 rulings across 10 types (TR, TD, GSTR, GSTD, PR, CR, LCR, PCG, MT, FTR)
Citation graph23,267 cross-references between rulings and legislation
ThresholdsTime-keyed scalars (instant asset write-off, GST registration, CGT discount, super caps, …)

29,181 documents · 224,585 chunks, embedded and hybrid-indexed (BM25 + vector), rebuilt monthly.

The 13 tools

Retrieval — search (hybrid BM25+vector), get_chunks, get_doc, get_doc_anchors (citation graph), get_definition (statutory, point-in-time), get_threshold (time-keyed scalars), fetch (live page fetch), stats.

Personal context — get_user_facts: 25 facts captured once at onboarding (business structure, GST registration, investments, super type, residency, …) so the agent never re-asks.

Workflows — the reason this exists:

ToolWhat it does
deduction_discoverySurfaces every deduction category that plausibly applies to your profile — 59-category curated taxonomy, branched across sole traders, companies, trusts, partnerships, investors and SMSF members, each with live citations and a confidence rating
depreciation_helperDeterministic prime-cost / diminishing-value / instant-write-off / small-business-pool / Div 43 schedules for any asset, with the live IAWO threshold
bas_prep_checklistA tiered, cited BAS checklist for your reporting period — which labels apply, what evidence to gather, the gotchas
audit_risk_checkFlags the patterns the ATO scrutinises in a draft return (WRE vs income, rental anomalies, unreported crypto, …) with risk bands and the guidance behind each flag

Every workflow tool returns structured data + resolvable ATO citations — never advice in its own voice. See the full tool reference.

Quick start

Get your token at https://ato-mcp.com.au/onboard, then add to your MCP client config:

{ "mcpServers": { "ato-mcp": { "command": "npx", "args": ["-y", "ato-mcp"],
    "env": { "ATO_MCP_TOKEN": "<your-token>" } } } }

The client forwards every tool call to api.ato-mcp.com.au over TLS. There is no local corpus to download.

How it works

flowchart LR
    A[Claude Code / MCP host] -- stdio --> B[ato-mcp CLI]
    B --> D[api.ato-mcp.com.au]
    D --> E[(Supabase Postgres\n+ pgvector, RLS)]
packages/
├── shared/    Types, Zod schemas, Store/Embedder interfaces, all 13 tool implementations
├── mcp/       The npm package: stdio MCP server + CLI (npx -y ato-mcp)
├── backend/   Vercel functions over Supabase Postgres + pgvector
└── web/       ato-mcp.com.au — Next.js onboarding, account, schema-driven privacy policy

Privacy, by construction

No tool names, no query content, no results are ever stored — the analytics schema physically has nowhere to put them. The privacy page is rendered from UserFactsSchema at build time and a contract test fails if any stored field is undocumented. Per-user rows are isolated with Postgres row-level security; bearer tokens are stored as SHA-256 hashes and revocable from the account page. The client, shared tool logic, hosted backend and this website are in this repository — verify, don't trust.

Development

pnpm install && pnpm -r build
pnpm -r test            # TypeScript suites (shared, mcp, backend, web)

See CONTRIBUTING.md for conventions and RELEASING.md for the release process.

Important disclaimer

ato-mcp is information infrastructure, not tax advice. It retrieves and structures published ATO material and computes deterministic schedules; it does not consider your full circumstances and it is not a registered tax agent service. Confidence ratings and risk bands are heuristic indicators, not professional judgement. Verify material decisions with a registered tax agent — and read the terms.

ATO content remains subject to ATO publication terms. ITAA 1997 text is reproduced from the Federal Register of Legislation under its open licensing.

License

MIT © William Laverty

Ver o original no GitHub

Bom para

Relacionados