What can you do with this server?

The AEAT MCP Server provides AI assistants with access to verified, official Spanish tax data from the AEAT and BOE through 10 specialized tools: * VAT (IVA) Rates – Retrieve Spanish VAT rates (general 21%, reduced 10%, super-reduced 4%), equivalence surcharges, IGIC (Canary Islands), and IPSI (Ceuta & Melilla) by fiscal year. * IRPF Income Tax Brackets – Look up state-level personal income tax brackets for general income (work/business) and savings income (capital gains/dividends) for fiscal years 2024–2026. * Personal & Family Tax Minimums – Access tax-free minimums for taxpayers, descendants, ascendants, and disability allowances. * Economic Indicators – Get key reference values such as IPREM, SMI (minimum wage), legal interest rate, and late payment interest rate for a given year. * Tax ID Validation – Validate Spanish NIF, NIE, and CIF identifiers including control digit verification. * Fiscal Calendar – Consult AEAT filing deadlines filterable by year, quarter, or specific tax form (modelo). * Tax Form Information – Retrieve details on 19 Spanish tax forms (e.g., Modelo 100, 303, 720), including name, periodicity, and filing requirements. * Tax Rules Search – Full-text search across the complete AEAT Manual Práctico de Renta 2025, covering work income, rental income, investments, capital gains, deductions, exemptions, crypto, pensions, and more. * Modelo 100 Casillas Search – Look up specific form fields by number or keyword, including their definition, section, and legal article reference. * CCAA Regional Deductions – Access ~350 tax deductions across all 17 autonomous communities plus Ceuta and Melilla, with amounts, limits, income requirements, and legal sources. All data comes exclusively from official sources (AEAT, BOE, regional bulletins) with exact legal references. Compatible with Claude Desktop, Claude Code, Cursor, VS Code (Copilot), Windsurf, and ChatGPT via MCP Bridge.

Which integrations are available for this server?

Provides official Spanish tax rules and regulatory guidance from the AEAT regarding income earned from tourist rentals on platforms like Airbnb, including information on deductible expenses and reporting obligations. Provides detailed information on the Spanish fiscal treatment of cryptocurrencies, covering capital gains from Bitcoin trading, staking, mining, and mandatory reporting requirements such as Modelo 721.

How do I use AEAT MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@AEAT MCP Server ¿Qué deducciones por alquiler hay en Madrid para menores de 35 años?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

AEAT MCP Server

by iMark21

Overview Schema Related Servers Score Discussions

TypeScript

Remote

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

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

Install Server

security – no known vulnerabilities

license - permissive license

quality - A tier

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security
Open Source Has a Bot Problem
By punkpeye on March 19, 2026.
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/iMark21/aeat-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server