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 分