Conversor IAE-CNAE

io.github.conversoriaecnae由 GitHub 账号 conversoriaecnae 发布v1.0.1更新于 Oct 25, 2026

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

已验证Streamable HTTP可网页运行金融商业与电商

概览

AI 生成的概览

托管的西班牙财税数据服务器，让助手依据官方来源查询 IAE 与 CNAE 2025 代码、AEAT 税表、IRPF/IVA 规则和 RETA 缴费额。

可以做什么
按描述检索 IAE、CNAE 2025 和 CNAE 2009 代码，读取含交叉对应关系和官方页面链接的完整记录，付费方案支持一次最多 50 条批量查询。查询某代码适用的 AEAT 税表与临近截止日期，以及带置信度、原因、周期和期限的申报义务。查阅 IRPF/IVA 规则：模块制、可扣除费用、IRPF 税率级距及国家层面 IRPF 税额计算。按净收入估算自雇者 RETA 级距与最低缴费额。检索 BOE 现行合并法律条文、TEAC 裁决和 DGT 具约束力咨询。获取某 CNAE 2025 的公司设立统计、开放公共补贴和 AT/EP 缴费费率。
适用场景
适合西班牙自雇者、税务代办机构和金融科技场景：助手需要把 IAE 映射到 CNAE、确认适用哪些 AEAT 税表，或依据官方数据而非猜测回答 IRPF、IVA 和 RETA 问题。按设计仅限西班牙。
运行要求
远程 Streamable HTTP 端点，无需安装或自托管。免费工具无需密钥或注册。付费工具需要 Profesional 方案（每月 29 欧元起），并通过 Authorization Bearer 头提供 cvr_ API 密钥，或使用 Supabase OAuth。兼容 Claude、ChatGPT、Cursor、Gemini CLI 等 MCP 客户端。
安装前请注意
付费工具需要付费订阅。Authorization 头携带密钥，应妥善保密。部分工具在未付费时只返回样本或摘要。返回的是财税参考数据而非税务建议，且服务仅限西班牙。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Conversor IAE-CNAE，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.conversoriaecnae%2Fconversor-iae-cnae/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "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

来源：README.md，提交 2cd82f5

工具

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.

输入参数q必填typetop_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.

输入参数code必填

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.

输入参数code必填

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.

输入参数code必填

calendario_fiscal

Calendario fiscal

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

输入参数code必填code_type

describe_conversor

Describe Conversor

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

无需输入参数。

escala_irpf

Escala IRPF estatal

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

输入参数anioescala

gastos_deducibles

Gastos deducibles del autónomo

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

输入参数aniocategoria

obligaciones_fiscales

Obligaciones fiscales

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

输入参数code必填code_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.

输入参数code必填slug

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.

输入参数anioneto必填tabla

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.

输入参数aniobase必填escala

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.

输入参数limitquery必填

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.

输入参数code必填

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.

输入参数code必填solo_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.

输入参数code必填

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.

输入参数boe_id必填articulo

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.

输入参数codequery必填

consulta_masiva

Consulta masiva

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

输入参数type必填codes必填

版本历史

1
  1. v1.0.1最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分