@nubiia/mcp-freematica
Advanced tools
MCP server for the Freemática ERP REST API: invoicing, accounts receivable, suppliers, accounting and HR data for AI assistants like Claude. Built by Nubiia.
MCP server que expone operaciones del API REST de Freemática (ERP: facturación, cartera, proveedores, contabilidad, personal) para ser consumidas por asistentes de IA como Claude.
Built and maintained by Nubiia — automatización e integraciones con IA para negocios (MCP, Holded, Pipedrive y más). ¿Quieres algo así para tu empresa? Escríbenos en nubiia.es.
@modelcontextprotocol/sdk (stdio + Streamable HTTP transports)| Tool | Endpoint Freemática | Descripción |
|---|---|---|
freematica_list_articulos | GET /part/v1/articulos | Catálogo de artículos/materiales/consumibles (referencias, familias, proveedores) |
freematica_get_articulo | GET /part/v1/articulos/{idreg} | Detalle de un artículo |
freematica_get_precio_articulo | GET /pgrl/v1/precio-articulo/{idreg} | Precios de venta de un artículo (PRECIO_VENTA, DESCUENTO, FACTURABLE) |
freematica_list_articulos_costes | GET /part/v2/articulos-costes | Lista paginada de costes de artículos |
freematica_get_articulo_coste | GET /part/v2/articulos-costes/{idReg} | Detalle de coste de un artículo |
freematica_list_articulos_serie_lote | GET /part/v2/articulos-serie-lote | Lista paginada de artículos con número de serie/lote |
freematica_get_articulo_serie_lote | GET /part/v2/articulos-serie-lote/{idReg} | Detalle de un artículo con número de serie/lote |
freematica_list_stocks_serie_lote | GET /part/v2/stocks-serie-lote | Lista paginada de existencias de artículos por serie/lote |
freematica_get_stock_serie_lote | GET /part/v2/stocks-serie-lote/{idReg} | Detalle de existencias de un artículo por serie/lote |
freematica_list_stocks | GET /part/v1/stocks | Lista paginada de stocks de artículos por almacén |
freematica_get_stock | GET /part/v1/stocks/{idReg} | Detalle de stock de un artículo por almacén |
freematica_list_familias | GET /part/v1/familias | Lista paginada de familias de artículos (detalle + paginación vs master_data) |
freematica_get_familia | GET /part/v1/familias/{idReg} | Detalle de una familia de artículos por idReg |
freematica_list_lineas | GET /part/v1/lineas | Lista paginada de líneas de artículos |
freematica_get_linea | GET /part/v1/lineas/{idReg} | Detalle de una línea de artículos por idReg |
freematica_list_subfamilias | GET /part/v1/subfamilias | Lista paginada de subfamilias de artículos (detalle + paginación vs master_data) |
freematica_get_subfamilia | GET /part/v1/subfamilias/{idReg} | Detalle de una subfamilia de artículos por idReg |
freematica_list_materiales_asignados_servicios | GET /pvss/v2/contratos-servicios-material | Lista de material asignado a servicios |
freematica_get_master_data | (24 endpoints según catalog) | Devuelve un catálogo de datos maestros (tipos, geográficos, organizativos, inventario, financiero) |
freematica_list_clientes | GET /pgrl/v2/clientes | Lista paginada de clientes |
freematica_get_cliente | GET /pgrl/v2/clientes/{idReg} | Detalle de un cliente |
freematica_list_contactos_clientes | GET /pgrl/v2/contactos-clientes | Lista paginada de contactos |
freematica_list_oportunidades_negocio | GET /pcrm/v2/oportunidades-negocio | Lista paginada de oportunidades |
freematica_get_oportunidad_negocio | GET /pcrm/v2/oportunidades-negocio/{idReg} | Detalle de oportunidad |
freematica_get_oportunidad_negocio_datos_ampliados | GET /pcrm/v2/oportunidades-negocio/{idReg}/datos-ampliados | Datos ampliados (puede 404) |
freematica_get_ficha_prev_cliente | GET /pprl/v2/ficha-prev-cliente | Ficha PRL de un cliente |
freematica_list_vigilancia_salud | GET /pprl/v1/vigilancia-salud | Lista paginada de registros de Vigilancia de la Salud |
freematica_get_vigilancia_salud | GET /pprl/v1/vigilancia-salud/{idreg} | Detalle de un registro de Vigilancia de la Salud |
freematica_list_personal | GET /pers/v1/personal | Lista paginada de personas (RRHH) |
freematica_get_persona | GET /pers/v2/personal/{idreg} | Detalle de una persona |
freematica_list_calendarios | GET /pgrl/v1/calendarios | Lista paginada de calendarios laborales |
freematica_list_calendario_periodos | GET /pgrl/v1/calendarios/{idreg}/periodos | Periodos de un calendario laboral |
freematica_list_cartera_clientes | GET /pcar/v1/cartera-clientes | Lista paginada de cartera de clientes (cobros, impagados) |
freematica_get_cartera_cliente | GET /pcar/v1/cartera-clientes/{idReg} | Detalle de un documento de cartera |
freematica_list_facturas_cabecera | GET /pven/v1/facturas-cabecera | Lista paginada de facturas de ventas (cabecera) |
freematica_get_factura_cabecera | GET /pven/v1/facturas-cabecera/{idReg} | Detalle de una factura de venta |
freematica_list_factura_lineas | GET /pven/v1/facturas-cabecera/{idReg}/lineas | Líneas de detalle de una factura de venta |
freematica_list_factura_iva | GET /pven/v1/facturas-cabecera/{idReg}/iva | Líneas de IVA de una factura de venta |
freematica_list_factura_vencimientos | GET /pven/v1/facturas-cabecera/{idReg}/vencimientos | Vencimientos de cobro de una factura de venta |
freematica_list_facturas_compras | GET /pcom/v1/facturas-cabecera | Lista paginada de facturas de compras |
freematica_get_factura_compra | GET /pcom/v1/facturas-cabecera/{idReg} | Detalle de una factura de compra |
freematica_list_proveedores | GET /pgrl/v2/proveedores | Lista paginada de proveedores |
freematica_get_proveedor | GET /pgrl/v2/proveedores/{idReg} | Detalle de un proveedor |
freematica_list_localizaciones_cobro_clientes | GET /pgrl/v2/localizaciones-cobro-clientes | Localizaciones de cobro de clientes (SEPA, domiciliaciones) |
freematica_list_localizaciones_pago_proveedores | GET /pgrl/v2/localizaciones-pago-proveedores | Localizaciones de pago de proveedores |
freematica_list_localizaciones_servicio_clientes | GET /pgrl/v2/localizaciones-servicio-clientes | Localizaciones de servicio de clientes |
freematica_list_cuentas_contables | GET /pcon/v2/cuentas | Plan de cuentas contables (COD_CTA, COD_PLAN, etc.) |
freematica_list_cuentas_analiticas | GET /pcon/v2/cuentas-analiticas | Catálogo de cuentas analíticas |
freematica_export_asientos | GET /pcon/v2/asientos | Exporta asientos contables de un período (CSV/JSON) |
freematica_list_pedidos_compra | GET /pcmp/v2/pedidos | Lista paginada de pedidos de compra (filtros nativos + FIQL + estado enum) |
freematica_get_pedido_compra | GET /pcmp/v2/pedidos/{idReg} | Detalle de un pedido de compra (cabecera + proveedor + líneas) |
freematica_list_albaranes_ventas | GET /pven/v2/albaranes-ventas | Lista paginada de albaranes de ventas (filtros todos nativos, empresa requerido) |
freematica_get_albaran_venta | GET /pven/v2/albaranes-ventas/{idReg} | Detalle de un albarán de venta |
freematica_list_albaranes_factura | GET /pven/v2/albaranes-facturas | Lista paginada de vinculaciones albarán↔factura (idReg nativo + FIQL) |
freematica_get_albaran_factura | GET /pven/v2/albaranes-facturas/{idReg} | Detalle de una vinculación albarán-factura |
freematica_list_resultados_facturacion | GET /pvss/v1/facturacion-resultados | Resultados del proceso batch de facturación automática de vigilancia (FIQL) |
freematica_list_contratos | GET /pvss/v1/contratos | Lista paginada de cabeceras de contratos (solo filtros nativos: el API ignora FIQL aquí) |
freematica_get_contrato | GET /pvss/v1/contratos (scan) | Busca un contrato por empresa + código natural (paginación interna + filtrado en cliente) |
freematica_list_servicios_contrato | GET /pvss/v1/contratos/{idReg}/servicios | Servicios de un contrato |
freematica_get_servicio_contrato | GET /pvss/v2/contratos-servicios/{idReg} | Detalle de un servicio de contrato |
freematica_list_contratos_opcionales | GET /ppre/v2/contratos/opcionales | Lista paginada de opcionales de contratos |
freematica_get_contrato_opcionales | GET /ppre/v2/contratos/opcionales/{idReg} | Detalle de un registro de opcionales |
freematica_list_localizaciones_envio_clientes | GET /pgrl/v2/localizaciones-envio-clientes | Localizaciones de envío de clientes |
freematica_list_localizaciones_factura_clientes | GET /pgrl/v2/localizaciones-factura-clientes | Localizaciones de factura de clientes |
freematica_list_vinculos_personas_servicios | GET /pvss/v2/vinculos-personas-servicios | Lista paginada de vínculos persona↔servicio (mapping centro → trabajador, clave para CAE) |
freematica_get_vinculo_persona_servicio | GET /pvss/v2/vinculos-personas-servicios/{idreg} | Detalle de un vínculo persona-servicio |
freematica_list_habilitaciones_servicios_alta | GET /peqv/v2/habilitaciones/servicios/alta | Feed incremental: altas de servicios-personal en habilitaciones CAE |
freematica_list_habilitaciones_servicios_baja | GET /peqv/v2/habilitaciones/servicios/baja | Feed incremental: bajas de servicios-personal en habilitaciones CAE |
freematica_list_habilitaciones_personal_alta | GET /peqv/v2/habilitaciones/personal/alta | Feed incremental: altas de licencias del personal en habilitaciones CAE |
freematica_list_habilitaciones_personal_baja | GET /peqv/v2/habilitaciones/personal/baja | Feed incremental: bajas de licencias del personal en habilitaciones CAE |
freematica_list_cuadrantes | GET /pvss/v1/cuadrantes | Lista paginada de cuadrantes |
freematica_list_cuadrantes_detalles | GET /pvss/v1/cuadrantes-detalles | Detalles de cuadrantes |
freematica_list_cuadrantes_observaciones | GET /pvss/v1/cuadrantes-observaciones | Observaciones de cuadrantes |
freematica_list_cuadrantes_auditoria | GET /pvss/v1/cuadrantes-auditoria | Feed de auditoría de cuadrantes (nuevos/modificados/eliminados); soporta param desde |
freematica_list_cuadrantes_tareas | GET /pvss/v2/cuadrantes-tareas | Tareas de cuadrantes |
freematica_list_computos_pers | GET /pvss/v2/computos-pers | Lista paginada de cómputos de personas (persona↔contrato↔servicio) |
freematica_get_computos_pers | GET /pvss/v2/computos-pers/{idReg} | Detalle de un cómputo de persona (campos CONFCP_*) |
freematica_get_computos_pers_h | GET /pvss/v2/computos-pers-h/{idReg} | Detalle de cómputo de persona con histórico (campos CONFCPH_*) |
freematica_list_cuadrantes_cierre_personas | GET /pvss/v1/cuadrantes-cierre-personas | Lista de cierres de cuadrante por persona |
freematica_get_cuadrante_cierre_persona | GET /pvss/v1/cuadrantes-cierre-personas/{idreg} | Detalle de cierre de cuadrante por persona |
freematica_list_cuadrantes_cierre_personas_complementos | GET /pvss/v1/cuadrantes-cierre-personas-complementos | Lista de complementos de cierre de cuadrante |
freematica_get_cuadrante_cierre_persona_complemento | GET /pvss/v1/cuadrantes-cierre-personas-complementos/{idreg} | Detalle de complemento de cierre |
freematica_list_cuadrantes_cierre_personas_especiales | GET /pvss/v1/cuadrantes-cierre-personas-especiales | Lista de especiales de cierre de cuadrante |
freematica_get_cuadrante_cierre_persona_especial | GET /pvss/v1/cuadrantes-cierre-personas-especiales/{idreg} | Detalle de especial de cierre |
freematica_list_cuadrantes_cierre_personas_incidencias | GET /pvss/v1/cuadrantes-cierre-personas-incidencias | Lista de incidencias de cierre de cuadrante |
freematica_get_cuadrante_cierre_persona_incidencia | GET /pvss/v1/cuadrantes-cierre-personas-incidencias/{idreg} | Detalle de incidencia de cierre |
freematica_list_contratos_servicios_global | GET /pvss/v1/contratos-servicios | Lista global de servicios de todos los contratos (sin filtro por contrato) |
freematica_list_contratos_turnos | GET /pvss/v1/contratos-turnos | Turnos de contratos |
freematica_list_contratos_horarios_operativa | GET /pvss/v1/contratos-horarios-operativa | Horarios de operativa de contratos |
freematica_list_clases_servicios | GET /pvss/v1/clases-servicios | Catálogo de clases de servicio |
freematica_list_inspectores | GET /pvss/v1/inspectores | Lista de inspectores |
freematica_get_inspector_empresa | GET /pvss/v1/inspector-empresa | Inspector de empresa |
freematica_list_claves_facturacion | GET /pvss/v2/claves-facturacion | Claves de facturación |
freematica_list_incidencias_servicios | GET /pvss/v2/incidencias-servicios | Lista paginada de incidencias en servicios |
freematica_get_incidencia_servicio | GET /pvss/v2/incidencias-servicios/{idReg} | Detalle de una incidencia en servicio |
freematica_list_incidencecode | GET /pvss/v2/incidencecode | Catálogo de códigos de incidencia (v2) |
freematica_get_contratos_servicios_material | GET /pvss/v2/contratos-servicios-material/{idreg} | Detalle de material asignado a un servicio de contrato por idReg |
freematica_list_personal_v2 | GET /pers/v2/personal | Sincronización incremental de personas (param fchmodificacion opcional) |
freematica_list_personal_identificacion | GET /pers/v2/personal-identificacion | Datos de identificación del personal |
freematica_list_personal_notas | GET /pers/v2/personal-notas | Notas del personal (filtrables por idReg de persona) |
freematica_get_personal_nota | GET /pers/v2/personal-notas/{idReg} | Detalle de una nota de personal |
freematica_list_personal_experiencias | GET /pers/v1/personal-experiencias | Historial de experiencia laboral del personal |
freematica_get_personal_experiencia | GET /pers/v1/personal-experiencias/{idreg} | Detalle de una experiencia laboral |
freematica_list_personal_formaciones | GET /pers/v1/personal-formaciones | Historial de formaciones del personal |
freematica_get_personal_formacion | GET /pers/v1/personal-formaciones/{idReg} | Detalle de una formación del personal |
freematica_list_personal_contratos | GET /pers/v1/personal_contratos | Contratos laborales del personal |
freematica_get_personal_contrato | GET /pers/v1/personal_contratos/{idreg} | Detalle de un contrato laboral |
freematica_list_personal_tramos | GET /pers/v1/personal_tramos | Tramos de horario del personal (v1) |
freematica_get_personal_tramo | GET /pers/v1/personal_tramos/{idreg} | Detalle de un tramo de horario (v1) |
freematica_list_personal_tramos_sync | GET /pers/v2/personal/tramos | Sincronización incremental de tramos de horario (param fchmodificacion opcional) |
freematica_get_personal_tramo_v2 | GET /pers/v2/personal/tramos/{idreg} | Detalle de un tramo de horario (v2) |
freematica_list_personal_pago | GET /pers/v1/personal_pago | Datos bancarios y de pago del personal |
freematica_get_personal_pago | GET /pers/v1/personal_pago/{idreg} | Detalle de datos bancarios de una persona |
freematica_list_personal_adicionales | GET /pers/v2/personal-adicionales | Campos adicionales personalizables del personal |
freematica_list_personal_prorroga | GET /pers/v1/personal-prorroga | Prórrogas de contratos del personal |
freematica_get_personal_prorroga | GET /pers/v1/personal-prorroga/{idreg} | Detalle de una prórroga de contrato |
freematica_list_incidencias_personal | GET /pers/v2/incidencias | Incidencias del personal |
freematica_get_agenda_persona | GET /pers/v1/agenda-persona | Agenda de citas y eventos de personas |
freematica_list_equipamiento_ficha_seguridad | GET /pers/v2/equipamiento-ficha-seguridad | Equipamiento de fichas de seguridad del personal |
freematica_list_anticipos_personal | GET /pers/v2/personal/anticipos | Anticipos de nómina del personal |
freematica_get_anticipo_personal | GET /pers/v2/personal/anticipos/{idReg} | Detalle de un anticipo de nómina |
freematica_list_calendario_personal | GET /pers/v2/personal-cal | Entradas del calendario personal (vacaciones, permisos, ausencias) |
freematica_get_calendario_personal | GET /pers/v2/personal-cal/{idReg} | Detalle de una entrada del calendario personal |
freematica_list_cpd | GET /pers/v1/cpd | Documentos del empleado (CPD: nóminas, comunicaciones, etc.) |
freematica_get_cpd | GET /pers/v1/cpd/{idreg} | Detalle de un CPD |
freematica_list_cpd_movimientos | GET /pers/v1/cpd/{idreg}/movimientos | Movimientos/historial de estados de un CPD |
freematica_list_cpd_firmados_vid | GET /pers/v1/cpd/firmados-vid | CPDs firmados vía viafirma (VID) |
freematica_list_personal_irpf | GET /pers/v2/personal_irpf | Datos de IRPF del personal |
freematica_get_personal_irpf | GET /pers/v2/personal_irpf/{idreg} | Detalle de datos IRPF de una persona |
freematica_list_sesiones_formacion | GET /pers/v1/sesiones-formacion | Sesiones de formación del personal |
freematica_get_sesion_formacion | GET /pers/v1/sesiones-formacion/{idreg} | Detalle de una sesión de formación |
freematica_list_vss_incidencias | GET /pers/v2/vss-incidencias | Incidencias de personal (módulo VSS) |
freematica_get_vss_incidencia | GET /pers/v2/vss-incidencias/{idReg} | Detalle de una incidencia VSS del personal |
freematica_list_ppre_contratos | GET /ppre/v1/contratos | Lista paginada de contratos de instalación/mantenimiento (v1) |
freematica_list_ppre_contratos_v2 | GET /ppre/v2/contratos | Lista de contratos de instalación/mantenimiento vigentes (v2) |
freematica_get_ppre_contrato_v1 | GET /ppre/v1/contratos/{idreg} | Detalle de un contrato (v1) |
freematica_get_ppre_contrato_v2 | GET /ppre/v2/contratos/{idReg} | Detalle de un contrato (v2) |
freematica_list_ppre_contratos_instalacion | GET /ppre/v1/contratosInstalacion | Contratos agrupados por instalación |
freematica_list_ppre_tipos_contrato | GET /ppre/v2/tipos-contrato | Catálogo de tipos de contrato (ppre) |
freematica_list_ppre_ordenes_trabajo | GET /ppre/v1/ordenes-trabajo | Lista paginada de órdenes de trabajo |
freematica_get_ppre_orden_trabajo | GET /ppre/v1/ordenes-trabajo/{idreg} | Detalle de una orden de trabajo |
freematica_list_ppre_partes | GET /ppre/v1/partes | Lista paginada de partes |
freematica_get_ppre_parte | GET /ppre/v1/partes/{idreg} | Detalle de un parte |
freematica_get_ppre_parte_componentes_ficha_tecnica | GET /ppre/v1/partes/{idreg}/componentes-ficha-tecnica | Componentes de la ficha técnica asociada a un parte |
freematica_list_ppre_parte_ultimas_intervenciones | GET /ppre/v1/partes/{idreg}/ultimas-intervenciones | Últimas intervenciones de un parte |
freematica_list_ppre_partes_orden_trabajo | GET /ppre/v2/partes/partes-orden-trabajo | Partes cumplimentados asociados a órdenes de trabajo |
freematica_list_ppre_partes_fin_mantenedor | GET /ppre/v2/partes/partes-fin-mantenedor | Partes finalizados por el mantenedor |
freematica_list_ppre_cabecera_actas_partes | GET /ppre/v2/partes/cabecera-actas-partes | Cabecera de actas de partes |
freematica_list_ppre_lineas_actas_partes | GET /ppre/v2/partes/lineas-actas-partes | Líneas de actas de partes |
freematica_list_ppre_fichas_instalacion | GET /ppre/v1/fichas-instalacion/{idReg} | Fichas de instalación (idReg en path, opcional para listar todas) |
freematica_get_ppre_ficha_tecnica | GET /ppre/v1/ficha-tecnica/{idReg} | Ficha técnica de una instalación |
freematica_list_ppre_componentes_ficha_tecnica | GET /ppre/v1/fichas-tecnicas/{idreg}/componentes | Componentes de una ficha técnica |
freematica_list_ppre_marcajes | GET /ppre/v1/marcajes | Marcajes IKAROS (v1) |
freematica_list_ppre_marcajes_v2 | GET /ppre/v2/marcajes | Marcajes IKAROS (v2) |
freematica_list_ppre_incidencias_anomalias | GET /ppre/v1/incidencias-anomalias | Catálogo de incidencias y anomalías (ppre) |
freematica_list_ppre_tipo_instalacion | GET /ppre/v1/tipo-instalacion | Catálogo de tipos de instalación |
freematica_list_pemf_marcajes | GET /pemf/v2/marcajes | Marcajes e-Movifree (v2, paginado) |
freematica_get_pemf_marcaje | GET /pemf/v2/marcajes/{idReg} | Detalle de un marcaje e-Movifree |
freematica_list_pemf_tracking | GET /pemf/v1/tracking | Tracking de posiciones GPS de operarios (v1) |
freematica_list_pemf_calls | GET /pemf/v1/calls | Registro de llamadas de servicio (v1) |
freematica_list_pemf_geoposition | GET /pemf/v1/geoposition | Última geolocalización de operarios (v1) |
freematica_list_pemf_geoposition_v2 | GET /pemf/v2/geoposition | Última geolocalización de operarios (v2) |
freematica_list_pemf_cna | GET /pemf/v2/cna | CNA — estado de operarios de campo (v2) |
freematica_list_pemf_devices | GET /pemf/v1/devices | Lista de dispositivos e-Movifree (paginado) |
freematica_get_pemf_device | GET /pemf/v1/devices/{idDevice} | Detalle de un dispositivo e-Movifree |
freematica_list_pemf_rondas | GET /pemf/v1/rounds | Rondas de vigilancia (v1, paginado) |
freematica_list_pemf_rondas_v2 | GET /pemf/v2/rounds | Rondas de vigilancia (v2, paginado) |
freematica_list_pemf_ronda_points | GET /pemf/v1/rounds/{idRonda}/points | Puntos de una ronda (v1) |
freematica_list_pemf_ronda_points_v2 | GET /pemf/v2/rounds/{idRonda}/points | Puntos de una ronda (v2) |
freematica_list_pemf_services | GET /pemf/v1/services | Servicios de campo activos (paginado) |
freematica_get_pemf_service | GET /pemf/v1/services/{idService} | Detalle de un servicio de campo |
freematica_list_pemf_service_alarms | GET /pemf/v1/services/{idService}/alarms | Alarmas de un servicio de campo |
freematica_list_pemf_service_issues | GET /pemf/v1/services/{idService}/issues | Incidencias de un servicio de campo |
freematica_list_pemf_service_rounds | GET /pemf/v1/services/{idService}/rounds | Rondas de un servicio de campo |
freematica_list_pemf_service_jobs | GET /pemf/v1/services/{idService}/jobs | Trabajos (jobs) de un servicio de campo |
freematica_list_pemf_identificadores_servicio | GET /pemf/v2/identificadores-servicio | Identificadores (QR/NFC/BLE) de servicio (paginado) |
freematica_list_pemf_rutas | GET /pemf/v2/routes | Rutas de operarios asignadas (paginado) |
freematica_list_pemf_materiales_consumibles | GET /pemf/v2/services/{idReg}/materiales-consumibles | Materiales consumibles de un servicio |
freematica_list_pemf_materiales_imputados | GET /pemf/v2/services/{idReg}/materiales-imputados | Materiales imputados a un servicio |
freematica_get_pemf_config_global | GET /pemf/v1/config | Configuración global de e-Movifree |
freematica_get_pemf_config | GET /pemf/v{1,2}/config/{idConfig} | Configuración de un módulo (v1/v2 seleccionable) |
freematica_list_pemf_usuarios_notificaciones | GET /pemf/v1/usuarios-notificaciones | Usuarios configurados para notificaciones e-Movifree |
freematica_get_pemf_operario | GET /pemf/v1/users | Datos del operario autenticado |
freematica_list_pemf_descubiertos | GET /pemf/v1/descubiertos | Servicios descubiertos (sin operario asignado) del día |
freematica_list_pcrm_actividades | GET /pcrm/v2/actividades | Lista paginada de actividades CRM (citas y tareas) |
freematica_get_pcrm_actividad | GET /pcrm/v2/actividades/{idReg} | Detalle de una actividad CRM |
freematica_list_pcrm_casos | GET /pcrm/v2/casos | Lista paginada de casos CRM (tickets de soporte/incidencias) |
freematica_get_pcrm_caso | GET /pcrm/v2/casos/{idReg} | Detalle de un caso CRM |
freematica_list_pcrm_tipos_casos | GET /pcrm/v2/tipos-casos | Catálogo de tipos de caso CRM |
freematica_get_pcrm_tipo_caso | GET /pcrm/v2/tipos-casos/{idReg} | Detalle de un tipo de caso |
freematica_list_pcrm_subtipos_casos | GET /pcrm/v2/subtipos-casos | Catálogo de subtipos de caso CRM |
freematica_get_pcrm_subtipo_caso | GET /pcrm/v2/subtipos-casos/{idReg} | Detalle de un subtipo de caso |
freematica_list_pcrm_documentos_usuario_v1 | GET /pcrm/v1/usuarios/{idUsuario}/documentos | Lista paginada de documentos de portal de un usuario (v1) |
freematica_get_pcrm_documento_usuario_v1 | GET /pcrm/v1/usuarios/{idUsuario}/documentos/{idDocumento} | Detalle de un documento de portal (v1) |
freematica_list_pcrm_documentos_usuario_v2 | GET /pcrm/v2/usuarios/{idUsuario}/documentos | Lista paginada de documentos de portal de un usuario (v2) |
freematica_get_pcrm_documento_usuario_v2 | GET /pcrm/v2/usuarios/{idUsuario}/documentos/{idDocumento} | Detalle de un documento de portal (v2) |
freematica_list_pcrm_notas | GET /pcrm/v2/notas | Lista paginada de notas CRM |
freematica_get_pcrm_nota | GET /pcrm/v2/notas/{idReg} | Detalle de una nota CRM |
freematica_get_oportunidad_negocio_v1 | GET /pcrm/v1/oportunidades-negocio/{idReg} | Detalle de oportunidad de negocio (v1) |
freematica_list_tipos_oportunidad_negocio | GET /pcrm/v2/tipos-oportunidad-negocio | Catálogo de tipos de oportunidad de negocio |
freematica_get_tipo_oportunidad_negocio | GET /pcrm/v2/tipos-oportunidad-negocio/{idReg} | Detalle de un tipo de oportunidad de negocio |
freematica_list_clientes_v1 | GET /pgrl/v1/clientes | Lista paginada de clientes (v1). Preferir v2 para datos más completos. |
freematica_get_cliente_v1 | GET /pgrl/v1/clientes/{idReg} | Detalle de un cliente (v1) |
freematica_list_contactos_clientes_v1 | GET /pgrl/v1/contactos-clientes | Lista paginada de contactos de clientes (v1) |
freematica_get_contacto_cliente | GET /pgrl/v1/contactos-clientes/{idReg} | Detalle de un contacto de cliente |
freematica_list_localizaciones_cobro_clientes_v1 | GET /pgrl/v1/localizaciones-cobro-clientes | Lista paginada de localizaciones de cobro de clientes (v1) |
freematica_get_localizacion_cobro_cliente | GET /pgrl/v1/localizaciones-cobro-clientes/{idReg} | Detalle de localización de cobro de cliente (v1) |
freematica_get_localizacion_cobro_cliente_v2 | GET /pgrl/v2/localizaciones-cobro-clientes/{idReg} | Detalle de localización de cobro de cliente (v2) |
freematica_list_localizaciones_envio_clientes_v1 | GET /pgrl/v1/localizaciones-envio-clientes | Lista paginada de localizaciones de envío de clientes (v1) |
freematica_get_localizacion_envio_cliente | GET /pgrl/v1/localizaciones-envio-clientes/{idReg} | Detalle de localización de envío de cliente (v1) |
freematica_get_localizacion_envio_cliente_v2 | GET /pgrl/v2/localizaciones-envio-clientes/{idReg} | Detalle de localización de envío de cliente (v2) |
freematica_get_localizacion_factura_cliente | GET /pgrl/v1/localizaciones-factura-clientes/{idReg} | Detalle de localización de factura de cliente (v1) |
freematica_list_localizaciones_servicio_clientes_v1 | GET /pgrl/v1/localizaciones-servicio-clientes | Lista paginada de localizaciones de servicio de clientes (v1) |
freematica_get_localizacion_servicio_cliente | GET /pgrl/v1/localizaciones-servicio-clientes/{idReg} | Detalle de localización de servicio de cliente (v1) |
freematica_get_localizacion_servicio_cliente_v2 | GET /pgrl/v2/localizaciones-servicio-clientes/{idReg} | Detalle de localización de servicio de cliente (v2) |
freematica_list_localizaciones_pago_proveedores_v1 | GET /pgrl/v1/localizaciones-pago-proveedores | Lista paginada de localizaciones de pago de proveedores (v1) |
freematica_get_localizacion_pago_proveedor | GET /pgrl/v1/localizaciones-pago-proveedores/{idReg} | Detalle de localización de pago de proveedor (v1) |
freematica_get_localizacion_pago_proveedor_v2 | GET /pgrl/v2/localizaciones-pago-proveedores/{idReg} | Detalle de localización de pago de proveedor (v2) |
freematica_list_proveedores_v1 | GET /pgrl/v1/proveedores | Lista paginada de proveedores (v1) |
freematica_list_cargos_clientes | GET /pgrl/v2/cargos-clientes | Lista paginada de cargos de clientes (roles de contactos) |
freematica_get_cargo_cliente | GET /pgrl/v2/cargos-clientes/{idReg} | Detalle de un cargo de cliente |
freematica_list_calen_festivos | GET /pgrl/v2/calen-festivos | Lista paginada de calendarios festivos |
freematica_get_calen_festivo | GET /pgrl/v2/calen-festivos/{idReg} | Detalle de un calendario festivo |
freematica_list_delegaciones_v1 | GET /pgrl/v1/delegaciones | Lista paginada de delegaciones (v1). También vía freematica_get_master_data. |
freematica_get_delegacion_v1 | GET /pgrl/v1/delegaciones/{idReg} | Detalle de una delegación (v1) |
freematica_list_delegaciones_agrupcod | GET /pgrl/v1/delegaciones/agrupcod | Lista paginada de delegaciones agrupadas por código |
freematica_list_delegaciones_v2 | GET /pgrl/v2/delegaciones | Lista paginada de delegaciones (v2) |
freematica_get_delegacion_v2 | GET /pgrl/v2/delegaciones/{idReg} | Detalle de una delegación (v2) |
freematica_list_empresas | GET /pgrl/v1/empresas | Lista paginada de empresas. También vía freematica_get_master_data. |
freematica_get_empresa | GET /pgrl/v1/empresas/{idReg} | Detalle de una empresa |
freematica_list_paises | GET /pgrl/v1/paises | Lista paginada de países. También vía freematica_get_master_data. |
freematica_list_provincias | GET /pgrl/v1/provincias | Lista paginada de provincias. También vía freematica_get_master_data. |
freematica_list_nacionalidades | GET /pgrl/v1/nacionalidades | Lista paginada de nacionalidades. También vía freematica_get_master_data. |
freematica_list_poblaciones | GET /pgrl/v2/poblaciones | Lista paginada de poblaciones |
freematica_get_poblacion | GET /pgrl/v2/poblaciones/{idReg} | Detalle de una población |
freematica_list_series | GET /pgrl/v2/series | Lista paginada de series (v2) |
freematica_list_lineas_negocio | GET /pgrl/v2/lineas-negocio | Lista paginada de líneas de negocio. También vía freematica_get_master_data. |
freematica_list_bancos | GET /pgrl/v2/bancos | Lista paginada de bancos |
freematica_list_tipos_impuestos | GET /pgrl/v2/tipos-impuestos | Lista paginada de tipos de impuestos |
freematica_get_tipo_impuesto | GET /pgrl/v2/tipos-impuestos/{idReg} | Detalle de un tipo de impuesto |
freematica_list_usuarios_satelite | GET /pgrl/v1/usuarios-satelite | Lista paginada de usuarios satélite |
freematica_get_configuracion_usuario | GET /pgrl/v1/configuracion-usuario/{idReg} | Configuración de un usuario por idReg |
freematica_list_auditoria_procesos | GET /pgrl/v2/auditoria-procesos | Log de auditoría de procesos |
freematica_list_instaladores | GET /pgrl/v1/instaladores | Lista paginada de instaladores |
freematica_get_instalador | GET /pgrl/v1/instaladores/{idReg} | Detalle de un instalador |
freematica_get_instalador_stocks | GET /pgrl/v1/instaladores/{idReg}/stocks | Stocks de un instalador |
freematica_list_instalador_propuestas_compras | GET /pgrl/v1/instaladores/{idReg}/propuestas-compras | Propuestas de compra de un instalador |
freematica_get_parte_instalacion | GET /pgrl/v1/partes-instalacion/{idReg} | Detalle de un parte de instalación |
freematica_list_correos | GET /pgrl/v2/correos | Lista paginada de correos (v2) |
freematica_get_correo | GET /pgrl/v2/correos/{idReg} | Detalle de un correo (v2) |
freematica_list_correos_destinatarios | GET /pgrl/v2/correos/destinatarios | Lista paginada de destinatarios de correos |
freematica_get_correos_totales | GET /pgrl/v2/correos/totales | Totales de correos (v2) |
freematica_list_correo_v1 | GET /pgrl/v1/correo | Lista paginada de correos (v1) |
freematica_verificar_mail | GET /pgrl/v2/control/mail/verificar | Verifica si un email es válido |
freematica_mailing_unsubscribe | GET /pgrl/v1/mailing/unsubscribe/{idReg} | Da de baja a un contacto del mailing |
freematica_mailing_subscribe | GET /pgrl/v1/mailing/subscribe/{idReg} | Da de alta a un contacto en el mailing |
freematica_list_campos_estadisticos | GET /pvss/v2/campos-estadisticos | Lista de campos estadísticos de cuadrantes |
freematica_list_inspecciones | GET /pvss/v2/inspecciones | Lista de inspecciones |
freematica_list_plantillas | GET /pvss/v2/plantillas | Lista de plantillas de cuadrantes |
freematica_list_normas | GET /pvss/v2/normas | Lista de normas |
freematica_list_rutas_gestion | GET /pvss/v1/rutas-gestion | Lista de gestión de rutas |
freematica_list_rutas_planificacion | GET /pvss/v1/rutas-planificacion | Lista de planificación de rutas |
freematica_list_acompanante_ruta | GET /pvss/v2/acompanante-ruta | Lista de acompañantes en ruta |
freematica_list_naturalezas_abono | GET /pven/v1/naturalezas-abono | Lista de naturalezas de abono de ventas |
freematica_list_propuestas_compra | GET /pcmp/v1/propuestas | Lista de propuestas de compra |
freematica_list_solicitudes_material | GET /peqv/v2/solicitud-material | Lista de solicitudes de material (CAE/equipamiento) |
freematica_get_solicitud_material | GET /peqv/v2/solicitud-material/{idreg} | Detalle de una solicitud de material |
freematica_list_pett_peticiones_serv | GET /pett/v2/peticiones-serv | Lista de peticiones de servicio ETT |
freematica_list_pett_peticiones_serv_perso | GET /pett/v2/peticiones-serv-perso | Lista de personal en peticiones de servicio ETT |
freematica_list_pett_ofertas | GET /pett/v2/ofertas | Lista de ofertas ETT |
freematica_list_pett_partes_ett_c | GET /pett/v1/partes_ett_c | Lista de partes ETT cliente |
freematica_list_pkai_historicos_v1 | GET /pkai/v1/historicos | Histórico de fichajes KAIROS (v1) |
freematica_list_pkai_historicos_v2 | GET /pkai/v2/historicos | Histórico de fichajes KAIROS (v2) |
freematica_list_pkai_tipos_marcajes | GET /pkai/v1/tiposmarcajes | Lista de tipos de marcaje KAIROS |
freematica_list_pedv_pedidos | GET /pedv/v1/pedidos | Lista de pedidos de venta del portal |
freematica_list_pedv_pedidos_lineas | GET /pedv/v1/pedidos-lineas | Lista de líneas de pedidos de venta del portal |
freematica_list_pfree_ips | GET /pfree/v2/ips | Lista de IPs internas Freemática |
freematica_list_pfree_ips_erp | GET /pfree/v2/ips-erp | Lista de IPs ERP Freemática |
freematica_get_pfree_ip | GET /pfree/v2/ips/{idReg} | Detalle de una IP interna |
freematica_get_pfree_ip_erp | GET /pfree/v2/ips-erp/{idReg} | Detalle de una IP ERP |
freematica_list_pdir_csm_grupo_indicador | GET /pdir/v1/csm/grupoindicador | Lista de grupos de indicadores CSM |
freematica_list_pdir_csm_indicador | GET /pdir/v1/csm/indicador | Lista de indicadores CSM |
freematica_get_pdir_csm_indicador | GET /pdir/v1/csm/indicador/{idreg} | Detalle de un indicador CSM |
freematica_list_pgdoc_edocs | GET /pgdoc/v2/edocs/docs | Lista de documentos electrónicos (edocs) |
freematica_list_pcuo_beneficiarios | GET /pcuo/v2/beneficiarios | Lista de beneficiarios (cuotas/servicios) |
freematica_get_pcuo_beneficiario | GET /pcuo/v2/beneficiarios/{idReg} | Detalle de un beneficiario |
freematica_list_pcuo_partes | GET /pcuo/v2/partes | Lista de partes de beneficiarios |
freematica_get_pcuo_parte | GET /pcuo/v2/partes/{idReg} | Detalle de un parte de beneficiario |
freematica_list_mcom_usuarios | GET /mcom/v2/usuarios | Lista de usuarios del módulo de comunicaciones |
freematica_get_mcom_usuario | GET /mcom/v2/usuarios/{idReg} | Detalle de un usuario de comunicaciones |
freematica_list_ppde_configuracion_acceso_usuario | GET /ppde/v2/configuracion-acceso-usuario | Lista de configuraciones de acceso de usuario (portal empleado) |
freematica_get_ppde_configuracion_acceso_usuario | GET /ppde/v2/configuracion-acceso-usuario/{idreg} | Detalle de configuración de acceso de usuario |
freematica_list_ppde_personal_doc | GET /ppde/v1/personal_doc | Lista de documentos de personal (portal empleado) |
freematica_get_ppde_personal_doc | GET /ppde/v1/personal_doc/{idreg} | Detalle de un documento de personal |
freematica_list_ppde_solicitud_vacaciones | GET /ppde/v2/solicitud-vacaciones | Lista de solicitudes de vacaciones (portal empleado) |
freematica_get_ppde_solicitud_vacacion | GET /ppde/v2/solicitud-vacaciones/{idreg} | Detalle de una solicitud de vacaciones |
FREEMATICA_ENABLE_WRITES=true)Por defecto el servidor es de solo lectura. Con FREEMATICA_ENABLE_WRITES=true se registran además estas tools de creación y actualización. No existe ninguna tool de borrado. Todas las escrituras dejan log de auditoría (operación + endpoint + campos a nivel info; body completo a nivel debug).
| Tool | Endpoint Freemática | Descripción |
|---|---|---|
freematica_create_contrato | POST /pvss/v2/contratos | Alta de cabecera de contrato |
freematica_update_contrato | PUT /pvss/v2/contratos/{idReg} | Actualización de cabecera de contrato |
freematica_create_servicio_contrato | POST /pvss/v2/contratos/{idReg}/servicios | Alta de servicio (identificación derivada del idReg) |
freematica_update_servicio_fechas | PUT /pvss/v2/contratos/{id}/servicio/{id} | Fechas inicio/fin del servicio (mecanismo de baja) |
freematica_create_servicio_historico_precios | POST /pvss/v2/contratos/{id}/servicios-historico-precios/{id} | Alta de revisión de precios del servicio |
freematica_update_servicio_historico_precios | PUT /pvss/v2/contratos/{id}/servicios-historico-precios/{id} | Actualización de revisión de precios |
freematica_create_servicio_facturacion_txt | POST /pvss/v2/contratos/{id}/servicios-facturacion-txt/{id} | Alta de línea de texto de facturación |
freematica_update_servicio_facturacion | PUT /pvss/v2/contratos/{id}/servicios-facturacion/{id} | Datos de facturación del servicio (precios hora, forma de pago…) |
freematica_create_contrato_opcionales | POST /ppre/v2/contratos/opcionales | Alta de opcionales de contrato |
freematica_update_contrato_opcionales | PUT /ppre/v2/contratos/opcionales/{idReg} | Actualización de opcionales de contrato |
freematica_create_cliente | POST /pgrl/v2/clientes | Alta de cliente (idReg derivado de grupo+código) |
freematica_update_cliente | PUT /pgrl/v2/clientes/{idReg} | Actualización parcial de cliente (fetch+merge) |
freematica_create_contacto_cliente | POST /pgrl/v2/contactos-clientes | Alta de contacto de cliente |
freematica_update_contacto_cliente | PUT /pgrl/v2/contactos-clientes/{idReg} | Actualización parcial de contacto (fetch+merge) |
freematica_create_localizacion_cliente | POST /pgrl/v2/localizaciones-{tipo}-clientes | Alta de localización (tipo: cobro/envio/factura/servicio) |
freematica_update_localizacion_cliente | PUT /pgrl/v2/localizaciones-{tipo}-clientes/{idReg} | Actualización parcial de localización (fetch+merge) |
freematica_create_persona | POST /pers/v1/personal | Alta de persona/empleado (campos VSSPER_* + camposAdicionales) |
freematica_update_persona | PUT /pers/v1/personal/{idReg} | Actualización parcial de persona (fetch+merge) |
freematica_create_personal_identificacion | POST /pers/v1/personal-identificacion/{idreg} | Alta de datos de identificación de una persona |
freematica_create_personal_nota | POST /pers/v2/personal-notas | Alta de nota de personal (PERNOT_*) |
freematica_update_personal_nota | PUT /pers/v2/personal-notas/{idReg} | Actualización de nota de personal (fetch+merge) |
freematica_create_personal_experiencia | POST /pers/v2/personal-experiencia | Alta de experiencia laboral (PEREX_*) |
freematica_create_personal_formacion | POST /pers/v2/personal-formaciones | Alta de formación del personal |
freematica_update_personal_formacion | PUT /pers/v2/personal-formaciones/{idReg} | Actualización de formación del personal |
freematica_create_incidencia_base | POST /pers/v2/incidencias-base | Alta de incidencia base |
freematica_update_incidencia_base_fecha_fin | PUT /pers/v2/incidencias-base/{idReg} | Actualización de fecha fin de incidencia base |
freematica_create_personal_pago | POST /pers/v1/personal_pago | Alta de datos bancarios de persona |
freematica_update_personal_pago | PUT /pers/v1/personal_pago/{idreg} | Actualización de datos bancarios de persona |
freematica_create_personal_tramo | POST /pers/v1/personal_tramos | Alta de tramo de horario (PERHH_*) |
freematica_update_personal_tramo | PUT /pers/v1/personal_tramos/{idreg} | Actualización de tramo de horario (PERHH_*) |
freematica_create_personal_contrato | POST /pers/v1/personal_contratos | Alta de contrato laboral (PERCTRAB_*) |
freematica_update_personal_contrato | PUT /pers/v1/personal_contratos/{idreg} | Actualización de contrato laboral (PERCTRAB_*) |
freematica_create_personal_adicional | POST /pers/v2/personal-adicionales | Alta de campo adicional de personal (VSSPERA_*) |
freematica_update_personal_adicional | PUT /pers/v2/personal-adicionales/{idReg} | Actualización de campo adicional de personal (VSSPERA_*) |
freematica_create_anticipo_personal | POST /pers/v2/personal/anticipos | Alta de anticipo de nómina |
freematica_create_calendario_personal | POST /pers/v2/personal-cal | Alta de entrada en calendario personal |
freematica_update_calendario_personal | PUT /pers/v2/personal-cal/{idReg} | Actualización de entrada en calendario personal |
freematica_update_cpd_bulk | POST /pers/v1/cpd/actualizar | Actualización masiva de CPDs |
freematica_update_cpd_gestion | PUT /pers/v1/cpd/{idreg}/gestion | Gestión de estado de un CPD (firmar, validar, rechazar) |
freematica_create_personal_irpf | POST /pers/v2/personal_irpf | Alta de datos IRPF de persona |
freematica_update_personal_irpf | PUT /pers/v2/personal_irpf/{idreg} | Actualización de datos IRPF de persona |
freematica_create_personal_irpf_ad | POST /pers/v2/personal_irpf_ad/{idreg} | Alta de IRPF ascendientes/descendientes de persona |
freematica_update_personal_irpf_ad | PUT /pers/v2/personal_irpf_ad/{idreg} | Actualización de IRPF ascendientes/descendientes |
freematica_update_preventor | PUT /pers/v1/control/preventor | Actualización de estado de formación en Preventor |
freematica_update_preventor_estado | POST /pers/v2/preventor/actualizar-estado | Actualización de estado Preventor (nuevo formato v2) |
freematica_create_ppre_contrato | POST /ppre/v2/contratos | Alta de contrato de instalación/mantenimiento (CON_*) |
freematica_create_ppre_orden_trabajo | POST /ppre/v1/ordenes-trabajo | Alta de orden de trabajo (AVI_*, PPC_*) |
freematica_update_ppre_orden_trabajo | PUT /ppre/v1/ordenes-trabajo/{idreg} | Actualización de orden de trabajo |
freematica_update_ppre_lineas_actas_partes | PUT /ppre/v2/partes/importar-lineas-actas-partes/{idReg} | Importar líneas de actas de partes |
freematica_create_ppre_ficha_instalacion_material | POST /ppre/v1/fichas-instalacion-material | Alta de material en ficha de instalación |
freematica_update_ppre_ficha_instalacion | PUT /ppre/v1/fichas-instalacion/{idReg} | Actualización de ficha de instalación |
freematica_create_ppre_marcaje | POST /ppre/v1/guardar | Grabar marcaje IKAROS (trackType, serviceTag, lat/lng, etc.) |
freematica_update_ppre_marcaje_v1 | PUT /ppre/v1/actualizar/{idReg} | Actualizar marcaje IKAROS (v1) |
freematica_update_ppre_marcaje_v2 | PUT /ppre/v2/actualizar/{idReg} | Actualizar marcaje IKAROS (v2) |
freematica_create_pemf_marcaje | POST /pemf/v1/servicio/{idServicio}/crear-marcaje | Crear marcaje e-Movifree en un servicio |
freematica_create_pemf_marcaje_fecha_persona | POST /pemf/v2/marcaje-fechapersona | Crear marcaje e-Movifree por fecha y persona (v2) |
freematica_create_pemf_device | POST /pemf/v1/devices | Alta de dispositivo e-Movifree |
freematica_update_pemf_device | PUT /pemf/v1/devices/{idDevice} | Actualización de dispositivo e-Movifree |
freematica_create_pemf_ronda | POST /pemf/v1/rounds | Alta de ronda de vigilancia |
freematica_save_pemf_config | POST /pemf/v{1,2}/config/{idConfig} | Guardar configuración de módulo e-Movifree (POST) |
freematica_update_pemf_config | PUT /pemf/v{1,2}/config/{idConfig} | Actualizar configuración de módulo e-Movifree (PUT) |
freematica_update_pemf_ruta | PUT /pemf/v2/routes/{idReg} | Actualizar ruta de operario (asignación, horario, frecuencia) |
freematica_create_pcrm_actividad | POST /pcrm/v2/actividades | Alta de actividad CRM (cita o tarea) |
freematica_update_pcrm_actividad | PUT /pcrm/v2/actividades/{idReg} | Actualización de actividad CRM |
freematica_create_pcrm_caso | POST /pcrm/v2/casos | Alta de caso CRM |
freematica_update_pcrm_caso | PUT /pcrm/v2/casos/{idReg} | Actualización de caso CRM |
freematica_update_pcrm_documento_usuario_v1 | PUT /pcrm/v1/usuarios/{idUsuario}/documentos/{idDocumento} | Actualización de documento de portal (v1) |
freematica_update_pcrm_documento_usuario_v2 | PUT /pcrm/v2/usuarios/{idUsuario}/documentos/{idDocumento} | Actualización de documento de portal (v2) |
freematica_create_pcrm_nota | POST /pcrm/v2/notas | Alta de nota CRM (body libre por campos nativos) |
freematica_create_oportunidad_negocio_v1 | POST /pcrm/v1/oportunidades-negocio | Alta de oportunidad de negocio (v1) |
freematica_create_oportunidad_negocio | POST /pcrm/v2/oportunidades-negocio | Alta de oportunidad de negocio (v2) |
freematica_update_oportunidad_negocio_v1 | PUT /pcrm/v1/oportunidades-negocio/{idReg} | Actualización de oportunidad de negocio (v1) |
freematica_update_oportunidad_negocio | PUT /pcrm/v2/oportunidades-negocio/{idReg} | Actualización de oportunidad de negocio (v2) |
freematica_update_oportunidad_negocio_datos_ampliados | PUT /pcrm/v2/oportunidades-negocio/{idReg}/datos-ampliados | Actualización de datos ampliados de oportunidad |
freematica_create_articulo | POST /part/v2/articulos | Alta de artículo en el catálogo de inventario |
freematica_update_articulo | PUT /part/v2/articulos/{idReg} | Actualización parcial de artículo (fetch+merge) |
freematica_create_articulo_serie_lote | POST /part/v2/articulos-serie-lote | Alta de registro de serie/lote para un artículo |
freematica_create_movimiento_stock | POST /part/v2/movimientos-stock | Alta de movimiento de stock (entradas, salidas, ajustes) |
freematica_create_entrada_produccion | POST /part/v2/entradas-produccion | Alta de entrada de producción (artículo fabricado) |
freematica_create_albaran_traspaso | POST /part/v2/control/albaran-traspaso | Alta de albarán de traspaso entre almacenes |
freematica_traspaso_albaran | PUT /part/v2/control/albaran-traspaso/{idReg} | Confirma el traspaso de un albarán de traspaso (body vacío) |
freematica_create_proveedor | POST /pgrl/v2/proveedores | Alta de proveedor (campos nativos: COD_GRUPO_PRO, COD_PRO, NIF…) |
freematica_update_proveedor | PUT /pgrl/v2/proveedores/{idReg} | Actualización parcial de proveedor (fetch+merge) |
freematica_create_localizacion_pago_proveedor | POST /pgrl/v2/localizaciones-pago-proveedores | Alta de localización de pago de proveedor |
freematica_update_localizacion_pago_proveedor | PUT /pgrl/v2/localizaciones-pago-proveedores/{idReg} | Actualización parcial de localización de pago (fetch+merge v2) |
freematica_create_calen_festivo | POST /pgrl/v2/calen-festivos | Alta de calendario festivo |
freematica_update_calen_festivo | PUT /pgrl/v2/calen-festivos/{idReg} | Actualización de calendario festivo (fetch+merge) |
freematica_update_calen_festivo_det | PUT /pgrl/v2/calen-festivos-det/{idReg} | Actualización de detalle de calendario festivo |
freematica_create_instalador_propuesta_compra | POST /pgrl/v1/instaladores/{idReg}/propuestas-compras | Alta de propuesta de compra para un instalador |
freematica_create_correo_v1 | POST /pgrl/v1/correo | Alta de correo (v1) |
freematica_create_correo | POST /pgrl/v2/correos | Alta de correo (v2) |
freematica_update_correo_estado_v1 | PUT /pgrl/v1/correo/{idReg}/estado | Actualización de estado de correo (v1) |
freematica_update_correo_estado | PUT /pgrl/v2/correos/{idReg}/estado | Actualización de estado de correo (v2) |
freematica_create_computo_pers | POST /pvss/v2/computos-pers | Alta de cómputo de persona |
freematica_update_computo_pers | PUT /pvss/v2/computos-pers/{idReg} | Actualización de cómputo de persona |
freematica_create_computo_pers_h | POST /pvss/v2/computos-pers-h | Alta de detalle de cómputo de persona |
freematica_update_cuadrante | PUT /pvss/v2/cuadrante/{idReg} | Actualizar datos de un cuadrante (campos libres PVSS) |
freematica_create_campo_estadistico | POST /pvss/v2/campos-estadisticos | Alta de campo estadístico |
freematica_update_campo_estadistico | PUT /pvss/v2/campos-estadisticos/{idReg} | Modificación de campo estadístico |
freematica_create_informe_control | POST /pvss/v2/informes-control | Insertar informes de control |
freematica_update_servicio_fch_fin | PUT /pvss/v2/servicios-fch-fin/{idReg} | Actualizar fecha fin de servicio (endpoint alternativo) |
freematica_create_albaran_venta | POST /pven/v2/albaranes-ventas | Alta de albarán de venta (cabecera + líneas ALVC**/ALVL**) |
freematica_update_albaran_fch_traspaso_ext | PUT /pven/v2/albaranes-ventas-fechatraspasoext/{idReg} | Modificación fecha traspaso externo de albarán de venta |
freematica_create_factura_estado | POST /pven/v1/facturas/estados | Actualizar datos AAPP/EDICOM de factura electrónica |
freematica_update_factura_electronica_v1 | PUT /pven/v1/facturas/{idreg} | Actualizar factura electrónica (v1, campos FACED_*) |
freematica_update_factura_electronica_v2 | PUT /pven/v2/facturas/{idreg} | Actualizar factura electrónica (v2, campos FACED_*) |
freematica_update_factura_leido | PUT /pven/v1/facturas/{idreg}/leido | Marcar factura electrónica como leída |
freematica_update_factura_compra | PUT /pcmp/v2/facturas-compras/{idReg} | Actualizar fecha exportado de factura de compra |
freematica_update_pedido_fechas | PUT /pcmp/v2/pedidos-fechas/{idreg} | Actualizar fechas entrega/enviado/conforme de pedido de compra |
freematica_recibir_pedido | PUT /pcmp/v2/control/recibir-pedidos/{idReg} | Recibir pedido de compra (body vacío) |
freematica_create_propuesta_compra | POST /pcmp/v1/propuestas | Alta de propuesta de compra |
freematica_actualizar_alta_habilitaciones_personal | PUT /peqv/v2/habilitaciones/personal/actualizar/alta | Comunicar actualización de altas de licencias de personal (CAE) |
freematica_actualizar_baja_habilitaciones_personal | PUT /peqv/v2/habilitaciones/personal/actualizar/baja | Comunicar actualización de bajas de licencias de personal (CAE) |
freematica_actualizar_alta_habilitaciones_servicios | PUT /peqv/v2/habilitaciones/servicios/actualizar/alta | Comunicar actualización de altas de habilitaciones de servicios |
freematica_actualizar_baja_habilitaciones_servicios | PUT /peqv/v2/habilitaciones/servicios/actualizar/baja | Comunicar actualización de bajas de habilitaciones de servicios |
freematica_create_solicitud_material | POST /peqv/v2/solicitud-material | Alta de solicitud de material (CAE/equipamiento) |
freematica_import_asientos | POST /pcon/v2/import-asientos | Insertar asiento contable en borrador (campos BORR_*) |
freematica_create_pett_peticion_serv | POST /pett/v2/peticiones-serv | Alta de petición de servicio ETT |
freematica_create_pett_peticion_serv_perso | POST /pett/v2/peticiones-serv/perso | Alta de persona en petición de servicio ETT |
freematica_update_pett_peticion_serv | PUT /pett/v2/peticiones-serv/{idreg} | Actualización de petición de servicio ETT |
freematica_update_pett_peticion_serv_perso_estado | PUT /pett/v2/peticiones-serv/perso/estado/{idreg} | Actualizar estado de persona en petición de servicio ETT |
freematica_update_pett_peticion_serv_duplicar | PUT /pett/v2/peticiones-serv/duplicar/{idreg} | Duplicar petición de servicio ETT |
freematica_create_pett_gestion_partes_ett_c | POST /pett/v1/gestion_partes_ett_c | Gestionar partes ETT cliente |
freematica_update_pett_proceso_servicio_fin | PUT /pett/v2/procesos_servicio_fin/{idreg} | Fin de proceso de servicio ETT |
freematica_update_pett_proceso_servicio | PUT /pett/v2/procesos-servicio/{idreg} | Actualizar proceso de servicio ETT |
freematica_update_pett_proceso_servicio_prorroga | PUT /pett/v2/procesos-servicio-prorrogas/{idreg} | Prórroga de proceso de servicio ETT |
freematica_create_pkai_marcaje | POST /pkai/v1/marcajes | Guardar marcaje KAIROS |
freematica_create_pedv_pedido_servir | POST /pedv/v1/pedidos/{idreg}/servir | Servir pedido de venta (v1) |
freematica_update_pedv_servir_pedido_v2 | PUT /pedv/v2/control/servir-pedidos/{idReg} | Servir pedido de venta (v2) |
freematica_create_pcuo_beneficiario | POST /pcuo/v2/beneficiarios | Alta de beneficiario |
freematica_update_pcuo_beneficiario | PUT /pcuo/v2/beneficiarios/{idReg} | Actualización de beneficiario |
freematica_create_pcuo_parte | POST /pcuo/v2/partes | Alta de parte de beneficiario |
freematica_update_pcuo_parte | PUT /pcuo/v2/partes/{idReg} | Actualización de parte de beneficiario |
freematica_create_mcom_usuario | POST /mcom/v2/usuarios | Alta de usuario de comunicaciones |
freematica_update_mcom_usuario | PUT /mcom/v2/usuarios/{idReg} | Actualización de usuario de comunicaciones |
freematica_update_ppde_solicitud_vacacion | PUT /ppde/v2/solicitud-vacaciones/{idreg} | Actualizar observaciones de solicitud de vacaciones |
freematica_create_ppde_recordatorio_firma | POST /ppde/v2/recordatorio_firma | Enviar recordatorio de firma (portal empleado) |
freematica_create_comp_albaran_compra | POST /comp/v2/albaranes-compras | Alta de albarán de compras |
freematica_create_comp_registro_gastos_contrato | POST /comp/v2/registro-gastos-contratos | Registro de gastos de contratos |
freematica_create_psel_candidato | POST /psel/v2/control/candidatos | Alta de candidato (selección de personal) |
freematica_create_ptes_importar_fichero_n43 | POST /ptes/v1/importar-fichero-n43 | Importar fichero N43 (tesorería) |
El MCP expone parámetros tipados con zod al consumidor (Claude/LLM). Internamente, el cliente los traduce a sintaxis FIQL antes de llamar al API de Freemática. El consumidor nunca ve ni escribe FIQL.
// El LLM llama:
freematica_list_cartera_clientes({
empresa: '0001',
fechaDocDesde: '2026-01-01',
estado: 'pendiente',
});
// El MCP construye internamente (valores siempre entre comillas simples):
// rquery=CARCL_EMP=='0001';CARCL_FECDOC=ge='2026-01-01';CARCL_SITCAR=='1'
src/clients/fiql-builder.ts).soloImpagados: true) se traducen automáticamente al operador FIQL correcto.// Facturas pendientes de traspaso a contabilidad:
freematica_list_facturas_cabecera({
empresa: '0001',
traspasadoContabilidad: false,
});
// → rquery=FVC_CODEMP=='0001';FVC_TRASP_CONTAB=='0'
// Proveedor por nombre EXACTO (el API no soporta búsqueda parcial: =lk=
// responde 400 y los wildcards % devuelven 0 resultados). El filtro activo
// de proveedores post-filtra las bajas en cliente (FIQL no tiene IS NULL):
freematica_list_proveedores({
nombre: 'LEJIAS PONS S.A.',
activo: true,
});
// → rquery=NOMBRE_PRO=='LEJIAS PONS S.A.'
El binario soporta dos transportes seleccionables. La selección sigue este orden de precedencia:
--transport=<modo>MCP_TRANSPORT=<modo>stdio| Modo | Cuándo usar | Comando |
|---|---|---|
stdio | Claude Desktop, Claude Code, ejecución local | mcp-freematica (default) o mcp-freematica --transport=stdio |
http | Nubiia, deploy como servicio web | mcp-freematica --transport=http o MCP_TRANSPORT=http mcp-freematica |
Edita ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"freematica": {
"command": "npx",
"args": ["-y", "@nubiia/mcp-freematica"],
"env": {
"FREEMATICA_AUTH_TOKEN": "...",
"FREEMATICA_AUTH_COMPANY": "...",
"FREEMATICA_AUTH_ORGANIZATION": "...",
"FREEMATICA_AUTH_APP": "...",
"FREEMATICA_AUTH_SESSION": "..."
}
}
}
}
Reinicia Claude Desktop y las tools de freematica_* aparecerán disponibles.
claude mcp add freematica npx -y @nubiia/mcp-freematica \
-e FREEMATICA_AUTH_TOKEN=... \
-e FREEMATICA_AUTH_COMPANY=... \
-e FREEMATICA_AUTH_ORGANIZATION=... \
-e FREEMATICA_AUTH_APP=... \
-e FREEMATICA_AUTH_SESSION=...
Setear MCP_TRANSPORT=http en las variables de entorno del proceso, junto a las 5 FREEMATICA_AUTH_*. Resto de variables (puerto, origins) opcionales — ver tabla en "Configuración avanzada".
La tool freematica_get_master_data acepta un parámetro catalog con uno de los 24 valores siguientes. Cada uno mapea a un endpoint específico de Freemática.
catalog | Endpoint Freemática | Contenido |
|---|---|---|
| Tipos / clasificaciones | ||
tipos-contrato | GET /ppre/v2/tipos-contrato | Tipos de contrato comercial |
tipo-instalacion | GET /ppre/v1/tipo-instalacion | Tipos de instalación física |
clases-servicios | GET /pvss/v1/clases-servicios | Clases de servicio operativas |
tipos-casos | GET /pcrm/v2/tipos-casos | Tipos de caso CRM |
subtipos-casos | GET /pcrm/v2/subtipos-casos | Subtipos de caso CRM |
tipos-oportunidad-negocio | GET /pcrm/v2/tipos-oportunidad-negocio | Tipos de oportunidad comercial |
tipos-impuestos | GET /pgrl/v2/tipos-impuestos | IVA, IRPF, retenciones |
naturalezas-abono | GET /pven/v1/naturalezas-abono | Naturalezas de abono comercial |
incidencecode | GET /pvss/v2/incidencecode | Códigos de incidencia en servicios |
claves-facturacion | GET /pvss/v2/claves-facturacion | Claves de facturación de servicios |
| Geográficos | ||
paises | GET /pgrl/v1/paises | Países |
nacionalidades | GET /pgrl/v1/nacionalidades | Nacionalidades |
provincias | GET /pgrl/v1/provincias | Provincias |
poblaciones | GET /pgrl/v2/poblaciones | Municipios |
| Organizativos | ||
empresas | GET /pgrl/v1/empresas | Empresas |
delegaciones | GET /pgrl/v1/delegaciones/agrupcod | Delegaciones (listado global) |
lineas-negocio | GET /pgrl/v2/lineas-negocio | Líneas de negocio |
cargos-clientes | GET /pgrl/v2/cargos-clientes | Cargos de contactos |
calendarios | GET /pgrl/v1/calendarios | Calendarios laborales |
series | GET /pgrl/v2/series | Series de numeración de documentos |
| Inventario | ||
familias | GET /part/v1/familias | Familias de artículos |
subfamilias | GET /part/v1/subfamilias | Subfamilias |
lineas | GET /part/v1/lineas | Líneas de artículos |
| Financiero | ||
bancos | GET /pgrl/v2/bancos | Entidades bancarias |
Respuesta: { catalog, items, count, total }. Patrón típico de uso: llamar primero al catálogo correspondiente cuando otra tool devuelva IDs crípticos para resolverlos a nombres humanos.
Todas las tools freematica_list_* aceptan dos parámetros opcionales:
page (int, ≥1, default 1): página a recuperar, 1-indexed.items (int, 1..50, default 20): items por página.La respuesta incluye siempre total (total de elementos en el dataset) para que el LLM pueda iterar páginas.
El parámetro está bloqueado en
page >= 1porque el API real de Freemática tratapage=0como "devuelve TODO el dataset" (varios MB en endpoints grandes comoclientes). Verificado empíricamente.
Las tools freematica_get_* requieren un id que NO es el código natural (COD_CLI, ID_OPORTUNIDAD) sino el campo idReg que aparece en los items del listado correspondiente. Es un string opaco base64 como MV9fMTAwMA==.
Si pasas un código natural, el API responde not_found.
Patrón típico de uso desde el LLM:
freematica_list_clientes(page=1, items=20) → encontrar el cliente que interesa.idReg de ese item.freematica_get_cliente(id="<idReg>") → detalle completo.El servidor lee toda su configuración de variables de entorno al arrancar. Si falta alguna obligatoria, el proceso muere con un mensaje claro listando qué falta — no acepta requests hasta que la configuración sea válida.
| Variable | Descripción |
|---|---|
FREEMATICA_AUTH_TOKEN | Header x-auth-token para autenticar con la API de Freemática. |
FREEMATICA_AUTH_COMPANY | Header x-auth-company. Identifica la empresa dentro del API. |
FREEMATICA_AUTH_ORGANIZATION | Header x-auth-organization. Identifica la organización. |
FREEMATICA_AUTH_APP | Header x-auth-app. Identifica la aplicación que consume (p.ej. pvss). |
FREEMATICA_AUTH_SESSION | Header x-auth-session. Identifica la sesión activa. |
Variables de entorno opcionales para tuning de comportamiento en producción:
| Variable | Default | Descripción |
|---|---|---|
FREEMATICA_BASE_URL | https://api-p01.clientservicepanel.com/restsat/api | Base URL del API de Freemática. Cambiar solo si Freemática cambia el host o se usa un entorno alternativo. |
FREEMATICA_TIMEOUT_MS | 30000 | Timeout por petición en milisegundos. Si el upstream no responde en este tiempo, el request se cancela con network_error. |
FREEMATICA_MAX_RETRIES | 3 | Número máximo de reintentos para errores 5xx y errores de red. Los errores 4xx nunca se reintentan. |
FREEMATICA_CIRCUIT_BREAKER_THRESHOLD | 5 | Número de operaciones lógicas fallidas consecutivas (post-retry-exhaustion) necesarias para abrir el circuit breaker. |
FREEMATICA_CIRCUIT_BREAKER_TIMEOUT_MS | 30000 | Tiempo en ms que el circuit breaker permanece abierto antes de pasar a half-open. |
FREEMATICA_MAX_RESPONSE_SIZE_MB | 10 | Tamaño máximo de respuesta aceptada del upstream en MB. Respuestas mayores se truncan con aviso en el campo truncated. |
FREEMATICA_ENABLE_WRITES | false | Registra las tools de escritura (freematica_create_* / freematica_update_*). Sin ella el servidor es de solo lectura. Valores: true/false/1/0. |
MCP_TRANSPORT | stdio | Transporte: stdio (para Claude Desktop/Code) o http (para Nubiia). Equivale al flag --transport=. |
MCP_PORT | 3000 | Puerto TCP donde el servidor MCP expone /mcp y /health. Ignorado en modo stdio. |
MCP_ALLOWED_ORIGINS | * | CORS: lista de orígenes permitidos separados por coma, o * para todos. En producción restringir al dominio de Nubiia. Ignorado en modo stdio. |
LOG_LEVEL | info | Nivel de log para pino: fatal, error, warn, info, debug, trace. En producción usar info. En desarrollo usar debug. |
x-auth-*Las 5 credenciales x-auth-* son preexistentes — el Postman collection de Freemática no expone un endpoint de login, así que estas credenciales se obtienen fuera de banda (típicamente por el departamento de IT de Freemática o tu integrador).
.env.* en .gitignore (excepto .env.example).invalid_token en todas las llamadas. Renovarlas implica reiniciar el proceso (no hay refresh automático).Nubiia despliega el servidor MCP y se encarga de inyectar las variables de entorno. En el panel de Nubiia:
https://freematica-mcp.example.com/mcp).MCP_ALLOWED_ORIGINS al dominio exacto desde el que Claude/Nubiia conecta, no *.GET /health que el servidor está vivo antes de habilitar el MCP en Claude.Para desarrollo local crea un .env (o .env.local) en la raíz:
cp .env.example .env
# Edita .env y rellena los 5 FREEMATICA_AUTH_*
Luego arranca con:
set -a; source .env; set +a
npm run dev
O todo en una línea:
node --env-file=.env --import tsx src/index.ts
Sin env vars — el proceso debe morir inmediatamente con un mensaje listando las 5 variables que faltan:
node dist/index.js
# [freematica-mcp] FATAL: Invalid configuration:
# - FREEMATICA_AUTH_TOKEN: Required
# - FREEMATICA_AUTH_COMPANY: Required
# ...
Con env vars válidas (modo HTTP) — arranca con MCP_TRANSPORT=http y el proceso queda escuchando; /health devuelve { "status": "ok", "version": "0.5.0", "sessions": 0 }:
MCP_TRANSPORT=http node dist/index.js &
curl http://localhost:3000/health
En modo stdio (default) no hay endpoints HTTP — el server escucha JSON-RPC por stdin/stdout.
invalid_token en todas las llamadasLas credenciales x-auth-* han caducado o son incorrectas. Pasos:
FREEMATICA_AUTH_* están seteadas correctamente.network_error — upstream Freemática caídoEl API de Freemática no está respondiendo. Puede ser:
Circuit breaker opened).api-p01.clientservicepanel.com.Pasos:
circuitBreaker: "open" — si es así, esperar FREEMATICA_CIRCUIT_BREAKER_TIMEOUT_MS ms (default 30s) para que pase a half-open.curl https://api-p01.clientservicepanel.com/.FREEMATICA_TIMEOUT_MS si el upstream es lento (default 30s puede ser insuficiente en algunas redes).rate_limit_exceeded — throttling de FreemáticaFreemática devuelve 429. El MCP reintenta automáticamente honrando el header Retry-After si está presente. Si el problema persiste:
FREEMATICA_MAX_RETRIES (default 3) si los reintentos no son suficientes.Response truncated en freematica_export_asientosEl endpoint de exportación de asientos devuelve demasiados registros para un rango de fechas amplio. Pasos:
FREEMATICA_MAX_RESPONSE_SIZE_MB (default 10 MB).git commitLint o formato detectaron errores en los ficheros staged. Pasos:
npm run lint:fix y npm run format para corregir automáticamente.git add de los ficheros corregidos antes de volver a intentar el commit.npm install
npm run dev # arranca con tsx (hot reload)
npm test # ejecuta vitest una vez
npm run test:watch # watcher
npm run test:coverage # coverage report
npm run lint
npm run lint:fix
npm run format
npm run typecheck
npm run build # compila a dist/
npm start # ejecuta dist/index.js
# Ejecutar todos los tests
npm test
# Ejecutar con coverage report
npm test -- --coverage
# Ejecutar un archivo concreto
npm test -- tests/fiql-builder.property.test.ts
Los tests están en tests/ organizados por tipo:
tests/clients/ — tests de los clientes HTTP (con nock)tests/schemas/ — tests de los schemas Zodtests/tools/ — tests de los handlers MCP (unit + integration)tests/fiql-builder.*.test.ts — tests unitarios y property-based del FIQL buildertests/pagination-edge-cases.test.ts — edge cases del adapter de paginacióntests/coverage-gaps.test.ts — cobertura específica de ramas no cubiertasCoverage thresholds (configurados en vitest.config.ts):
Para probar el servidor MCP de forma interactiva, usa MCP Inspector.
Ver instrucciones detalladas en docs/testing-e2e.md.
| Método | Path | Descripción |
|---|---|---|
| POST | /mcp | JSON-RPC del MCP (envía initialize la primera vez) |
| GET | /mcp | Stream SSE (requiere Mcp-Session-Id) |
| DELETE | /mcp | Terminar sesión |
| GET | /health | Healthcheck |
[!IMPORTANT] El endpoint
/mcpno autentica al cliente. Cualquiera con acceso de red al puerto puede invocar las tools usando las credenciales de Freemática que el servidor tiene configuradas en sus variables de entorno. Como todas las tools son de solo lectura, esto equivale a acceso de lectura a los datos de la empresa (cartera, facturación, clientes, personal…).
Por tanto, al desplegar en modo HTTP:
MCP_ALLOWED_ORIGINS al dominio exacto desde el que se conecta,
en lugar del valor por defecto *. Si arrancas con *, el servidor emite un
warning en el log. Ten en cuenta que CORS solo protege frente a navegadores;
no frente a clientes como curl.FREEMATICA_AUTH_* como secretos. Inyéctalas vía
gestor de secretos, nunca en el repositorio (.env* está en .gitignore).Buenas prácticas ya incluidas en el servidor:
x-auth-* se eliminan de cualquier log (incluido debug/trace)
y los bodies de petición nunca se loguean./mcp y /health, límite de body de
1 MB, y expiración automática de sesiones inactivas.src/types/<grupo>.ts.FreematicaClient (src/clients/freematica-client.ts):
getContratosServicios(): Promise<VoContratosServicios[]> {
return this.get<VoContratosServicios[]>('/pvss/v1/contratos-servicios');
}
server.tool(...) en src/tools/<grupo>.ts (o crear el archivo si el grupo es nuevo).register<Grupo>Tools(server, client) en src/server.ts.Patrón inspirado en mcp-nevent y mcp-holded.
Pensado para ejecutarse dentro de Nubiia. La plataforma se encarga del deploy y de inyectar las variables de entorno. Tienes 3 opciones:
El paquete se publica como @nubiia/mcp-freematica en el registry público de npm cuando se crea un tag v* en main.
# Instalar y ejecutar (no requiere autenticación)
npm install -g @nubiia/mcp-freematica
mcp-freematica # binario instalado, lee env vars y arranca el server
docker build -t mcp-freematica .
docker run --env-file .env -p 3000:3000 mcp-freematica
git clone https://github.com/nubiia-dev/mcp-freematica.git
cd mcp-freematica
npm ci && npm run build
node dist/index.js
package.json (semver).main.v:
git tag v0.5.0
git push origin v0.5.0
.github/workflows/release.yml se dispara, valida (lint + typecheck + test + build) y publica en npm.docs/superpowers/specs/2026-05-18-freematica-mcp-design.md (bootstrap inicial)docs/superpowers/plans/2026-05-18-freematica-mcp.mddocs/superpowers/specs/2026-05-19-stdio-transport-design.md (stdio support)docs/superpowers/plans/2026-05-19-stdio-transport.mddocs/superpowers/specs/2026-05-19-master-data-tool-design.md (master data tool)docs/superpowers/plans/2026-05-19-master-data-tool.mddocs/superpowers/specs/2026-05-20-commercial-tools-design.md (commercial tools + envelope unwrap fix)docs/superpowers/plans/2026-05-20-commercial-tools.mddelegaciones (endpoint cambiado a /agrupcod) y tipos-marcajes (eliminado — endpoint roto). Ver CHANGELOG.docs/adr/ (ver índice en ese directorio)apidocs/Freematica API - Complete Collection.postman_collection.jsonCHANGELOG.mdThis MCP server is built and maintained by Nubiia.
Nubiia ayuda a empresas a automatizar procesos e integrar sus herramientas con IA: servidores MCP a medida, integraciones con ERPs y CRMs (Freemática, Holded, Pipedrive…), y agentes que conectan tus datos de negocio con asistentes como Claude. Este @nubiia/mcp-freematica es un ejemplo open source de lo que hacemos.
👉 ¿Quieres una integración o automatización con IA para tu negocio? nubiia.es · ✉️ hola@nubiia.es
Built by Nubiia — nubiia.es · hola@nubiia.es
Maintainer: Samuel Fraga — GitHub
MIT — ver LICENSE.
FAQs
MCP server for the Freemática ERP REST API: invoicing, accounts receivable, suppliers, accounting and HR data for AI assistants like Claude. Built by Nubiia.
We found that @nubiia/mcp-freematica demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Threat Research
/Security News
Socket uncovered secret-stealing workflows that ran in LiteLLM’s GitHub repository 11 days before the supply chain attack on PyPI and Docker.
Security News
Cloudflare introduces tsrs, a Rust port of TypeScript’s compiler promising faster checks and lower memory use, with the TypeScript team’s help.
Security News
The PHP Foundation says Chainguard broke a security embargo ahead of critical RCE patches, as leaks disrupted the coordinated release.