Conversor IAE-CNAE

io.github.conversoriaecnaePublished by GitHub account conversoriaecnaev1.0.1Updated Oct 25, 2026

The first fiscal MCP server for Spain: IAE/CNAE 2025, AEAT modelos, IRPF/IVA, RETA quota.

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Hosted Spanish fiscal data server that lets an assistant look up IAE and CNAE 2025 codes, AEAT tax forms, IRPF/IVA rules and RETA quotas from official sources.

What you can do
Search IAE, CNAE 2025 and CNAE 2009 codes by description and read full records with their cross-references and canonical page links, including bulk lookups of up to 50 records on paid plans. Retrieve AEAT tax forms and upcoming deadlines for a code, plus applicable obligations with confidence, reason, frequency and deadline. Consult IRPF/IVA rules: módulos régimen, deductible expenses, IRPF brackets and state IRPF quota calculation. Estimate the RETA self-employed bracket and minimum quota from net income. Look up BOE consolidated legal text, TEAC resolutions and DGT binding consultations. Get company-formation statistics, open public subsidies and AT/EP contribution rates for a CNAE 2025, a
When to use it
Useful for Spanish autónomos, gestorías and fintech work where an assistant must map IAE to CNAE codes, check which AEAT forms apply, or answer IRPF, IVA and RETA questions from official data instead of guessing. It is Spain-only by design.
Requirements
A remote Streamable HTTP endpoint; nothing to install or self-host. No key or signup for the free tools. The paid tools need a Profesional plan (from €29/month) and a cvr_ API key sent as an Authorization Bearer header, or Supabase OAuth. Works with Claude, ChatGPT, Cursor, Gemini CLI and other MCP clients.
Before you install
The paid tools require a subscription that costs money. The Authorization header carries a secret API key that should be kept private. Some tools return only a sample or summary without a paid plan. Responses are fiscal reference data, not tax advice, and the server is limited to Spain.

Installation

In SourceWeft

  1. Open Conversor IAE-CNAE in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.conversoriaecnae%2Fconversor-iae-cnae/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "conversor-iae-cnae": {
      "type": "http",
      "url": "https://www.conversoriaecnae.es/api/mcp/mcp"
    }
  }
}

README

Conversor IAE-CNAE — MCP Server

[License: MIT] [Transport] [Tools]

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

Autónomos and gestorías in Spain lose hours mapping IAE ↔ CNAE codes and guessing which AEAT forms (modelos 036/130/303/347…) apply to an activity. General-purpose AI agents make it worse: they confidently hallucinate tax facts that are wrong.

This server gives your agent a direct line to the real data — 1,187 IAE codes from the AEAT, 1,060 CNAE 2025 codes from the INE, the IAE↔CNAE crosswalk, módulos IRPF/IVA, AEAT obligations, and the 2026 RETA brackets — so it answers from official sources instead of guessing.

It is Spain-only, by design.

Connect in 30 seconds

The server speaks Streamable HTTP (MCP spec 2025-11-25; SSE is not exposed). Add it to your MCP client config:

json
{  "mcpServers": {    "conversor-iae-cnae": {      "type": "streamable-http",      "url": "https://www.conversoriaecnae.es/api/mcp/mcp"    }  }}

For the 4 premium tools, add your cvr_ API key as a Bearer header inside the server block:

json
{  "mcpServers": {    "conversor-iae-cnae": {      "type": "streamable-http",      "url": "https://www.conversoriaecnae.es/api/mcp/mcp",      "headers": { "Authorization": "Bearer cvr_your_api_key" }    }  }}

Works with Claude Desktop / claude.ai (also available as a native connector), ChatGPT (developer-mode connectors), Cursor, Gemini CLI, and any MCP-compatible client.

  • Cursor one-click: the "Add to Cursor" deeplink lives on the connect page.
  • claude.ai connector: add https://www.conversoriaecnae.es/api/mcp/mcp as a custom connector (OAuth handles auth automatically).

The 10 tools

6 free (no key, no signup) · 4 premium (Profesional plan, from €29/mo — via a cvr_ key or Supabase OAuth).

ToolTierWhat it does
buscar_codigoFreeSemantic search across IAE / CNAE 2025 / CNAE 2009 by description
detalle_iaeFreeFull record for an IAE code + its associated CNAE codes
detalle_cnaeFreeFull record for a CNAE 2025 code + its associated IAE codes
detalle_cnae_2009FreeA (legacy) CNAE 2009 code and its CNAE 2025 correspondence
calendario_fiscalFreeAEAT forms and upcoming deadlines for a code
describe_conversorFreeSelf-description: catalogs, RPCs and data freshness
obligaciones_fiscalesPremiumApplicable AEAT forms with confidence, reason, frequency, deadline
modulos_irpf_ivaPremiumEstimación objetiva (módulos) régimen for an IAE code
consulta_masivaPremiumUp to 50 IAE or CNAE records in a single call
cuota_retaPremium2026 RETA bracket + minimum quota from net income

Free vs premium

  • Free answers what your code is — search, look up, convert, and see the fiscal calendar. Enough to be useful on its own, with no account.
  • Premium answers what you must file — the obligations, the módulos régimen, bulk lookups for client portfolios, and the RETA quota. Built for gestorías, asesorías and fintech in production. From €29/mo, no commitment.

→ Get a key: conversoriaecnae.es/api-precios?source=mcp

Data sources

Official only: AEAT (Agencia Tributaria) for IAE codes and modelos, INE (Instituto Nacional de Estadística) for CNAE 2025, and the BOE for the underlying regulation. Every response carries a freshness signal, and describe_conversor exposes the catalogs and their update dates.

Links

Conversor IAE-CNAE — Servidor MCP (Español)

El primer servidor MCP fiscal de España. Conecta tu agente de IA a códigos IAE, CNAE 2025, obligaciones AEAT y cuota RETA con datos oficiales.

6 herramientas gratis. Sin clave. Sin registro. Añade el endpoint y empieza a preguntar.

Este es el repositorio público de documentación y manifiesto del servidor MCP de Conversor IAE-CNAE. El servidor está alojado en conversoriaecnae.es — no hay nada que instalar. Aquí encontrarás el manifiesto server.json, cómo conectarte, el catálogo de herramientas y ejemplos.

Por qué existe

Las gestorías y los autónomos pierden horas mapeando códigos IAE ↔ CNAE y comprobando qué modelos AEAT (036/130/303/347…) aplican a cada actividad. Los agentes de IA genéricos lo empeoran: alucinan datos fiscales con total seguridad, y muchas veces son incorrectos.

Este servidor da a tu agente acceso directo a los datos reales —1.187 epígrafes IAE de la AEAT, 1.060 códigos CNAE 2025 del INE, la correspondencia IAE↔CNAE, módulos IRPF/IVA, obligaciones AEAT y los tramos del RETA 2026— para que responda con fuentes oficiales en lugar de adivinar.

Es solo para España, por diseño.

Conéctalo en 30 segundos

El servidor usa Streamable HTTP (MCP spec 2025-11-25; no se expone SSE). Añádelo a la configuración de tu cliente MCP:

json
{  "mcpServers": {    "conversor-iae-cnae": {      "type": "streamable-http",      "url": "https://www.conversoriaecnae.es/api/mcp/mcp"    }  }}

Para las 4 herramientas premium, añade tu clave cvr_ como cabecera Bearer dentro del bloque del servidor:

json
"headers": { "Authorization": "Bearer cvr_tu_clave_api" }

Compatible con Claude Desktop / claude.ai (también como conector nativo), ChatGPT (conectores en modo desarrollador), Cursor, Gemini CLI y cualquier cliente compatible con MCP.

Las 10 herramientas

6 gratis (sin clave ni registro) · 4 premium (plan Profesional, desde 29 €/mes — con clave cvr_ o Supabase OAuth).

HerramientaPlanQué hace
buscar_codigoGratisBúsqueda semántica en IAE / CNAE 2025 / CNAE 2009 por descripción
detalle_iaeGratisFicha completa de un epígrafe IAE y sus CNAE asociados
detalle_cnaeGratisFicha completa de un CNAE 2025 y sus IAE asociados
detalle_cnae_2009GratisUn CNAE 2009 (obsoleto) y su correspondencia a CNAE 2025
calendario_fiscalGratisModelos AEAT y próximos plazos de un código
describe_conversorGratisAuto-descripción: catálogos, RPCs y frescura de datos
obligaciones_fiscalesPremiumModelos AEAT aplicables con confianza, motivo, periodicidad y plazo
modulos_irpf_ivaPremiumRégimen de estimación objetiva (módulos) de un IAE
consulta_masivaPremiumHasta 50 fichas IAE o CNAE en una sola llamada
cuota_retaPremiumTramo y cuota mínima del RETA 2026 por rendimiento neto

Gratis vs premium

  • Gratis responde cuál es tu código — buscar, consultar, convertir y ver el calendario fiscal. Útil por sí solo, sin cuenta.
  • Premium responde qué tienes que presentar — obligaciones, régimen de módulos, consultas masivas para carteras de clientes y la cuota del RETA. Pensado para gestorías, asesorías y fintech en producción. Desde 29 €/mes, sin permanencia.

→ Consigue tu clave: conversoriaecnae.es/api-precios?source=mcp

Fuentes de datos

Solo oficiales: AEAT para epígrafes IAE y modelos, INE para CNAE 2025 y BOE para la normativa. Cada respuesta incluye la frescura de los datos, y describe_conversor expone los catálogos y sus fechas de actualización.

Contacto

Source: README.md at commit 2cd82f5

Tools

19

buscar_codigo

Buscar código

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.

Parametersqrequiredtypetop_kthreshold

detalle_iae

Detalle IAE

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) para desambiguar epígrafes con varias secciones.

Parameterscoderequired

detalle_cnae

Detalle CNAE

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.

Parameterscoderequired

detalle_cnae_2009

Detalle CNAE 2009

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.

Parameterscoderequired

calendario_fiscal

Calendario fiscal

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

Parameterscoderequiredcode_type

describe_conversor

Describe Conversor

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

Takes no parameters.

escala_irpf

Escala IRPF estatal

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

Parametersanioescala

gastos_deducibles

Gastos deducibles del autónomo

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

Parametersaniocategoria

obligaciones_fiscales

Obligaciones fiscales

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

Parameterscoderequiredcode_type

modulos_irpf_iva

Módulos IRPF/IVA

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.

Parameterscoderequiredslug

cuota_reta

Cuota RETA 2026

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

Parametersanionetorequiredtabla

cuota_irpf

Cuota IRPF estatal

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.

Parametersaniobaserequiredescala

buscar_doctrina_teac

Buscar doctrina del TEAC

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.

Parameterslimitqueryrequired

empresas_por_actividad

Empresas constituidas por actividad (CNAE)

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 social) requiere clave Profesional; sin clave se devuelve una muestra de 3.

Parameterscoderequired

subvenciones_por_actividad

Subvenciones y ayudas abiertas por actividad (CNAE)

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 convocatorias públicas, sin datos personales. Sin clave.

Parameterscoderequiredsolo_actividad

tarifa_at_ep

Tarifa AT/EP por CNAE

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 plan de pago.

Parameterscoderequired

texto_normativa

Texto normativo BOE (consolidado y vigente)

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 + texto completo.

Parametersboe_idrequiredarticulo

consulta_dgt

Consultas vinculantes DGT por texto

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ública, sin datos personales. Sin clave.

Parameterscodequeryrequired

consulta_masiva

Consulta masiva

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

Parameterstyperequiredcodesrequired

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts