Conversor IAE-CNAE — MCP for Spanish tax data
@conversoriaecnae
Public MCP manifest, docs and examples for Conversor IAE CNAE — the first Spanish fiscal MCP server (IAE, CNAE 2025, AEAT modelos, RETA).
Overview
What is Conversor IAE-CNAE — MCP for Spanish tax data?
The first fiscal MCP server for Spain. It gives any AI agent a direct line to live IAE codes (1,187), CNAE 2025 codes (1,060), AEAT tax-form obligations, the IAE↔CNAE crosswalk, módulos IRPF/IVA, and 2026 RETA brackets — all from official Spanish sources (AEAT, INE, BOE). Designed for autónomos and gestorías who need accurate, non-hallucinated tax data.
How to use Conversor IAE-CNAE — MCP for Spanish tax data?
No installation required; the server is hosted at conversoriaecnae.es. Connect any MCP-compatible client (Claude Desktop, ChatGPT, Cursor, Gemini CLI) by adding the Streamable HTTP endpoint: https://www.conversoriaecnae.es/api/mcp/mcp. For the 4 premium tools, add a cvr_ API key as a Bearer header. No registration needed for the 6 free tools.
Key features of Conversor IAE-CNAE — MCP for Spanish tax data.
- 10 tools total: 6 free, 4 premium.
- Semantic search across IAE and CNAE descriptions.
- Full IAE ↔ CNAE 2025 crosswalk lookups.
- Fiscal calendar with AEAT forms and deadlines.
- Premium: applicable AEAT obligations with confidence and frequency.
- Premium: módulos IRPF/IVA and 2026 RETA quota by net income.
Use cases of Conversor IAE-CNAE — MCP for Spanish tax data.
- Mapping IAE codes to their corresponding CNAE 2025 codes for tax filings.
- Retrieving the complete fiscal calendar (modelos 036/130/303/347 etc.) for a given activity.
- Bulk-lookup of up to 50 IAE or CNAE records for client portfolio management.
- Determining the applicable módulos (estimación objetiva) for an IAE activity.
- Computing the 2026 RETA minimum quota from a self-employed person’s net income.
FAQ from Conversor IAE-CNAE — MCP for Spanish tax data.
Which tools are free and which require payment?
Six tools are free with no key or signup: buscar_codigo, detalle_iae, detalle_cnae, detalle_cnae_2009, calendario_fiscal, and describe_conversor. Four premium tools (obligaciones_fiscales, modulos_irpf_iva, consulta_masiva, cuota_reta) require a Profesional plan (from €29/mo) with a cvr_ API key.
How do I connect to the server?
Add the server to your MCP client config as a Streamable HTTP endpoint at https://www.conversoriaecnae.es/api/mcp/mcp. For premium tools, include an Authorization: Bearer cvr_your_api_key header.
Where does the data come from?
All data is sourced from official Spanish institutions: AEAT (Agencia Tributaria) for IAE codes and fiscal models, INE (Instituto Nacional de Estadística) for CNAE 2025, and BOE for underlying regulation. Each response includes a freshness signal.
Does the server require self-hosting or installation?
No. The server is hosted at conversoriaecnae.es; there is nothing to install or self-host. The GitHub repository contains only the manifest, documentation, and examples.
What transport protocol does the server use?
It uses Streamable HTTP (MCP specification 2025-11-25). SSE is not exposed.