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

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:

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

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

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

• Connect / landing page — https://www.conversoriaecnae.es/mcp
• Agent docs — https://www.conversoriaecnae.es/agents.md
• Technical config (MCP section of the API docs) — https://www.conversoriaecnae.es/api/v1/docs#mcp
• API pricing (premium keys) — https://www.conversoriaecnae.es/api-precios?source=mcp
• Example prompts — examples/prompts.md

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:

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

"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).

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

• Web: https://www.conversoriaecnae.es
• Email: brian@conversoriaecnae.es