Conversor IAE-CNAE

conversoriaecnae/mcp

Plugs your AI agent directly into Spain's official tax infrastructure: 1,187 IAE codes from AEAT, 1,060 CNAE 2025 codes from INE, and the crosswalk between them. Six tools work without a key (semantic search, code lookups, IAE/CNAE detail retrieval, fiscal calendar queries). Four premium tools need a cvr_ API key and handle the stuff gestorías actually bill for: which AEAT modelos apply to a given activity, módulos IRPF/IVA calculations, bulk lookups for client portfolios, and 2026 RETA quota estimates from net income. Runs as a hosted streamable-http endpoint, so there's nothing to deploy. Built for Spanish autónomos, tax advisors, and fintech products that need to stop hallucinating BOE facts.

tools: 19
auth: Secret needed
transport: HTTP
last updated: Jun 2, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://www.conversoriaecnae.es/api/mcp/mcp --name conversor-iae-cnae --header 'Authorization: Bearer ${API_TOKEN}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http conversor-iae-cnae https://www.conversoriaecnae.es/api/mcp/mcp --header 'Authorization: YOUR_AUTHORIZATION'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 19 tools

Verified live against the running server on Nov 6, 2026.

buscar_codigoBusca códigos IAE/CNAE por descripción (búsqueda semántica). Cada resultado incluye la URL canónica de su página (url). Sin clave.4 params

Busca códigos IAE/CNAE por descripción (búsqueda semántica). Cada resultado incluye la URL canónica de su página (url). Sin clave.

Parameters* required

q*string

thresholdnumber

top_kinteger

typestring

one of iae · cnae · cnae_2009 · modelos · all

detalle_iaeFicha de un epígrafe IAE: título, descripción, elegibilidad de módulos y correspondencia IAE↔CNAE 2025, con la URL canónica de la página (url). Sin clave. El enriquecimiento con IA (ai_summary, fiscal_signals) requiere un plan de pago. Acepta un código cualificado (p. ej. B831...1 params

Ficha de un epígrafe IAE: título, descripción, elegibilidad de módulos y correspondencia IAE↔CNAE 2025, con la URL canónica de la página (url). Sin clave. El enriquecimiento con IA (ai_summary, fiscal_signals) requiere un plan de pago. Acepta un código cualificado (p. ej. B831...

Parameters* required

code*string

detalle_cnaeFicha de un código CNAE 2025: título, descripción, categoría, sector y correspondencia con IAE y CNAE 2009, con la URL canónica de la página (url). Sin clave. El enriquecimiento con IA (ai_summary, fiscal_signals) requiere un plan de pago.1 params

Ficha de un código CNAE 2025: título, descripción, categoría, sector y correspondencia con IAE y CNAE 2009, con la URL canónica de la página (url). Sin clave. El enriquecimiento con IA (ai_summary, fiscal_signals) requiere un plan de pago.

Parameters* required

code*string

detalle_cnae_2009Ficha de un código CNAE 2009 (obsoleto): título, descripción y correspondencia a CNAE 2025, con la URL canónica de la página (url). Sin clave. El enriquecimiento con IA (ai_summary, fiscal_signals) requiere un plan de pago.1 params

Ficha de un código CNAE 2009 (obsoleto): título, descripción y correspondencia a CNAE 2025, con la URL canónica de la página (url). Sin clave. El enriquecimiento con IA (ai_summary, fiscal_signals) requiere un plan de pago.

Parameters* required

code*string

calendario_fiscalModelos AEAT y próximos plazos para un código IAE/CNAE. Sin clave.2 params

Modelos AEAT y próximos plazos para un código IAE/CNAE. Sin clave.

Parameters* required

code*string

code_typestring

one of iae · cnaedefault: iae

describe_conversorAuto-descripción del servicio: catálogos, RPCs y frescura de datos. Sin clave.

Auto-descripción del servicio: catálogos, RPCs y frescura de datos. Sin clave.

No parameters. Call it with no arguments.

escala_irpfTramos de la escala IRPF estatal (general o ahorro), año 2026. Datos públicos. Sin clave.2 params

Tramos de la escala IRPF estatal (general o ahorro), año 2026. Datos públicos. Sin clave.

Parameters* required

aniointeger

default: 2026

escalastring

one of general · ahorrodefault: general

gastos_deduciblesGastos deducibles del IRPF del autónomo (todos o por categoría). Datos públicos. Sin clave.2 params

Gastos deducibles del IRPF del autónomo (todos o por categoría). Datos públicos. Sin clave.

Parameters* required

aniointeger

default: 2026

categoriastring

obligaciones_fiscalesModelos AEAT aplicables a un código (confianza, motivo, periodicidad, plazo). Datos públicos. Sin clave.2 params

Modelos AEAT aplicables a un código (confianza, motivo, periodicidad, plazo). Datos públicos. Sin clave.

Parameters* required

code*string

code_typestring

one of iae · cnaedefault: iae

modulos_irpf_ivaRégimen de estimación objetiva (módulos) de un IAE. Acepta un slug opcional para desambiguar códigos con varias actividades. Datos públicos. Sin clave.2 params

Régimen de estimación objetiva (módulos) de un IAE. Acepta un slug opcional para desambiguar códigos con varias actividades. Datos públicos. Sin clave.

Parameters* required

code*string

slugstring

cuota_retaCalcula el tramo y la cuota mínima estimada de autónomos (RETA) por rendimiento neto. Datos públicos. Sin clave.3 params

Calcula el tramo y la cuota mínima estimada de autónomos (RETA) por rendimiento neto. Datos públicos. Sin clave.

Parameters* required

aniointeger

default: 2026

neto*number

tablastring

one of general · reducidadefault: general

cuota_irpfCalcula la cuota íntegra ESTATAL del IRPF por suma marginal de tramos a partir de una base liquidable. No incluye escala autonómica ni mínimos. Datos públicos. Sin clave.3 params

Calcula la cuota íntegra ESTATAL del IRPF por suma marginal de tramos a partir de una base liquidable. No incluye escala autonómica ni mínimos. Datos públicos. Sin clave.

Parameters* required

aniointeger

default: 2026

base*number

escalastring

one of general · ahorrodefault: general

buscar_doctrina_teacBusca resoluciones y criterios del Tribunal Económico-Administrativo Central (TEAC) por tema o texto (IVA, IRPF, sociedades, procedimiento…). Devuelve número, asunto, criterio y enlace. Sin clave.2 params

Busca resoluciones y criterios del Tribunal Económico-Administrativo Central (TEAC) por tema o texto (IVA, IRPF, sociedades, procedimiento…). Devuelve número, asunto, criterio y enlace. Sin clave.

Parameters* required

limitinteger

query*string

empresas_por_actividadDevuelve estadísticas de constitución de empresas (recuento, capital medio/mediano, tendencia mensual, provincias) para un código CNAE-2025. Datos a nivel de empresa (Ley 37/2007), sin datos personales. Sin clave. La lista completa de constituciones recientes (denominación soc...1 params

Devuelve estadísticas de constitución de empresas (recuento, capital medio/mediano, tendencia mensual, provincias) para un código CNAE-2025. Datos a nivel de empresa (Ley 37/2007), sin datos personales. Sin clave. La lista completa de constituciones recientes (denominación soc...

Parameters* required

code*string

Código CNAE-2025 (con o sin puntos), p.ej. 6820

subvenciones_por_actividadDevuelve subvenciones/ayudas públicas ABIERTAS (convocatorias BDNS) para un código CNAE-2025: total abiertas, cuántas son para autónomos/PYME, y una muestra (título, órgano, ámbito, dotación, enlace oficial). Con plan de pago: lista completa y filtro solo_actividad. Solo convo...2 params

Devuelve subvenciones/ayudas públicas ABIERTAS (convocatorias BDNS) para un código CNAE-2025: total abiertas, cuántas son para autónomos/PYME, y una muestra (título, órgano, ámbito, dotación, enlace oficial). Con plan de pago: lista completa y filtro solo_actividad. Solo convo...

Parameters* required

code*string

Código CNAE-2025 (con o sin puntos), p.ej. 4711

solo_actividadboolean

Solo ayudas dirigidas a autónomos/PYME/empresas

tarifa_at_epTarifa de cotización por accidentes de trabajo y enfermedades profesionales (AT/EP) de una actividad CNAE-2025. Gratis: el tipo total + la nota de aplicación (por cuenta ajena; el autónomo cotiza al 1,30 %). El desglose IT/IMS y la cita normativa (source_anchor) requieren un p...1 params

Tarifa de cotización por accidentes de trabajo y enfermedades profesionales (AT/EP) de una actividad CNAE-2025. Gratis: el tipo total + la nota de aplicación (por cuenta ajena; el autónomo cotiza al 1,30 %). El desglose IT/IMS y la cita normativa (source_anchor) requieren un p...

Parameters* required

code*string

Código CNAE-2025 (con o sin puntos), p.ej. 6820

texto_normativaTexto consolidado y VIGENTE de un artículo del BOE (norma, rango, estado, texto legal, fecha de vigencia y enlace). Sin articulo: devuelve el índice de artículos vigentes de la norma. Solo texto en vigor (no histórico), citable como fuente oficial. Sin clave. Con clave: hechos...2 params

Texto consolidado y VIGENTE de un artículo del BOE (norma, rango, estado, texto legal, fecha de vigencia y enlace). Sin articulo: devuelve el índice de artículos vigentes de la norma. Solo texto en vigor (no histórico), citable como fuente oficial. Sin clave. Con clave: hechos...

Parameters* required

articulostring

Número de artículo a consultar, p.ej. 91 o 91 bis

boe_id*string

Identificador BOE de la norma, p.ej. BOE-A-1992-28740

consulta_dgtBusca consultas vinculantes de la Dirección General de Tributos (DGT) por texto libre en español (stemming/acentos). Gratis: el resumen de la consulta más relevante. Con un plan de pago: la lista completa ordenada por relevancia y el filtro por código IAE. Solo doctrina públic...2 params

Busca consultas vinculantes de la Dirección General de Tributos (DGT) por texto libre en español (stemming/acentos). Gratis: el resumen de la consulta más relevante. Con un plan de pago: la lista completa ordenada por relevancia y el filtro por código IAE. Solo doctrina públic...

Parameters* required

codestring

Código IAE con puntos (p.ej. 659.3) para filtrar — solo plan de pago

query*string

Texto a buscar, p.ej. 'recargo de equivalencia comercio menor'

consulta_masivaHasta 50 fichas IAE o CNAE en una llamada. Requiere un plan de pago.2 params

Hasta 50 fichas IAE o CNAE en una llamada. Requiere un plan de pago.

Parameters* required

codes*array

type*string

one of iae · cnae

Readme

Conversor IAE-CNAE — MCP Server

The first fiscal MCP server for Spain. Connect any AI agent to live IAE, CNAE 2025, AEAT tax-form and RETA data — official sources, no scrapers.

6 tools free. No key. No signup. Add the endpoint and start asking.

This is the public manifest + docs repo for the hosted Conversor IAE-CNAE MCP server. The server runs at conversoriaecnae.es — there is nothing to install or self-host. This repo holds the server.json registry manifest, the connection details, the tool catalog, and copy-paste examples.

Why this exists

View the full README on GitHub

Details

Repository: github.com/conversoriaecnae/mcp
Website: www.conversoriaecnae.es/mcp
Transport: HTTP
Auth: Required
Registry: MCP registry, active
Tools verified: Nov 6, 2026