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.
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.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
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.
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.
Related MCP server: Spain Open Data 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.
Node.js 18 o superior instalado
No necesitas clonar ni compilar nada. npx descarga y ejecuta el servidor automáticamente.
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 mcp add aeat-mcp -- npx -y aeat-mcpVe 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"]
}
}
}Añade a .vscode/mcp.json:
{
"servers": {
"aeat": {
"command": "npx",
"args": ["-y", "aeat-mcp"]
}
}
}Ve a Settings > MCP Servers > Add Server
Comando: npx, argumentos: -y aeat-mcp
ChatGPT no soporta MCP de forma nativa por ahora. Alternativa:
Usa MCP Bridge para conectar servidores MCP con ChatGPT
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?»
Herramienta | Descripción |
| Tipos de IVA (21%, 10%, 4%), recargos de equivalencia, IGIC (Canarias) e IPSI (Ceuta y Melilla) |
| Tramos del IRPF — escala estatal general y del ahorro |
| Mínimos personales y familiares (contribuyente, descendientes, ascendientes, discapacidad) |
| Indicadores económicos: IPREM, SMI, tipo de interés legal del dinero |
| Plazos de la AEAT por año, trimestre o modelo. Indica el próximo vencimiento |
| Información de 19 modelos fiscales (100, 303, 720...) — nombre, periodicidad, quién declara |
| Valida NIF, NIE y CIF (verificación del dígito de control) |
| Busca en todo el Manual de la Renta — rendimientos, deducciones, exenciones, ganancias |
| Busca casillas del Modelo 100 por número o palabra clave |
| Deducciones autonómicas por comunidad (17 CCAA + Ceuta y Melilla, unas 350 deducciones) |
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 |
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 |
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.)
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 |
git clone https://github.com/iMark21/aeat-mcp.git
cd aeat-mcp
npm install
npm run build
npm testMIT — (c) iMark Apps
Returns all tax deductions available in a specific Spanish autonomous community (CCAA). Covers all 17 CCAA + Ceuta + Melilla. Each deduction includes amount/percentage, limits, income requirements, and legal source. Use common names: 'baleares', 'madrid', 'cataluna', 'valencia', etc. Source: AEAT Manual Practico Renta 2025, Parte 2 — Deducciones Autonomicas.
Inputs: ccaa (required), query.
Returns Spanish AEAT fiscal calendar deadlines for a given year. Filter by quarter (1-4) to see only that quarter's deadlines. Filter by modelo (e.g., '303', '100') to see deadlines for a specific tax form. Each deadline includes start/end dates, description, and who must file. Source: AEAT Calendario del Contribuyente.
Inputs: year (required), quarter, modelo.
Returns key Spanish economic indicators for a given year: IPREM (public income reference), SMI (minimum wage), legal interest rate, and late payment interest rate. These are used as thresholds in tax calculations, subsidies, and legal proceedings. Source: PGE (national budget) + BOE.
Inputs: year (required), indicator.
Returns Spanish IRPF (income tax) brackets for a given fiscal year. type='general' returns the base general (work/business income) brackets. type='savings' returns the base del ahorro (capital gains/dividends) brackets. These are STATE-level rates only (roughly half of the total rate). The other half comes from the CCAA regional scale. Source: Ley 35/2006, arts. 63 and 66.
Inputs: year (required), type.
Returns the personal and family tax-free minimums (minimo personal y familiar) for Spanish IRPF. Includes taxpayer minimum, descendants, ascendants, and disability allowances. These reduce the taxable base. Source: Ley 35/2006, arts. 57-61.
Inputs: year (required).
Returns information about a specific Spanish AEAT tax form (modelo). Provide the form number (e.g., '100' for IRPF, '303' for IVA, '720' for foreign assets). Returns: name, periodicity, who must file, description, filing period. Source: AEAT sede electronica.
Inputs: modelo (required).
Returns Spanish VAT (IVA) rates for a given fiscal year. Includes general, reduced, and super-reduced rates, plus equivalence surcharges. Use territory='canarias' for IGIC or territory='ceuta_melilla' for IPSI. Source: Ley 37/1992 del IVA.
Inputs: year (required), territory.
Searches the Modelo 100 (IRPF) casilla map by number or keyword. Use a casilla number (e.g., '0001') to get its definition, or a keyword (e.g., 'dividendos', 'alquiler') to find relevant casillas. Returns casilla number, name, section, and source article. Source: AEAT Manual Practico Renta 2025.
Inputs: query (required).
Searches across all IRPF tax rules data for a given keyword or concept. Searches in: work income, rental income, investment income, capital gains, deductions, and casilla definitions. Use natural terms like 'alquiler', 'dividendos', 'maternidad', 'vehiculo electrico', 'plan pensiones', 'vivienda habitual', 'despido', etc. Returns matching rules with casilla numbers, limits, and source articles. Source: AEAT Manual Practico Renta 2025.
Inputs: query (required), domain.
Validates a Spanish tax identification number. Supports NIF (individuals, 8 digits + letter), NIE (foreign residents, X/Y/Z + 7 digits + letter), and CIF (companies, letter + 7 digits + control). Returns validity, type detected, and formatted value. Source: Ministerio del Interior (NIF/NIE algorithm), Real Decreto 1065/2007 (CIF).
Inputs: id (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 10 tools
Every tool has a clearly distinct purpose targeting specific Spanish tax and fiscal information domains. There is no overlap between tools like get_ccaa_deductions (regional tax deductions), get_fiscal_calendar (deadlines), get_indicators (economic thresholds), and search_tax_rules (keyword-based rule search). The descriptions clearly differentiate each tool's unique function.
All tools follow a consistent verb_noun naming pattern with perfect uniformity. Every tool name starts with either 'get_' or 'search_' followed by a descriptive noun phrase, and all use snake_case consistently throughout. This creates excellent predictability and readability across the entire toolset.
With 10 tools, this server is well-scoped for its comprehensive Spanish tax information domain. Each tool earns its place by covering distinct aspects like regional deductions, tax brackets, VAT rates, form information, and validation. The count is ideal for providing complete coverage without being overwhelming.
The toolset provides complete coverage of Spanish tax and fiscal information needs. It includes regional deductions, tax brackets, VAT rates, economic indicators, personal minimums, form information, deadline calendars, tax rule searches, form field searches, and ID validation. This represents comprehensive CRUD-like access to the domain with no apparent gaps for agent workflows.
Spanish Veri*factu invoicing: create invoices, expenses and VAT returns from your AI assistant.
Free no-auth tools for Spain: validate IBAN, EU VAT check (VIES), Modelo 303 sums, Veri*factu dates.
Run your rentals in Spain from your AI assistant: SES filings, VeriFactu invoices, rent, taxes.
Spanish autónomo bookkeeping and AEAT tax forms 303, 130, 390, 100: your model reads the documents
