API abierta, MCP y WebMCP
Conecta tu programa, tu estudio o tu agente de IA a los datos de mireforma.net: qué trámite pide cada municipio y cuánto es el ICIO, precios de tarifa de fabricantes con su fuente, quién distribuye o instala cerca y el presupuesto por partidas, también en FIEBDC-3 (.bc3).
Empezar
Las rutas públicas no piden cuenta. La descripción completa está en /openapi.json (OpenAPI 3.1, versión 1.1.0); cualquier visor OpenAPI (Swagger UI, Redoc, Scalar, Postman, Bruno) la abre tal cual.
# Normativa de Barcelona (ICIO, tasa, sede, urbanismo, habitabilidad)
curl https://mireforma.net/api/municipios/08019
# Presupuesto de un baño de 5 m² en Barcelona, eligiendo marca de inodoro
curl -X POST https://mireforma.net/api/presupuesto/calcular \
-H 'content-type: application/json' \
-d '{"estancias":[{"tipo":"bano","superficie":5,"elecciones":{"inodoro":{"marca":"roca"}}}],"ine":"08019"}'
# El mismo presupuesto en FIEBDC-3 para Presto, Arquímedes o CYPE
curl -o presupuesto.bc3 'https://mireforma.net/api/presupuesto/calcular?tipo=bano&m2=5&ine=08019&formato=bc3'
# Tarifas oficiales de grifería de una marca
curl 'https://mireforma.net/api/catalogo?marca=grohe&familia=griferia&limite=5'
Rutas
Públicas (sin cuenta, con CORS)
| Método | Ruta | Qué hace |
|---|---|---|
GET | /api/catalogo | Buscar referencias del catálogo |
GET | /api/directorio | Distribuidores e instaladores por categoría, marca y zona |
GET | /api/presupuesto/calcular | Presupuesto de una estancia (atajo GET) |
POST | /api/presupuesto/calcular | Presupuesto por embudo de decisiones |
POST | /api/lista-compra/calcular | Lista de compra y dónde comprar cada producto |
GET | /api/lista-compra/calcular | Lista de compra de una estancia (atajo GET) |
GET | /api/presupuesto/opciones | Opciones de nivel 2 para un concepto, de la más barata a la más cara |
GET | /api/municipios | Buscar municipios por nombre |
GET | /api/municipios/{ine} | Normativa de reforma de un municipio |
GET | /api/validar-plano | Formatos, ejemplos y versión de reglas del validador |
POST | /api/validar-plano | Validar un plano contra CTE, habitabilidad y ordenanza; trámite y documentos |
GET | /api/validar-plano/esquema | JSON Schema de mireforma-plano/1 |
GET | /api/validar-plano/ejemplos/{id} | Plano de ejemplo |
De proyecto (con cuenta)
Piden OAuth 2.1 con PKCE (metadatos en /.well-known/oauth-authorization-server, RFC 8414, y registro dinámico RFC 7591) o un token personal creado en tu cuenta, en la cabecera Authorization: Bearer.
| Método | Ruta | Qué hace |
|---|---|---|
GET | /api/proyecto/presupuesto-estimado | Presupuesto estimado del proyecto (JSON, CSV o BC3) |
POST | /api/proyecto/importar-bc3 | Importar partidas y precios de un .bc3 al proyecto |
POST | /api/proyecto/importar-plano | Importar estancias y m² desde Magicplan, IFC, DXF o Planner 5D |
POST | /api/proyecto/importar-plano/remoto | Traer el plano de Magicplan o Planner 5D con tu propia clave |
Licencia, atribución y límites
- Licencia de los datos
- Creative Commons Atribución 4.0 (CC BY 4.0). Cita «mireforma.net» con enlace a la página o a la ruta de la API. Cada respuesta pública lo indica en la cabecera
Link: <…>; rel="license"(RFC 8288). - Lo que no se republica
- PDF, fotos y modelos 3D de fabricantes: cada precio lleva el enlace a su documento oficial. Los nombres de marca sirven solo para identificar el producto.
- Directorio
- Solo empresas, sin teléfonos ni correos.
- Límites
- 60 peticiones por minuto e IP en la API pública y 30 en el validador de planos. Las respuestas llevan
RateLimityRateLimit-Policy(borrador IETF httpapi-ratelimit-headers); al pasarse,429conRetry-After. - CORS
- Las rutas públicas admiten
GETdesde cualquier origen, yPOSTen las calculadoras y el validador, sin cookies. Las rutas de proyecto no tienen CORS. - Orientativo
- Los presupuestos y validaciones son orientativos: no son una oferta ni sustituyen al técnico ni al Ayuntamiento.
Presupuestos en FIEBDC-3 (.bc3)
FIEBDC-3 es el formato estándar de intercambio de bases de precios y presupuestos de obra en España (especificación de la Asociación FIEBDC). mireforma escribe FIEBDC-3/2024 con juego de caracteres ANSI: un concepto raíz, un capítulo por estancia, una partida por línea con su medición (~M), su texto con la fuente del precio (~T) y su descomposición en material (tipo 3, con la merma como rendimiento) y mano de obra (tipo 1). El precio de cada partida es la suma de su descomposición y el total coincide con el presupuesto de ejecución material.
- Exportar un presupuesto público:
GET|POST /api/presupuesto/calcular?formato=bc3. - Exportar el de tu proyecto:
GET /api/proyecto/presupuesto.bc3o/api/proyecto/presupuesto-estimado?formato=bc3. - Importar un .bc3 de Presto, Arquímedes, CYPE, TCQ, BEDEC o la BCCA:
POST /api/proyecto/importar-bc3con el fichero enapplication/octet-streamo{"fichero":{"nombre":"obra.bc3","base64":"…"}}. Lee el juego de caracteres del registro~V(ANSI, 850 o 437), crea partidas de obra con capítulo, código, unidad, medición y texto, y guarda cada precio como opción sin elegirla.dry_run=truesolo informa; repetir no duplica.
curl -X POST 'https://mireforma.net/api/proyecto/importar-bc3?dry_run=true&nombre=obra.bc3' \
-H 'authorization: Bearer TU_TOKEN' \
-H 'content-type: application/octet-stream' \
--data-binary @obra.bc3
Planos: Magicplan, IFC, DXF y Planner 5D
POST /api/proyecto/importar-plano crea en tu proyecto las estancias del plano con sus m² y su tipo. Con actualizar=true corrige las que ya existen; nunca borra. Acepta:
- Magicplan: el JSON de su API REST (plan con
floors[].rooms[]), el CSV «room list» de la app, o sus exportaciones IFC y DXF. - IFC (IFC2x3 o IFC4, de cualquier programa BIM): cada
IfcSpacecon su área neta y altura. - DXF: polilíneas cerradas en capas de estancias, con el nombre del texto interior.
- Planner 5D: el documento de escena de su API pública (
GET /projects/{hash}/document).
curl -X POST https://mireforma.net/api/proyecto/importar-plano \
-H 'authorization: Bearer TU_TOKEN' -H 'content-type: application/json' \
-d '{"fichero":{"nombre":"room-list.csv","texto":"Room;Floor;Area (m²);Height (m)\nBathroom;Ground floor;3,9;2,5"},"dry_run":true}'
Si el servidor tiene el conector habilitado, POST /api/proyecto/importar-plano/remoto trae el plano directamente con tu propia clave de Magicplan (customer_id y api_key) o tu token de Planner 5D. La clave se usa en esa petición y no se guarda. Magicplan pide un plan con API de su workspace y Planner 5D, acceso comercial o PRO.
Para validar el plano contra el CTE, la habitabilidad autonómica y la ordenanza del municipio, usa el validador (POST /api/validar-plano).
MCP
El servidor MCP de mireforma (Model Context Protocol, transporte HTTP «streamable») está en https://mireforma.net/mcp. Se autoriza con OAuth 2.1: el cliente descubre el servidor de autorización en /.well-known/oauth-protected-resource/mcp (RFC 9728). Guía paso a paso en Conectar.
Sin cuenta: https://mireforma.net/mcp/public ofrece solo las herramientas públicas de lectura (permisos e ICIO, tarifas, presupuesto, lista de compra, validador y directorio), sin OAuth ni token. Registro MCP: net.mireforma/mireforma.
Puedes usarlo junto al MCP de Magicplan (https://cloud.magicplan.app/mcp, con tu cuenta de Magicplan): el agente lee el plano medido allí y lo importa aquí con reforma_import_floor_plan.
Herramientas públicas (7)
| Herramienta | Ruta | Descripción |
|---|---|---|
reforma_search_catalog | GET /api/catalogo | Busca referencias del catálogo de tarifas oficiales de fabricantes (PVP o tarifa, en euros y sin IVA). Filtra por marca, familia, referencia, texto y rango de precio. Devuelve el enlace al PDF original; no republica los PDF ni incluye teléfonos o correos. |
reforma_estimate_budget | POST /api/presupuesto/calcular | Presupuesto de reforma por embudo: estancias (tipo y m²) → rango; elecciones de marca o referencia por concepto (si no, la más barata que cumple); precio de proveedor. Material con tarifa oficial, mano de obra con fuente, IVA e ICIO del municipio. |
reforma_shopping_list | POST /api/lista-compra/calcular | Lista de compra: productos agrupados, cantidades, precio de tarifa con tipo y vigencia, enlace oficial y distribuidores o tiendas de la provincia (sin teléfonos ni correos). |
reforma_budget_options | GET /api/presupuesto/opciones | Opciones del catálogo para un concepto del presupuesto, de la más barata a la más cara, con la más barata de cada marca. |
reforma_validate_plan | POST /api/validar-plano | Valida un plano de reforma contra la normativa del municipio (CTE, habitabilidad autonómica, ordenanza local) y explica el trámite: régimen, documentos, ICIO, tasa, sede y pasos. Cada resultado cita su norma. Orientativo, no sustituye al técnico. |
reforma_search_municipalities | GET /api/municipios | Busca municipios por nombre y devuelve su código INE, provincia, comunidad y ficha de permisos. |
reforma_get_municipality | GET /api/municipios/:ine | Normativa de reforma de un municipio por código INE: ICIO, tasa, sede electrónica, ley urbanística y de habitabilidad de su comunidad, zona climática del CTE y reglas autonómicas y municipales que aplica el validador. Sin teléfonos ni correos. |
Herramientas de proyecto (66)
| Herramienta | Ruta | Descripción |
|---|---|---|
reforma_list_rooms | GET /api/estancias | Lista las estancias del proyecto. |
reforma_create_room | POST /api/estancias | Crea una estancia que el plano no tiene. |
reforma_update_room | PATCH /api/estancias/:id | Edita nombre, tipo, superficie o notas de una estancia. |
reforma_delete_room | DELETE /api/estancias/:id | Borra una estancia manual. |
reforma_list_plans | GET /api/planos | Lista plantas, renders y documentos del proyecto. |
reforma_get_bom | GET /api/bom | Lee partidas, opciones, la elegida y el resumen. |
reforma_create_item | POST /api/partidas | Crea una partida o una decisión. |
reforma_update_item | PATCH /api/partidas/:id | Edita medición, ámbito, alcance o resolución de una partida. |
reforma_delete_item | DELETE /api/partidas/:id | Borra una partida, sus opciones y sus fotos. |
reforma_split_item | POST /api/partidas/:id/desdoblar | Separa una decisión de varias estancias en una por estancia. |
reforma_choose_option | POST /api/partidas/:id/elegir | Elige una opción de la partida, o quita la elección. |
reforma_add_option | POST /api/partidas/:id/opciones | Añade una opción de tienda a una partida. |
reforma_update_option | PATCH /api/opciones/:id | Edita precio, marca, referencia o url de una opción. |
reforma_delete_option | DELETE /api/opciones/:id | Borra una opción y sus fotos. |
reforma_list_stores | GET /api/tiendas | Lista el directorio de tiendas y gremios. |
reforma_create_store | POST /api/tiendas | Crea una ficha de tienda o gremio. |
reforma_update_store | PATCH /api/tiendas/:id | Edita una ficha de tienda. |
reforma_delete_store | DELETE /api/tiendas/:id | Borra una ficha de tienda. |
reforma_import_stores | POST /api/importar-tiendas | Siembra el directorio de tiendas sin pisar fichas editadas. |
reforma_list_visits | GET /api/visitas | Lee la visita abierta y el historial. |
reforma_start_visit | POST /api/visitas | Empieza una visita a una tienda. |
reforma_close_visit | POST /api/visitas/:id/cerrar | Cierra la visita y marca la tienda como visitada. |
reforma_list_documents | GET /api/documentos | Lista los documentos del proyecto. |
reforma_update_document | PATCH /api/documentos/:id | Edita nombre, clase, importe o notas de un documento. |
reforma_delete_document | DELETE /api/documentos/:id | Borra un documento y su fichero. |
reforma_upload_document | POST /api/documentos | Sube un PDF o una imagen de la obra. |
reforma_upload_store_document | POST /api/tiendas/:id/documentos | Sube una factura o un presupuesto de un proveedor. |
reforma_upload_option_photo | POST /api/opciones/:id/fotos | Sube una foto de una opción. |
reforma_upload_room_photo | POST /api/estancias/:id/fotos | Sube una foto o un render de una estancia. |
reforma_update_photo | PATCH /api/fotos/:id | Cambia el pie de una foto. |
reforma_delete_room_renders | DELETE /api/estancias/:id/renders | Borra los renders de una estancia. |
reforma_delete_photo | DELETE /api/fotos/:id | Borra una foto. |
reforma_import_work | POST /api/importar-obra | Importa las partidas de obra de los amidaments. |
reforma_import_catalog | POST /api/importar-catalogo | Importa el catálogo de decisiones de compra. |
reforma_migrate_to_tree | POST /api/migrar-arbol | Copia partidas y opciones al árbol nuevo. dry_run true (el defecto) solo informa. Nunca modifica el legado. |
reforma_apply_pack_template | POST /api/aplicar-plantilla | Parte un pack en piezas según su plantilla. dry_run true por defecto. No toca la opción elegida ni el legado. |
reforma_search_directory | GET /api/directorio | Busca distribuidores e instaladores por categoría, marca y zona. Ordena municipio, provincia y comunidad. Sin teléfonos ni correos. |
reforma_get_checklist | GET /api/checklist | Lee fases, tareas y el resumen del checklist. |
reforma_import_checklist | POST /api/importar-checklist | Importa el checklist sin pisar tareas editadas. |
reforma_export_checklist_csv | GET /api/checklist.csv | Exporta el checklist en CSV. |
reforma_create_task | POST /api/tareas | Crea una tarea del checklist. |
reforma_update_task | PATCH /api/tareas/:id | Edita una tarea, la marca hecha o le vincula decisiones. |
reforma_delete_task | DELETE /api/tareas/:id | Borra una tarea. |
reforma_list_quotes | GET /api/ofertas | Lista las ofertas de las constructoras. |
reforma_create_quote | POST /api/ofertas | Crea una oferta de constructora. |
reforma_update_quote | PATCH /api/ofertas/:id | Edita una oferta. |
reforma_delete_quote | DELETE /api/ofertas/:id | Borra una oferta y sus líneas. |
reforma_award_quote | POST /api/ofertas/:id/adjudicar | Adjudica una oferta, o deshace la adjudicación. |
reforma_import_quote_lines | POST /api/ofertas/:id/lineas | Importa el CSV de precios de una oferta. |
reforma_quote_template_csv | GET /api/plantilla-oferta.csv | Descarga la plantilla CSV para una constructora. |
reforma_get_comparison | GET /api/comparador | Compara partidas en filas y constructoras en columnas. |
reforma_get_budget | GET /api/presupuesto | Lee lo decidido, la horquilla pendiente, los pagos y el objetivo. |
reforma_get_project_estimate | GET /api/proyecto/presupuesto-estimado | Presupuesto estimado del proyecto por embudo (elegida, más barata apuntada o rango de referencia) con IVA e ICIO. Solo lee. |
reforma_get_project_shopping_list | GET /api/proyecto/lista-compra | Lista de compra del proyecto con precios ordenados y proveedores en la provincia. Solo lee. |
reforma_set_setting | PUT /api/ajustes/:clave | Guarda un ajuste del proyecto, como el presupuesto objetivo. |
reforma_create_payment | POST /api/pagos | Apunta un pago o un compromiso. |
reforma_update_payment | PATCH /api/pagos/:id | Edita un pago. |
reforma_delete_payment | DELETE /api/pagos/:id | Borra un pago. |
reforma_list_captures | GET /api/capturas | Lista lo capturado en tiendas, de más nuevo a más viejo. |
reforma_export_csv | GET /api/export.csv | Exporta partidas y opciones en CSV. |
reforma_export_altas_arquitecto | GET /api/altas-arquitecto.csv | Exporta las partidas de obra dadas de alta a mano. |
reforma_validate_project_plan | POST /api/proyecto/validar-plano | Valida el plano del propio proyecto (montado desde casa.yaml o las estancias de la app, con las obras deducidas del árbol) contra la normativa del municipio y explica el trámite. Orientativo, no sustituye al técnico. |
reforma_export_bc3 | GET /api/proyecto/presupuesto.bc3 | Exporta el presupuesto en FIEBDC-3 (.bc3) para Presto, Arquímedes, CYPE o TCQ: un capítulo por estancia, partidas con medición y descomposición en material y mano de obra. Sin estancias, el del proyecto; con estancias o tipo y m2, uno público. Devuelve el fichero en base64. |
reforma_import_bc3 | POST /api/proyecto/importar-bc3 | Importa un presupuesto FIEBDC-3 (.bc3) al proyecto: partidas de obra con capítulo, código, unidad, medición y texto, y el precio como opción sin elegir. No borra nada ni duplica si se repite. dry_run true solo informa. |
reforma_import_floor_plan | POST /api/proyecto/importar-plano | Importa estancias y m² al proyecto desde un plano: Magicplan (JSON de la API o CSV), IFC (IfcSpace), DXF o el documento de Planner 5D. Crea las que faltan; con actualizar=true corrige m² y tipo. Nunca borra. dry_run true solo informa. |
reforma_import_remote_plan | POST /api/proyecto/importar-plano/remoto | Trae el plano de Magicplan (plan_id, customer_id, api_key) o Planner 5D (project_hash, token) con la clave del usuario y lo importa como estancias. La clave no se guarda. Solo si el servidor tiene el conector habilitado. |
WebMCP
Las páginas públicas de la calculadora, el validador y esta guía registran sus herramientas con navigator.modelContext.registerTool (borrador WebMCP del W3C Web Machine Learning Community Group) cuando el navegador lo soporta. Un agente que navega la página puede llamarlas sin cuenta; llaman a las mismas rutas HTTP que el MCP. Script: /webmcp.js.
| Herramienta | Ruta | Descripción |
|---|---|---|
reforma_search_catalog | GET /api/catalogo | Busca referencias del catálogo de tarifas oficiales de fabricantes (PVP o tarifa, en euros y sin IVA). Filtra por marca, familia, referencia, texto y rango de precio. Devuelve el enlace al PDF original; no republica los PDF ni incluye teléfonos o correos. |
reforma_estimate_budget | POST /api/presupuesto/calcular | Presupuesto de reforma por embudo: estancias (tipo y m²) → rango; elecciones de marca o referencia por concepto (si no, la más barata que cumple); precio de proveedor. Material con tarifa oficial, mano de obra con fuente, IVA e ICIO del municipio. |
reforma_shopping_list | POST /api/lista-compra/calcular | Lista de compra: productos agrupados, cantidades, precio de tarifa con tipo y vigencia, enlace oficial y distribuidores o tiendas de la provincia (sin teléfonos ni correos). |
reforma_budget_options | GET /api/presupuesto/opciones | Opciones del catálogo para un concepto del presupuesto, de la más barata a la más cara, con la más barata de cada marca. |
reforma_validate_plan | POST /api/validar-plano | Valida un plano de reforma contra la normativa del municipio (CTE, habitabilidad autonómica, ordenanza local) y explica el trámite: régimen, documentos, ICIO, tasa, sede y pasos. Cada resultado cita su norma. Orientativo, no sustituye al técnico. |
reforma_search_municipalities | GET /api/municipios | Busca municipios por nombre y devuelve su código INE, provincia, comunidad y ficha de permisos. |
reforma_get_municipality | GET /api/municipios/:ine | Normativa de reforma de un municipio por código INE: ICIO, tasa, sede electrónica, ley urbanística y de habitabilidad de su comunidad, zona climática del CTE y reglas autonómicas y municipales que aplica el validador. Sin teléfonos ni correos. |
Descubrimiento
- /.well-known/api-catalog: catálogo de APIs en formato linkset (RFC 9727).
- /openapi.json: descripción OpenAPI 3.1.
- /llms.txt: resumen para modelos de lenguaje.
- /.well-known/oauth-authorization-server y /.well-known/oauth-protected-resource: OAuth.