ATO MCP

Conecte seu agente a mais de 34.500+ documentos ATO e obtenha respostas citadas para qualquer pergunta fiscal.

Documentação

Australian Tax MCP Server

A base de conhecimento fiscal australiana para agentes de IA.

Conecte seu agente de IA a mais de 34.500 documentos da ATO (orientações, legislação e decisões públicas) e obtenha respostas citadas para as perguntas fiscais que você normalmente pagaria ao seu contador para responder.

ato-mcp.com.au · Referência de ferramentas · Registro de alterações

CI npm License: AGPL-3.0 Node 22+

Início rápido

Adicione o MCP Server ao cliente que você já usa.

Configuração padrão funciona com a maioria das ferramentas que executam servidores stdio:

{
  "mcpServers": {
    "ato": {
      "command": "npx",
      "args": ["-y", "ato-mcp"]
    }
  }
}
npm install -g ato-mcp   # optional, npx works without installing

Para hosts que suportam nativamente servidores MCP remotos, conecte seu cliente diretamente:

Claude Code
claude mcp add --scope user --transport http ato https://api.ato-mcp.com.au/mcp

Em seguida, execute /mcp dentro do Claude Code, selecione ato e escolha Autenticar. Seu navegador abrirá para fazer login.

Codex CLI
codex mcp add ato --url https://api.ato-mcp.com.au/mcp
codex mcp login ato

codex mcp login abre seu navegador para fazer login.

Gemini CLI
gemini mcp add --scope user --transport http ato https://api.ato-mcp.com.au/mcp

O Gemini CLI detecta o desafio de autenticação no primeiro uso e abre seu navegador automaticamente.

VS Code (Copilot)

Install in VS Code Install in VS Code Insiders

Ou pela linha de comando:

code --add-mcp '{"name":"ato","type":"http","url":"https://api.ato-mcp.com.au/mcp"}'

O VS Code solicita autenticação no seu navegador quando o servidor se conecta pela primeira vez.

Cursor

Install in Cursor

Ou adicione a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "ato": {
      "url": "https://api.ato-mcp.com.au/mcp"
    }
  }
}

O Cursor mostra um aviso "Precisa de login" no servidor. Clique nele para entrar pelo seu navegador.

Windsurf

Adicione a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "ato": {
      "type": "streamable-http",
      "serverUrl": "https://api.ato-mcp.com.au/mcp"
    }
  }
}

Se o Windsurf não abrir uma janela de login, use a configuração npm padrão no topo desta seção; ela lida com o login pelo navegador.

Claude.ai / Claude Desktop
  1. Abra Configurações → Conectores
  2. Adicionar conector personalizado
  3. Cole https://api.ato-mcp.com.au/mcp
  4. Clique em Conectar e faça login quando a janela do navegador aparecer

Disponível em planos pagos do Claude. O Claude Desktop pode alternativamente usar a configuração npm padrão no topo desta seção em claude_desktop_config.json.

ChatGPT
  1. Configurações → Aplicativos e Conectores → ative o Modo de desenvolvedor
  2. Novo conector → cole https://api.ato-mcp.com.au/mcp
  3. Escolha OAuth e faça login quando solicitado

Requer um plano com suporte a conectores.

Outros (OpenCode, Zed, etc)

Use a configuração npm padrão no topo desta seção. Este pacote faz a ponte entre qualquer host stdio e o servidor hospedado com o mesmo login pelo navegador.

Instruções completas: ato-mcp.com.au/install

O que há no corpus

Tudo o que a ATO publica, em um único lugar pesquisável, atualizado mensalmente:

FonteConteúdo
ato.gov.au23,000+ páginas de orientação, formulários e instruções, guias de ocupação, ajuda do myTax
LegislaçãoITAA 1997, ITAA 1936 e a Lei GST: 6,468 seções + 2,310 definições estatutárias (ciente de ponto no tempo)
Decisões públicas da ATO4,900+ decisões em 10 tipos (TR, TD, GSTR, GSTD, PR, CR, LCR, PCG, MT, FTR), com decisões revogadas sinalizadas
Referências cruzadas64,217 links entre decisões e legislação
LimitesValores com chave de tempo (escrita fiscal imediata de ativos, registro GST, desconto CGT, limites de super, …)

34,500+ documentos (286,000+ passagens pesquisáveis), atualizados mensalmente e servidos pela plataforma hospedada.

As 13 ferramentas

Workflows são a razão pela qual isto existe:

"Aqui estão minhas transações bancárias, o que posso deduzir este ano? Como faço para baixar meu novo laptop? Há algo arriscado na minha declaração?"

FerramentaO que faz
deduction_discoveryApresenta todas as categorias de dedução que plausivelmente se aplicam ao seu perfil: uma taxonomia curada e citada que se ramifica entre profissionais autônomos, empresas, trusts, parcerias, investidores e membros de SMSF
depreciation_helperCronogramas determinísticos de custo primário / valor decrescente / baixa imediata / pool de pequenas empresas / Div 43 para qualquer ativo, com o limite IAWO atual
bas_prep_checklistUma lista de verificação BAS em camadas e citada para o seu período de relatório: quais rótulos se aplicam, quais evidências reunir, as armadilhas
audit_risk_checkSinaliza os padrões que a ATO examina em uma declaração preliminar (WRE vs renda, anomalias de aluguel, cripto não declarado, …) com faixas de risco e a orientação por trás de cada sinalização

Cada ferramenta de workflow retorna dados estruturados e citações ATO resolvíveis, nunca conselhos com voz própria.

Contexto pessoal: get_user_facts, 25 fatos capturados uma vez no onboarding (estrutura empresarial, registro GST, investimentos, tipo de super, residência, …) para que o agente nunca pergunte novamente.

Recuperação: search (recuperação por palavra-chave e semântica), get_chunks, get_doc, get_doc_anchors (referências cruzadas), get_definition (estatutário, ponto no tempo), get_threshold (valores com chave de tempo), fetch (busca de página ao vivo), stats.

Veja a referência completa de ferramentas.

Aviso legal

Este serviço é fornecido como infraestrutura de informação, não aconselhamento fiscal. Ele não considera todas as suas circunstâncias financeiras e não é um serviço de agente fiscal registrado. Classificações de confiança e faixas de risco são guias, não julgamento profissional. Verifique decisões materiais com um agente fiscal registrado.

O ato-mcp é um serviço independente. Não é afiliado ou endossado pela Australian Taxation Office. O conteúdo da ATO permanece sujeito aos termos de publicação da ATO. O texto da legislação é reproduzido do Federal Register of Legislation sob sua licença aberta.

Veja os Termos de Serviço e a Política de Privacidade para mais detalhes.


Licença AGPL-3.0 © William Laverty

A plataforma hospedada e o corpus são proprietários. Licenciamento comercial disponível mediante solicitação.