AEAT MCP Server

March 21, 2026 · View on GitHub

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.

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

Abre Claude Desktop
Ve a Claude (menú superior) > Settings > Developer > Edit Config
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"]
    }
  }
}

Guarda el archivo y reinicia Claude Desktop (cierra y abre la app)
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

Ve a Settings (Cmd+,) > busca MCP
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

Ve a Settings > MCP Servers > Add Server
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

Herramienta	Descripción
`get_vat_rates`	Tipos de IVA (21%, 10%, 4%), recargos de equivalencia, IGIC (Canarias) e IPSI (Ceuta y Melilla)
`get_irpf_brackets`	Tramos del IRPF — escala estatal general y del ahorro
`get_personal_minimums`	Mínimos personales y familiares (contribuyente, descendientes, ascendientes, discapacidad)
`get_indicators`	Indicadores económicos: IPREM, SMI, tipo de interés legal del dinero
`get_fiscal_calendar`	Plazos de la AEAT por año, trimestre o modelo. Indica el próximo vencimiento
`get_tax_form_info`	Información de 19 modelos fiscales (100, 303, 720...) — nombre, periodicidad, quién declara
`validate_tax_id`	Valida NIF, NIE y CIF (verificación del dígito de control)
`search_tax_rules`	Busca en todo el Manual de la Renta — rendimientos, deducciones, exenciones, ganancias
`search_casillas`	Busca casillas del Modelo 100 por número o palabra clave
`get_ccaa_deductions`	Deducciones autonómicas por comunidad (17 CCAA + Ceuta y Melilla, unas 350 deducciones)

Manual de la Renta 2025 completo

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

Capítulo	Contenido
Obligación de declarar	Umbrales del art. 96 LIRPF (22.000 / 15.876 EUR), casos obligatorios, regla transitoria
Rentas exentas	30 exenciones del art. 7 LIRPF — despido (180.000), maternidad, becas, discapacidad, trabajo en el extranjero (60.100), loterías (40.000)
Rendimientos del trabajo	Sueldos, retribuciones en especie, dietas exentas, gastos deducibles, reducciones
Capital inmobiliario	Alquileres: 10 categorías de gastos, reducciones del 50 al 90%, imputación de rentas
Capital mobiliario	Dividendos, intereses, seguros, rentas vitalicias, PIAS, SIALP, régimen transitorio
Actividades económicas	Autónomos: estimación directa normal y simplificada, 14 categorías de gastos, amortización, RETA, pagos fraccionados
Ganancias patrimoniales	8 tipos, método FIFO, traspasos de fondos (exentos), 10 exenciones, norma anti-abuso, compensación de pérdidas
Deducciones estatales	16 deducciones: maternidad, familia numerosa, donativos, vehículo eléctrico, eficiencia energética, Ceuta y Melilla
Deducciones autonómicas	Unas 350 deducciones en las 17 CCAA + Ceuta y Melilla
Tramos autonómicos del IRPF	Escalas autonómicas de las 15 CCAA de régimen común + Ceuta y Melilla
Doble imposición internacional	Art. 80 LIRPF, 92 países con tipos de convenio, proceso de recuperación, ejemplo paso a paso
Criptomonedas	Compraventa, permutas, staking, minería, FIFO, casillas 1802-1806, Modelo 721
Tributación conjunta	2 modalidades de unidad familiar, reducciones de 3.400 / 2.150 EUR, cuándo conviene
Alquiler turístico	Sin reducción del 50-90%, gastos proporcionales, imputación de días vacíos, IVA, DAC7
Planes de pensiones	Rescate: 3 formas, reducción del 40% para aportaciones anteriores a 2007, límites
Pensión compensatoria	Reducción para el pagador (art. 55), anualidades por alimentos a hijos (art. 64, escala separada)
Retenciones	Escala de retención (6 tramos, 19%-47%), mínimos por situación familiar, tipos fijos, exclusiones, regularización, Modelo 145
Procedimiento de corrección	Autoliquidación rectificativa (Ley 13/2023) y complementaria, recargos, pago en dos plazos, prescripción
Patrimonio y Grandes Fortunas	Impuesto sobre el Patrimonio (Ley 19/1991): tarifa, exenciones, CCAA. ITSGF (Modelo 718): tarifa, umbrales
Casillas del Modelo 100	Más de 50 casillas mapeadas con su artículo de la LIRPF

Datos de referencia

Dominio	Años	Fuente oficial
Tipos de IVA, recargos, IGIC, IPSI	2025	Ley 37/1992, RDL 4/2024
Tramos IRPF (estatal + 15 CCAA)	2025	Ley 35/2006, Ley 7/2024, legislación autonómica
Mínimos personales y familiares	2025	Ley 35/2006, arts. 57-61
Indicadores (IPREM, SMI, tipo legal)	2025-2026	Ley 31/2022, RD 87/2025, RD 126/2026
Calendario fiscal	2026	AEAT — Calendario del Contribuyente 2026
Catálogo de modelos	19 modelos	AEAT — sede electrónica
Convenios de doble imposición	92 países	AEAT — Manual de Tributación de No Residentes

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


Herramientas	10
Archivos de datos	28
Líneas de datos fiscales	14.933
Tests automatizados	52
Capítulos del manual	18
Deducciones autonómicas	~350
Países con convenio de doble imposición	92
Tipos de rentas exentas	30
Modelos fiscales catalogados	19
Plazos del calendario fiscal	53

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