AEAT MCP Server

AEAT MCP Server

Servidor MCP con datos fiscales españoles para asistentes de IA. Toda la información procede exclusivamente de fuentes oficiales (AEAT, BOE).

Conecta este servidor a Claude, ChatGPT, Copilot, Cursor o cualquier agente compatible con MCP y pregúntale sobre la declaración de la renta, deducciones, plazos, IVA, criptomonedas y más.

Aviso legal: Esta herramienta proporciona datos meramente informativos y orientativos. No constituye asesoramiento fiscal. Consulte siempre con un profesional cualificado o verifique en la AEAT.

Si este proyecto te resulta útil, dale una estrella en GitHub. Ayuda a que más gente lo encuentre.

Índice

• Qué es MCP
• Instalación
• Ejemplos de uso
• Qué incluye
  • 10 herramientas
  • Manual de la Renta 2025 completo
  • Datos de referencia
• Integridad de los datos
• En números
• Desarrollo
• Licencia

Qué es MCP

Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA (Claude, ChatGPT, Copilot, Cursor...) conectarse a fuentes de datos externas. Este servidor MCP da acceso a datos fiscales españoles oficiales, de forma que tu asistente puede responder preguntas sobre impuestos con información verificada y actualizada.

Instalación

Requisito

• Node.js 18 o superior instalado

No necesitas clonar ni compilar nada. npx descarga y ejecuta el servidor automáticamente.

Claude Desktop

1. Abre Claude Desktop
2. Ve a Claude (menú superior) > Settings > Developer > Edit Config
3. Se abrirá un archivo JSON. Añade "mcpServers" para que quede así:

{
  "mcpServers": {
    "aeat": {
      "command": "npx",
      "args": ["-y", "aeat-mcp"]
    }
  }
}

Si el archivo ya tenía contenido (por ejemplo "preferences"), añade "mcpServers" al mismo nivel, separado por coma:

{
  "preferences": {
    "menuBarEnabled": false
  },
  "mcpServers": {
    "aeat": {
      "command": "npx",
      "args": ["-y", "aeat-mcp"]
    }
  }
}

4. Guarda el archivo y reinicia Claude Desktop (cierra y abre la app)
5. En la ventana de chat verás un icono de herramientas (martillo) — al pulsarlo deberían aparecer las 10 herramientas del servidor AEAT

Claude Code

claude mcp add aeat-mcp -- npx -y aeat-mcp

Cursor

1. Ve a Settings (Cmd+,) > busca MCP
2. Añade un servidor con comando npx y argumentos -y aeat-mcp

O añade a .cursor/mcp.json:

{
  "mcpServers": {
    "aeat": {
      "command": "npx",
      "args": ["-y", "aeat-mcp"]
    }
  }
}

VS Code (Copilot)

Añade a .vscode/mcp.json:

{
  "servers": {
    "aeat": {
      "command": "npx",
      "args": ["-y", "aeat-mcp"]
    }
  }
}

Windsurf

1. Ve a Settings > MCP Servers > Add Server
2. Comando: npx, argumentos: -y aeat-mcp

ChatGPT y otros asistentes

ChatGPT no soporta MCP de forma nativa por ahora. Alternativa:

• Usa MCP Bridge para conectar servidores MCP con ChatGPT

Ejemplos de uso

Pregúntale a tu asistente de IA:

Obligación de declarar

• «¿Estoy obligado a declarar si gano 18.000 EUR con dos pagadores?»

Rendimientos del trabajo

• «Mi indemnización por despido de 45.000 EUR, ¿está exenta?»
• «Mi empresa me paga el coche, ¿cómo tributa la retribución en especie?»

IRPF y deducciones

• «¿Cuánto pago de IRPF en Madrid con 50.000 EUR brutos?»
• «¿Qué deducciones autonómicas hay en Baleares?»
• «¿Cuánto es la deducción por maternidad?»
• «¿Es mejor declarar conjunta o individual si mi pareja no trabaja?»

Inversiones

• «¿Cómo tributan los dividendos de acciones francesas?»
• «He vendido bitcoins con ganancias, ¿cómo lo declaro?»
• «He traspasado un fondo de inversión a otro, ¿tributa?»

Alquileres

• «Tengo un piso alquilado, ¿qué gastos me puedo deducir?»
• «Alquilo mi piso en Airbnb, ¿cómo tributa?»

Autónomos

• «¿Qué gastos se puede deducir un autónomo?»
• «¿Cuándo es el plazo para el Modelo 303?»

Retenciones

• «¿Por qué mi empresa me retiene un 24% de IRPF?»
• «Soy profesional autónomo nuevo, ¿qué retención me aplican?»

Patrimonio

• «¿Tengo que declarar el Impuesto sobre el Patrimonio?»
• «¿Cómo funciona el Impuesto de Solidaridad de Grandes Fortunas?»

Otros

• «¿Cómo funciona el rescate de un plan de pensiones?»
• «¿Es válido este NIF: 12345678Z?»
• «He presentado mal la declaración, ¿cómo la corrijo?»

Qué incluye

10 herramientas