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

Claude Desktop

Añade a tu claude_desktop_config.json:

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

Claude Code

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

VS Code / Cursor

Añade a .vscode/mcp.json:

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

Reinicia la aplicación después de añadir la configuración. No hace falta instalar nada más: npx descarga y ejecuta el servidor automáticamente.

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

Manual de la Renta 2025 completo

Todo el contenido del Manual Práctico de Renta 2025 de la AEAT, estructurado como datos consultables:

Datos de referencia

Integridad de los datos

Cada dato incluye un campo source con la referencia exacta a la ley, artículo y referencia del BOE.

Fuentes prohibidas: blogs, consultorías, medios de comunicación o cualquier fuente no oficial.

Solo fuentes oficiales:

• AEAT (Agencia Tributaria)
• BOE (Boletín Oficial del Estado)
• Boletines oficiales autonómicos (BOJA, BOCM, DOGC, etc.)
• Seguridad Social

En números

Desarrollo

git clone https://github.com/iMark21/aeat-mcp.git
cd aeat-mcp
npm install
npm run build
npm test

Licencia

MIT — (c) iMark Apps