ATO MCP

Conecta tu agente a más de 34,500 documentos ATO y obtén respuestas citadas a cualquier pregunta fiscal.

Documentación

Servidor MCP de Impuestos Australianos

La base de conocimiento de impuestos australianos para agentes de IA.

Conecta tu agente de IA a más de 34,500 documentos de la ATO (guías, legislación y dictámenes públicos) y obtén respuestas citadas a las preguntas fiscales que de otro modo le pagarías a tu contador para responder.

ato-mcp.com.au · Referencia de herramientas · Registro de cambios

CI npm License: AGPL-3.0 Node 22+

Inicio rápido

Agrega el Servidor MCP al cliente que ya usas.

Configuración estándar funciona con la mayoría de las herramientas que ejecutan servidores stdio:

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

Para hosts que admiten servidores MCP remotos de forma nativa, conecta tu cliente directamente:

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

Luego ejecuta /mcp dentro de Claude Code, selecciona ato y elige Authenticate. Tu navegador se abrirá para iniciar sesión.

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

codex mcp login abre tu navegador para iniciar sesión.

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

Gemini CLI detecta el desafío de autenticación en el primer uso y abre tu navegador automáticamente.

VS Code (Copilot)

Install in VS Code Install in VS Code Insiders

O desde la línea de comandos:

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

VS Code solicita autenticación en tu navegador cuando el servidor se conecta por primera vez.

Cursor

Install in Cursor

O agrégalo a ~/.cursor/mcp.json:

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

Cursor muestra un aviso de "Needs login" en el servidor. Haz clic en él para iniciar sesión a través de tu navegador.

Windsurf

Agrégalo a ~/.codeium/windsurf/mcp_config.json:

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

Si Windsurf no abre una ventana de inicio de sesión, usa la configuración estándar de npm al inicio de esta sección; esa configuración maneja el inicio de sesión en el navegador por sí misma.

Claude.ai / Claude Desktop
  1. Abre Settings → Connectors
  2. Add custom connector
  3. Pega https://api.ato-mcp.com.au/mcp
  4. Haz clic en Connect e inicia sesión cuando aparezca la ventana del navegador

Disponible en planes de Claude de pago. Claude Desktop también puede usar la configuración estándar de npm al inicio de esta sección en claude_desktop_config.json.

ChatGPT
  1. Settings → Apps & Connectors → habilita Developer Mode
  2. New connector → pega https://api.ato-mcp.com.au/mcp
  3. Elige OAuth e inicia sesión cuando se te solicite

Requiere un plan con soporte para conectores.

Otros (OpenCode, Zed, etc.)

Usa la configuración estándar de npm al inicio de esta sección. Este paquete conecta cualquier host stdio al servidor alojado con el mismo inicio de sesión en el navegador.

Instrucciones completas: ato-mcp.com.au/install

Qué contiene el corpus

Todo lo que la ATO publica, en un solo lugar buscable, actualizado mensualmente:

FuenteContenido
ato.gov.auMás de 23,000 páginas de guías, formularios e instrucciones, guías ocupacionales, ayuda de myTax
LegislaciónITAA 1997, ITAA 1936 y la Ley GST: 6,468 secciones + 2,310 definiciones legales (conscientes del tiempo)
Dictámenes públicos de la ATOMás de 4,900 dictámenes en 10 tipos (TR, TD, GSTR, GSTD, PR, CR, LCR, PCG, MT, FTR), con dictámenes retirados marcados
Referencias cruzadas64,217 enlaces entre dictámenes y legislación
UmbralesValores con clave temporal (cancelación inmediata de activos, registro de GST, descuento de CGT, límites de super, …)

Más de 34,500 documentos (más de 286,000 pasajes buscables), actualizados mensualmente y servidos desde la plataforma alojada.

Las 13 herramientas

Los flujos de trabajo son la razón de que esto exista:

"Aquí están mis transacciones bancarias, ¿qué puedo reclamar este año? ¿Cómo cancelo mi nueva laptop? ¿Hay algo en mi declaración que sea riesgoso?"

HerramientaQué hace
deduction_discoverySuperficies cada categoría de deducción que plausiblemente aplica a tu perfil: una taxonomía curada y citada que se ramifica entre trabajadores por cuenta propia, empresas, fideicomisos, sociedades, inversores y miembros de SMSF
depreciation_helperProgramas deterministas de costo principal / valor decreciente / cancelación inmediata / pool de pequeñas empresas / Div 43 para cualquier activo, con el umbral de IAWO vigente
bas_prep_checklistUna lista de verificación de BAS escalonada y citada para tu período de declaración: qué etiquetas aplican, qué evidencia reunir, los errores comunes
audit_risk_checkSeñala los patrones que la ATO examina en un borrador de declaración (WRE vs ingresos, anomalías de alquiler, cripto no declarado, …) con bandas de riesgo y la guía detrás de cada señal

Cada herramienta de flujo de trabajo devuelve datos estructurados y citas de la ATO resolubles, nunca asesoramiento con su propia voz.

Contexto personal: get_user_facts, 25 datos capturados una vez durante la incorporación (estructura empresarial, registro de GST, inversiones, tipo de super, residencia, …) para que el agente nunca vuelva a preguntar.

Recuperación: search (recuperación por palabras clave y semántica), get_chunks, get_doc, get_doc_anchors (referencias cruzadas), get_definition (legal, consciente del tiempo), get_threshold (valores con clave temporal), fetch (obtención de página en vivo), stats.

Consulta la referencia completa de herramientas.

Aviso legal

Este servicio se proporciona como infraestructura de información, no asesoramiento fiscal. No considera tus circunstancias financieras completas y no es un servicio de agentes fiscales registrados. Las calificaciones de confianza y las bandas de riesgo son guías, no juicio profesional. Verifica las decisiones importantes con un agente fiscal registrado.

ato-mcp es un servicio independiente. No está afiliado ni respaldado por la Oficina de Impuestos de Australia. El contenido de la ATO sigue sujeto a los términos de publicación de la ATO. El texto de la legislación se reproduce del Registro Federal de Legislación bajo su licencia abierta.

Consulta los Términos de servicio y la Política de privacidad para más detalles.


Licencia AGPL-3.0 © William Laverty

La plataforma alojada y el corpus son propietarios. Licencias comerciales disponibles bajo solicitud.