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étodoRutaQué hace
GET/api/catalogoBuscar referencias del catálogo
GET/api/directorioDistribuidores e instaladores por categoría, marca y zona
GET/api/presupuesto/calcularPresupuesto de una estancia (atajo GET)
POST/api/presupuesto/calcularPresupuesto por embudo de decisiones
POST/api/lista-compra/calcularLista de compra y dónde comprar cada producto
GET/api/lista-compra/calcularLista de compra de una estancia (atajo GET)
GET/api/presupuesto/opcionesOpciones de nivel 2 para un concepto, de la más barata a la más cara
GET/api/municipiosBuscar municipios por nombre
GET/api/municipios/{ine}Normativa de reforma de un municipio
GET/api/validar-planoFormatos, ejemplos y versión de reglas del validador
POST/api/validar-planoValidar un plano contra CTE, habitabilidad y ordenanza; trámite y documentos
GET/api/validar-plano/esquemaJSON 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étodoRutaQué hace
GET/api/proyecto/presupuesto-estimadoPresupuesto estimado del proyecto (JSON, CSV o BC3)
POST/api/proyecto/importar-bc3Importar partidas y precios de un .bc3 al proyecto
POST/api/proyecto/importar-planoImportar estancias y m² desde Magicplan, IFC, DXF o Planner 5D
POST/api/proyecto/importar-plano/remotoTraer 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 RateLimit y RateLimit-Policy (borrador IETF httpapi-ratelimit-headers); al pasarse, 429 con Retry-After.
CORS
Las rutas públicas admiten GET desde cualquier origen, y POST en 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.bc3 o /api/proyecto/presupuesto-estimado?formato=bc3.
  • Importar un .bc3 de Presto, Arquímedes, CYPE, TCQ, BEDEC o la BCCA: POST /api/proyecto/importar-bc3 con el fichero en application/octet-stream o {"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=true solo 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 IfcSpace con 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)
HerramientaRutaDescripción
reforma_search_catalogGET /api/catalogoBusca 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_budgetPOST /api/presupuesto/calcularPresupuesto 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_listPOST /api/lista-compra/calcularLista 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_optionsGET /api/presupuesto/opcionesOpciones 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_planPOST /api/validar-planoValida 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_municipalitiesGET /api/municipiosBusca municipios por nombre y devuelve su código INE, provincia, comunidad y ficha de permisos.
reforma_get_municipalityGET /api/municipios/:ineNormativa 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)
HerramientaRutaDescripción
reforma_list_roomsGET /api/estanciasLista las estancias del proyecto.
reforma_create_roomPOST /api/estanciasCrea una estancia que el plano no tiene.
reforma_update_roomPATCH /api/estancias/:idEdita nombre, tipo, superficie o notas de una estancia.
reforma_delete_roomDELETE /api/estancias/:idBorra una estancia manual.
reforma_list_plansGET /api/planosLista plantas, renders y documentos del proyecto.
reforma_get_bomGET /api/bomLee partidas, opciones, la elegida y el resumen.
reforma_create_itemPOST /api/partidasCrea una partida o una decisión.
reforma_update_itemPATCH /api/partidas/:idEdita medición, ámbito, alcance o resolución de una partida.
reforma_delete_itemDELETE /api/partidas/:idBorra una partida, sus opciones y sus fotos.
reforma_split_itemPOST /api/partidas/:id/desdoblarSepara una decisión de varias estancias en una por estancia.
reforma_choose_optionPOST /api/partidas/:id/elegirElige una opción de la partida, o quita la elección.
reforma_add_optionPOST /api/partidas/:id/opcionesAñade una opción de tienda a una partida.
reforma_update_optionPATCH /api/opciones/:idEdita precio, marca, referencia o url de una opción.
reforma_delete_optionDELETE /api/opciones/:idBorra una opción y sus fotos.
reforma_list_storesGET /api/tiendasLista el directorio de tiendas y gremios.
reforma_create_storePOST /api/tiendasCrea una ficha de tienda o gremio.
reforma_update_storePATCH /api/tiendas/:idEdita una ficha de tienda.
reforma_delete_storeDELETE /api/tiendas/:idBorra una ficha de tienda.
reforma_import_storesPOST /api/importar-tiendasSiembra el directorio de tiendas sin pisar fichas editadas.
reforma_list_visitsGET /api/visitasLee la visita abierta y el historial.
reforma_start_visitPOST /api/visitasEmpieza una visita a una tienda.
reforma_close_visitPOST /api/visitas/:id/cerrarCierra la visita y marca la tienda como visitada.
reforma_list_documentsGET /api/documentosLista los documentos del proyecto.
reforma_update_documentPATCH /api/documentos/:idEdita nombre, clase, importe o notas de un documento.
reforma_delete_documentDELETE /api/documentos/:idBorra un documento y su fichero.
reforma_upload_documentPOST /api/documentosSube un PDF o una imagen de la obra.
reforma_upload_store_documentPOST /api/tiendas/:id/documentosSube una factura o un presupuesto de un proveedor.
reforma_upload_option_photoPOST /api/opciones/:id/fotosSube una foto de una opción.
reforma_upload_room_photoPOST /api/estancias/:id/fotosSube una foto o un render de una estancia.
reforma_update_photoPATCH /api/fotos/:idCambia el pie de una foto.
reforma_delete_room_rendersDELETE /api/estancias/:id/rendersBorra los renders de una estancia.
reforma_delete_photoDELETE /api/fotos/:idBorra una foto.
reforma_import_workPOST /api/importar-obraImporta las partidas de obra de los amidaments.
reforma_import_catalogPOST /api/importar-catalogoImporta el catálogo de decisiones de compra.
reforma_migrate_to_treePOST /api/migrar-arbolCopia partidas y opciones al árbol nuevo. dry_run true (el defecto) solo informa. Nunca modifica el legado.
reforma_apply_pack_templatePOST /api/aplicar-plantillaParte un pack en piezas según su plantilla. dry_run true por defecto. No toca la opción elegida ni el legado.
reforma_search_directoryGET /api/directorioBusca distribuidores e instaladores por categoría, marca y zona. Ordena municipio, provincia y comunidad. Sin teléfonos ni correos.
reforma_get_checklistGET /api/checklistLee fases, tareas y el resumen del checklist.
reforma_import_checklistPOST /api/importar-checklistImporta el checklist sin pisar tareas editadas.
reforma_export_checklist_csvGET /api/checklist.csvExporta el checklist en CSV.
reforma_create_taskPOST /api/tareasCrea una tarea del checklist.
reforma_update_taskPATCH /api/tareas/:idEdita una tarea, la marca hecha o le vincula decisiones.
reforma_delete_taskDELETE /api/tareas/:idBorra una tarea.
reforma_list_quotesGET /api/ofertasLista las ofertas de las constructoras.
reforma_create_quotePOST /api/ofertasCrea una oferta de constructora.
reforma_update_quotePATCH /api/ofertas/:idEdita una oferta.
reforma_delete_quoteDELETE /api/ofertas/:idBorra una oferta y sus líneas.
reforma_award_quotePOST /api/ofertas/:id/adjudicarAdjudica una oferta, o deshace la adjudicación.
reforma_import_quote_linesPOST /api/ofertas/:id/lineasImporta el CSV de precios de una oferta.
reforma_quote_template_csvGET /api/plantilla-oferta.csvDescarga la plantilla CSV para una constructora.
reforma_get_comparisonGET /api/comparadorCompara partidas en filas y constructoras en columnas.
reforma_get_budgetGET /api/presupuestoLee lo decidido, la horquilla pendiente, los pagos y el objetivo.
reforma_get_project_estimateGET /api/proyecto/presupuesto-estimadoPresupuesto estimado del proyecto por embudo (elegida, más barata apuntada o rango de referencia) con IVA e ICIO. Solo lee.
reforma_get_project_shopping_listGET /api/proyecto/lista-compraLista de compra del proyecto con precios ordenados y proveedores en la provincia. Solo lee.
reforma_set_settingPUT /api/ajustes/:claveGuarda un ajuste del proyecto, como el presupuesto objetivo.
reforma_create_paymentPOST /api/pagosApunta un pago o un compromiso.
reforma_update_paymentPATCH /api/pagos/:idEdita un pago.
reforma_delete_paymentDELETE /api/pagos/:idBorra un pago.
reforma_list_capturesGET /api/capturasLista lo capturado en tiendas, de más nuevo a más viejo.
reforma_export_csvGET /api/export.csvExporta partidas y opciones en CSV.
reforma_export_altas_arquitectoGET /api/altas-arquitecto.csvExporta las partidas de obra dadas de alta a mano.
reforma_validate_project_planPOST /api/proyecto/validar-planoValida 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_bc3GET /api/proyecto/presupuesto.bc3Exporta 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_bc3POST /api/proyecto/importar-bc3Importa 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_planPOST /api/proyecto/importar-planoImporta 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_planPOST /api/proyecto/importar-plano/remotoTrae 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.

HerramientaRutaDescripción
reforma_search_catalogGET /api/catalogoBusca 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_budgetPOST /api/presupuesto/calcularPresupuesto 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_listPOST /api/lista-compra/calcularLista 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_optionsGET /api/presupuesto/opcionesOpciones 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_planPOST /api/validar-planoValida 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_municipalitiesGET /api/municipiosBusca municipios por nombre y devuelve su código INE, provincia, comunidad y ficha de permisos.
reforma_get_municipalityGET /api/municipios/:ineNormativa 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