{ "markdown": "# Conversor IAE-CNAE — MCP Server\n\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)\n[![Transport](https://img.shields.io/badge/transport-streamable--http-111.svg)](#connect-in-30-seconds)\n[![Tools](https://img.shields.io/badge/tools-10%20(6%20free)-22c55e.svg)](#the-10-tools)\n\n\n> **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.\n\n**6 tools free. No key. No signup.** Add the endpoint and start asking.\n\nThis is the public manifest + docs repo for the hosted Conversor IAE-CNAE MCP server. The server runs at [conversoriaecnae.es](https://www.conversoriaecnae.es) — there is nothing to install or self-host. This repo holds the [`server.json`](./server.json) registry manifest, the connection details, the tool catalog, and copy-paste [examples](./examples/prompts.md).\n\n---\n\n## Why this exists\n\nAutó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.\n\nThis 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.\n\nIt is Spain-only, by design.\n\n## Connect in 30 seconds\n\nThe server speaks **Streamable HTTP** (MCP spec 2025-11-25; SSE is not exposed). Add it to your MCP client config:\n\n```json\n{\n \"mcpServers\": {\n \"conversor-iae-cnae\": {\n \"type\": \"streamable-http\",\n \"url\": \"https://www.conversoriaecnae.es/api/mcp/mcp\"\n }\n }\n}\n```\n\nFor the 4 premium tools, add your `cvr_` API key as a Bearer header inside the server block:\n\n```json\n{\n \"mcpServers\": {\n \"conversor-iae-cnae\": {\n \"type\": \"streamable-http\",\n \"url\": \"https://www.conversoriaecnae.es/api/mcp/mcp\",\n \"headers\": { \"Authorization\": \"Bearer cvr_your_api_key\" }\n }\n }\n}\n```\n\nWorks with **Claude Desktop / claude.ai** (also available as a native connector), **ChatGPT** (developer-mode connectors), **Cursor**, **Gemini CLI**, and any MCP-compatible client.\n\n- **Cursor one-click:** the \"Add to Cursor\" deeplink lives on the [connect page](https://www.conversoriaecnae.es/mcp).\n- **claude.ai connector:** add `https://www.conversoriaecnae.es/api/mcp/mcp` as a custom connector (OAuth handles auth automatically).\n\n## The 10 tools\n\n**6 free** (no key, no signup) · **4 premium** (Profesional plan, from €29/mo — via a `cvr_` key or Supabase OAuth).\n\n| Tool | Tier | What it does |\n|------|------|--------------|\n| `buscar_codigo` | Free | Semantic search across IAE / CNAE 2025 / CNAE 2009 by description |\n| `detalle_iae` | Free | Full record for an IAE code + its associated CNAE codes |\n| `detalle_cnae` | Free | Full record for a CNAE 2025 code + its associated IAE codes |\n| `detalle_cnae_2009` | Free | A (legacy) CNAE 2009 code and its CNAE 2025 correspondence |\n| `calendario_fiscal` | Free | AEAT forms and upcoming deadlines for a code |\n| `describe_conversor` | Free | Self-description: catalogs, RPCs and data freshness |\n| `obligaciones_fiscales` | Premium | Applicable AEAT forms with confidence, reason, frequency, deadline |\n| `modulos_irpf_iva` | Premium | Estimación objetiva (módulos) régimen for an IAE code |\n| `consulta_masiva` | Premium | Up to 50 IAE or CNAE records in a single call |\n| `cuota_reta` | Premium | 2026 RETA bracket + minimum quota from net income |\n\n## Free vs premium\n\n- **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.\n- **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.\n\n→ Get a key: **[conversoriaecnae.es/api-precios?source=mcp](https://www.conversoriaecnae.es/api-precios?source=mcp)**\n\n## Data sources\n\nOfficial 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.\n\n## Links\n\n- Connect / landing page — https://www.conversoriaecnae.es/mcp\n- Agent docs — https://www.conversoriaecnae.es/agents.md\n- Technical config (MCP section of the API docs) — https://www.conversoriaecnae.es/api/v1/docs#mcp\n- API pricing (premium keys) — https://www.conversoriaecnae.es/api-precios?source=mcp\n- Example prompts — [examples/prompts.md](./examples/prompts.md)\n\n---\n---\n\n# Conversor IAE-CNAE — Servidor MCP (Español)\n\n> **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.\n\n**6 herramientas gratis. Sin clave. Sin registro.** Añade el endpoint y empieza a preguntar.\n\nEste es el repositorio público de documentación y manifiesto del servidor MCP de Conversor IAE-CNAE. El servidor está alojado en [conversoriaecnae.es](https://www.conversoriaecnae.es) — no hay nada que instalar. Aquí encontrarás el manifiesto [`server.json`](./server.json), cómo conectarte, el catálogo de herramientas y [ejemplos](./examples/prompts.md).\n\n## Por qué existe\n\nLas 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.\n\nEste 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.\n\nEs solo para España, por diseño.\n\n## Conéctalo en 30 segundos\n\nEl servidor usa **Streamable HTTP** (MCP spec 2025-11-25; no se expone SSE). Añádelo a la configuración de tu cliente MCP:\n\n```json\n{\n \"mcpServers\": {\n \"conversor-iae-cnae\": {\n \"type\": \"streamable-http\",\n \"url\": \"https://www.conversoriaecnae.es/api/mcp/mcp\"\n }\n }\n}\n```\n\nPara las 4 herramientas premium, añade tu clave `cvr_` como cabecera Bearer dentro del bloque del servidor:\n\n```json\n\"headers\": { \"Authorization\": \"Bearer cvr_tu_clave_api\" }\n```\n\nCompatible con **Claude Desktop / claude.ai** (también como conector nativo), **ChatGPT** (conectores en modo desarrollador), **Cursor**, **Gemini CLI** y cualquier cliente compatible con MCP.\n\n## Las 10 herramientas\n\n**6 gratis** (sin clave ni registro) · **4 premium** (plan Profesional, desde 29 €/mes — con clave `cvr_` o Supabase OAuth).\n\n| Herramienta | Plan | Qué hace |\n|-------------|------|----------|\n| `buscar_codigo` | Gratis | Búsqueda semántica en IAE / CNAE 2025 / CNAE 2009 por descripción |\n| `detalle_iae` | Gratis | Ficha completa de un epígrafe IAE y sus CNAE asociados |\n| `detalle_cnae` | Gratis | Ficha completa de un CNAE 2025 y sus IAE asociados |\n| `detalle_cnae_2009` | Gratis | Un CNAE 2009 (obsoleto) y su correspondencia a CNAE 2025 |\n| `calendario_fiscal` | Gratis | Modelos AEAT y próximos plazos de un código |\n| `describe_conversor` | Gratis | Auto-descripción: catálogos, RPCs y frescura de datos |\n| `obligaciones_fiscales` | Premium | Modelos AEAT aplicables con confianza, motivo, periodicidad y plazo |\n| `modulos_irpf_iva` | Premium | Régimen de estimación objetiva (módulos) de un IAE |\n| `consulta_masiva` | Premium | Hasta 50 fichas IAE o CNAE en una sola llamada |\n| `cuota_reta` | Premium | Tramo y cuota mínima del RETA 2026 por rendimiento neto |\n\n## Gratis vs premium\n\n- **Gratis** responde *cuál es tu código* — buscar, consultar, convertir y ver el calendario fiscal. Útil por sí solo, sin cuenta.\n- **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.\n\n→ Consigue tu clave: **[conversoriaecnae.es/api-precios?source=mcp](https://www.conversoriaecnae.es/api-precios?source=mcp)**\n\n## Fuentes de datos\n\nSolo 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.\n\n## Contacto\n\n- Web: https://www.conversoriaecnae.es\n- Email: brian@conversoriaecnae.es\n", "bytes": 8954, "sha": "5930b2a3f7ffed9b0b6f82d4d31afeec801a5e082212e5816ec021b409ac0170", "repo_slug": "conversoriaecnae/mcp", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_conversoriaecnae_conversor_iae_85ea4f5b/readme" }