@nubiia/mcp-freematica 0.6.2 → 0.6.4

package/README.md

@@ -1,6 +1,12 @@
 # mcp-freematica
 
-MCP server que expone operaciones del API REST de Freemática para ser consumidas por Claude a través de Nubiia.
+[![npm version](https://img.shields.io/npm/v/@nubiia/mcp-freematica)](https://www.npmjs.com/package/@nubiia/mcp-freematica)
+[![license: MIT](https://img.shields.io/npm/l/@nubiia/mcp-freematica)](./LICENSE)
+[![by Nubiia](https://img.shields.io/badge/by-Nubiia-6C4EE3)](https://nubiia.es)
+
+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](https://nubiia.es)** — 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](https://nubiia.es)**.
 
 ## Stack
 
@@ -510,6 +516,26 @@ node dist/index.js
 - API: `apidocs/Freematica API - Complete Collection.postman_collection.json`
 - CHANGELOG: `CHANGELOG.md`
 
+## About Nubiia
+
+This MCP server is built and maintained by **[Nubiia](https://nubiia.es)**.
+
+[Nubiia](https://nubiia.es) 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](https://nubiia.es)** · ✉️ [hola@nubiia.es](mailto:hola@nubiia.es)
+
+## Author
+
+Built by **[Nubiia](https://nubiia.es)** — [nubiia.es](https://nubiia.es) · [hola@nubiia.es](mailto:hola@nubiia.es)
+
+Maintainer: Samuel Fraga — [GitHub](https://github.com/iamsamuelfraga)
+
+## Links
+
+- [Nubiia — AI automation & integrations](https://nubiia.es)
+- [npm: @nubiia/mcp-freematica](https://www.npmjs.com/package/@nubiia/mcp-freematica)
+- [GitHub: nubiia-dev/mcp-freematica](https://github.com/nubiia-dev/mcp-freematica)
+
 ## Licencia
 
 MIT — ver `LICENSE`.

package/dist/config.d.ts

@@ -6,31 +6,11 @@ declare const AuthConfigSchema: z.ZodObject<{
     FREEMATICA_AUTH_ORGANIZATION: z.ZodString;
     FREEMATICA_AUTH_APP: z.ZodString;
     FREEMATICA_AUTH_SESSION: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    FREEMATICA_BASE_URL: string;
-    FREEMATICA_AUTH_TOKEN: string;
-    FREEMATICA_AUTH_COMPANY: string;
-    FREEMATICA_AUTH_ORGANIZATION: string;
-    FREEMATICA_AUTH_APP: string;
-    FREEMATICA_AUTH_SESSION: string;
-}, {
-    FREEMATICA_AUTH_TOKEN: string;
-    FREEMATICA_AUTH_COMPANY: string;
-    FREEMATICA_AUTH_ORGANIZATION: string;
-    FREEMATICA_AUTH_APP: string;
-    FREEMATICA_AUTH_SESSION: string;
-    FREEMATICA_BASE_URL?: string | undefined;
-}>;
+}, z.core.$strip>;
 declare const HttpConfigSchema: z.ZodObject<{
-    MCP_PORT: z.ZodDefault<z.ZodNumber>;
+    MCP_PORT: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     MCP_ALLOWED_ORIGINS: z.ZodDefault<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    MCP_PORT: number;
-    MCP_ALLOWED_ORIGINS: string;
-}, {
-    MCP_PORT?: number | undefined;
-    MCP_ALLOWED_ORIGINS?: string | undefined;
-}>;
+}, z.core.$strip>;
 /**
  * Configuración de hardening del cliente HTTP.
  *
@@ -38,61 +18,20 @@ declare const HttpConfigSchema: z.ZodObject<{
  * configuración explícita en la mayoría de los entornos.
  */
 declare const HardeningConfigSchema: z.ZodObject<{
-    /**
-     * Timeout por petición HTTP en milisegundos.
-     * Por defecto: 30000 (30 segundos).
-     */
-    FREEMATICA_TIMEOUT_MS: z.ZodDefault<z.ZodNumber>;
-    /**
-     * Número máximo de reintentos para errores 5xx y errores de red.
-     * Los errores 4xx nunca se reintentan.
-     * Por defecto: 3.
-     */
-    FREEMATICA_MAX_RETRIES: z.ZodDefault<z.ZodNumber>;
-    /**
-     * Nivel de logging de pino.
-     * Valores válidos: trace | debug | info | warn | error | fatal.
-     * Por defecto: info.
-     */
-    LOG_LEVEL: z.ZodDefault<z.ZodEnum<["trace", "debug", "info", "warn", "error", "fatal"]>>;
-    /**
-     * Número de fallos consecutivos antes de abrir el circuit breaker.
-     * Por defecto: 5.
-     */
-    FREEMATICA_CIRCUIT_BREAKER_THRESHOLD: z.ZodDefault<z.ZodNumber>;
-    /**
-     * Tiempo en ms que el circuit breaker permanece abierto antes de pasar
-     * a half-open para intentar recuperarse.
-     * Por defecto: 30000 (30 segundos).
-     */
-    FREEMATICA_CIRCUIT_BREAKER_TIMEOUT_MS: z.ZodDefault<z.ZodNumber>;
-    /**
-     * Tamaño máximo de respuesta aceptado por freematica_export_asientos en
-     * megabytes. Si la respuesta del API supera este umbral, los datos se
-     * truncan y se añade un campo `warning` a la respuesta de la tool.
-     *
-     * Se recomienda usar rangos de fecha cortos (max. 1 mes) para evitar
-     * alcanzar este límite.
-     *
-     * Por defecto: 10 (10 MB).
-     * Mínimo: 1 MB. Máximo: 500 MB.
-     */
-    FREEMATICA_MAX_RESPONSE_SIZE_MB: z.ZodDefault<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    FREEMATICA_TIMEOUT_MS: number;
-    FREEMATICA_MAX_RETRIES: number;
-    LOG_LEVEL: "trace" | "debug" | "info" | "warn" | "error" | "fatal";
-    FREEMATICA_CIRCUIT_BREAKER_THRESHOLD: number;
-    FREEMATICA_CIRCUIT_BREAKER_TIMEOUT_MS: number;
-    FREEMATICA_MAX_RESPONSE_SIZE_MB: number;
-}, {
-    FREEMATICA_TIMEOUT_MS?: number | undefined;
-    FREEMATICA_MAX_RETRIES?: number | undefined;
-    LOG_LEVEL?: "trace" | "debug" | "info" | "warn" | "error" | "fatal" | undefined;
-    FREEMATICA_CIRCUIT_BREAKER_THRESHOLD?: number | undefined;
-    FREEMATICA_CIRCUIT_BREAKER_TIMEOUT_MS?: number | undefined;
-    FREEMATICA_MAX_RESPONSE_SIZE_MB?: number | undefined;
-}>;
+    FREEMATICA_TIMEOUT_MS: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    FREEMATICA_MAX_RETRIES: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    LOG_LEVEL: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        trace: "trace";
+        debug: "debug";
+        info: "info";
+        warn: "warn";
+        fatal: "fatal";
+    }>>;
+    FREEMATICA_CIRCUIT_BREAKER_THRESHOLD: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    FREEMATICA_CIRCUIT_BREAKER_TIMEOUT_MS: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    FREEMATICA_MAX_RESPONSE_SIZE_MB: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
 export type AuthConfig = z.infer<typeof AuthConfigSchema>;
 export type HttpConfig = z.infer<typeof HttpConfigSchema>;
 export type HardeningConfig = z.infer<typeof HardeningConfigSchema>;

package/dist/schemas/cartera.d.ts

@@ -7,7 +7,11 @@ import { z } from 'zod';
  * - `cancelado`  → `CARCL_SITCAR==2`
  * - `derivado`   → `CARCL_SITCAR==3`
  */
-export declare const EstadoCarteraEnum: z.ZodEnum<["pendiente", "cancelado", "derivado"]>;
+export declare const EstadoCarteraEnum: z.ZodEnum<{
+    pendiente: "pendiente";
+    cancelado: "cancelado";
+    derivado: "derivado";
+}>;
 export type EstadoCartera = z.infer<typeof EstadoCarteraEnum>;
 /** Mapa de enum lógico → valor numérico FIQL en `CARCL_SITCAR`. */
 export declare const ESTADO_CARTERA_FIQL_MAP: Record<EstadoCartera, string>;
@@ -45,7 +49,11 @@ export declare const ListCarteraFiltersSchema: {
     fechaDocHasta: z.ZodOptional<z.ZodString>;
     fechaVencimientoDesde: z.ZodOptional<z.ZodString>;
     fechaVencimientoHasta: z.ZodOptional<z.ZodString>;
-    estado: z.ZodOptional<z.ZodEnum<["pendiente", "cancelado", "derivado"]>>;
+    estado: z.ZodOptional<z.ZodEnum<{
+        pendiente: "pendiente";
+        cancelado: "cancelado";
+        derivado: "derivado";
+    }>>;
     soloImpagados: z.ZodOptional<z.ZodBoolean>;
     referencia: z.ZodOptional<z.ZodString>;
     page: z.ZodDefault<z.ZodNumber>;

package/dist/schemas/facturas-electronicas.d.ts

@@ -52,7 +52,11 @@ export type ListFacturasElectronicasFilters = {
  */
 export declare const ListFacturasDocumentosFiltersSchema: {
     documents: z.ZodOptional<z.ZodString>;
-    documentType: z.ZodOptional<z.ZodEnum<["PDF", "XML", "ERROR"]>>;
+    documentType: z.ZodOptional<z.ZodEnum<{
+        PDF: "PDF";
+        XML: "XML";
+        ERROR: "ERROR";
+    }>>;
 };
 export type ListFacturasDocumentosFilters = {
     documents?: string;

package/dist/schemas/filters.d.ts

@@ -14,13 +14,7 @@ import { z } from 'zod';
 export declare const DateRangeSchema: z.ZodObject<{
     fechaDesde: z.ZodOptional<z.ZodString>;
     fechaHasta: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    fechaDesde?: string | undefined;
-    fechaHasta?: string | undefined;
-}, {
-    fechaDesde?: string | undefined;
-    fechaHasta?: string | undefined;
-}>;
+}, z.core.$strip>;
 export type DateRange = z.infer<typeof DateRangeSchema>;
 /**
  * Filtros de identidad para entidades de Freemática.
@@ -37,17 +31,7 @@ export declare const IdentityFiltersSchema: z.ZodObject<{
     grupoCliente: z.ZodOptional<z.ZodString>;
     codProveedor: z.ZodOptional<z.ZodString>;
     grupoProveedor: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    codProveedor?: string | undefined;
-    codCliente?: string | undefined;
-    grupoCliente?: string | undefined;
-    grupoProveedor?: string | undefined;
-}, {
-    codProveedor?: string | undefined;
-    codCliente?: string | undefined;
-    grupoCliente?: string | undefined;
-    grupoProveedor?: string | undefined;
-}>;
+}, z.core.$strip>;
 export type IdentityFilters = z.infer<typeof IdentityFiltersSchema>;
 /**
  * Schema base para tools que necesitan paginación + rango de fechas + filtros
@@ -70,23 +54,5 @@ export declare const BaseFiltersSchema: z.ZodObject<{
     fechaHasta: z.ZodOptional<z.ZodString>;
     page: z.ZodDefault<z.ZodNumber>;
     items: z.ZodDefault<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    page: number;
-    items: number;
-    codProveedor?: string | undefined;
-    codCliente?: string | undefined;
-    fechaDesde?: string | undefined;
-    fechaHasta?: string | undefined;
-    grupoCliente?: string | undefined;
-    grupoProveedor?: string | undefined;
-}, {
-    codProveedor?: string | undefined;
-    codCliente?: string | undefined;
-    page?: number | undefined;
-    items?: number | undefined;
-    fechaDesde?: string | undefined;
-    fechaHasta?: string | undefined;
-    grupoCliente?: string | undefined;
-    grupoProveedor?: string | undefined;
-}>;
+}, z.core.$strip>;
 export type BaseFilters = z.infer<typeof BaseFiltersSchema>;

package/dist/schemas/master-data.d.ts

@@ -15,7 +15,32 @@ import { z } from 'zod';
  */
 export declare const MASTER_DATA_CATALOGS: readonly ["tipos-contrato", "tipo-instalacion", "clases-servicios", "tipos-casos", "subtipos-casos", "tipos-oportunidad-negocio", "tipos-impuestos", "naturalezas-abono", "incidencecode", "claves-facturacion", "paises", "nacionalidades", "provincias", "poblaciones", "empresas", "delegaciones", "lineas-negocio", "cargos-clientes", "calendarios", "series", "familias", "subfamilias", "lineas", "bancos"];
 export type MasterDataCatalog = typeof MASTER_DATA_CATALOGS[number];
-export declare const MasterDataCatalogSchema: z.ZodEnum<["tipos-contrato", "tipo-instalacion", "clases-servicios", "tipos-casos", "subtipos-casos", "tipos-oportunidad-negocio", "tipos-impuestos", "naturalezas-abono", "incidencecode", "claves-facturacion", "paises", "nacionalidades", "provincias", "poblaciones", "empresas", "delegaciones", "lineas-negocio", "cargos-clientes", "calendarios", "series", "familias", "subfamilias", "lineas", "bancos"]>;
+export declare const MasterDataCatalogSchema: z.ZodEnum<{
+    "tipos-contrato": "tipos-contrato";
+    "tipo-instalacion": "tipo-instalacion";
+    "clases-servicios": "clases-servicios";
+    "tipos-casos": "tipos-casos";
+    "subtipos-casos": "subtipos-casos";
+    "tipos-oportunidad-negocio": "tipos-oportunidad-negocio";
+    "tipos-impuestos": "tipos-impuestos";
+    "naturalezas-abono": "naturalezas-abono";
+    incidencecode: "incidencecode";
+    "claves-facturacion": "claves-facturacion";
+    paises: "paises";
+    nacionalidades: "nacionalidades";
+    provincias: "provincias";
+    poblaciones: "poblaciones";
+    empresas: "empresas";
+    delegaciones: "delegaciones";
+    "lineas-negocio": "lineas-negocio";
+    "cargos-clientes": "cargos-clientes";
+    calendarios: "calendarios";
+    series: "series";
+    familias: "familias";
+    subfamilias: "subfamilias";
+    lineas: "lineas";
+    bancos: "bancos";
+}>;
 /**
  * Mapeo catálogo → endpoint REST de Freemática.
  *

package/dist/schemas/pedidos-compras.d.ts

@@ -27,7 +27,11 @@ import { z } from 'zod';
  *
  * TODO(TD-152): verificar contra API real cuando esté disponible.
  */
-export declare const EstadoPedidoEnum: z.ZodEnum<["pendiente", "bloqueado", "recibido"]>;
+export declare const EstadoPedidoEnum: z.ZodEnum<{
+    pendiente: "pendiente";
+    bloqueado: "bloqueado";
+    recibido: "recibido";
+}>;
 export type EstadoPedido = z.infer<typeof EstadoPedidoEnum>;
 /**
  * Genera la expresión FIQL para el filtro de estado de pedido de compra.
@@ -82,7 +86,11 @@ export declare const ListPedidosCompraFiltersSchema: {
     fechaEntregaDesde: z.ZodOptional<z.ZodString>;
     fechaEntregaHasta: z.ZodOptional<z.ZodString>;
     referencia: z.ZodOptional<z.ZodString>;
-    estado: z.ZodOptional<z.ZodEnum<["pendiente", "bloqueado", "recibido"]>>;
+    estado: z.ZodOptional<z.ZodEnum<{
+        pendiente: "pendiente";
+        bloqueado: "bloqueado";
+        recibido: "recibido";
+    }>>;
     page: z.ZodDefault<z.ZodNumber>;
     items: z.ZodDefault<z.ZodNumber>;
 };

package/dist/tools/prl.d.ts

@@ -7,32 +7,12 @@ import type { FreematicaClient } from '../clients/freematica-client.js';
  * Se usa en los tests y dentro del handler. NO se pasa directamente a server.tool
  * porque ZodEffects no es ZodRawShapeCompat.
  */
-export declare const FichaPrevClienteRefinedSchema: z.ZodEffects<z.ZodObject<{
+export declare const FichaPrevClienteRefinedSchema: z.ZodObject<{
     codCliente: z.ZodOptional<z.ZodString>;
     grupoCliente: z.ZodOptional<z.ZodNumber>;
     codLocalizacionServicio: z.ZodOptional<z.ZodNumber>;
     codigoFicha: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    codCliente?: string | undefined;
-    grupoCliente?: number | undefined;
-    codLocalizacionServicio?: number | undefined;
-    codigoFicha?: string | undefined;
-}, {
-    codCliente?: string | undefined;
-    grupoCliente?: number | undefined;
-    codLocalizacionServicio?: number | undefined;
-    codigoFicha?: string | undefined;
-}>, {
-    codCliente?: string | undefined;
-    grupoCliente?: number | undefined;
-    codLocalizacionServicio?: number | undefined;
-    codigoFicha?: string | undefined;
-}, {
-    codCliente?: string | undefined;
-    grupoCliente?: number | undefined;
-    codLocalizacionServicio?: number | undefined;
-    codigoFicha?: string | undefined;
-}>;
+}, z.core.$strip>;
 /**
  * Registra las tools MCP del dominio PRL (Prevención de Riesgos Laborales).
  *

package/dist/tools/prl.js

@@ -176,7 +176,7 @@ export function registerPrlTools(server, client) {
             codigoFicha,
         });
         if (!validation.success) {
-            const msg = validation.error.errors.map((e) => e.message).join('; ');
+            const msg = validation.error.issues.map((e) => e.message).join('; ');
             return error(new Error(msg));
         }
         try {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nubiia/mcp-freematica",
-  "version": "0.6.2",
-  "description": "MCP server for Freemática REST API (consumed by Claude via Nubiia)",
+  "version": "0.6.4",
+  "description": "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.",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -33,7 +33,7 @@
   "bugs": {
     "url": "https://github.com/nubiia-dev/mcp-freematica/issues"
   },
-  "homepage": "https://github.com/nubiia-dev/mcp-freematica#readme",
+  "homepage": "https://nubiia.es",
   "publishConfig": {
     "access": "public"
   },
@@ -44,9 +44,26 @@
     "mcp",
     "model-context-protocol",
     "freematica",
+    "freematica-api",
+    "erp",
+    "invoicing",
+    "facturacion",
+    "accounting",
+    "contabilidad",
+    "cartera",
+    "api",
+    "claude",
+    "anthropic",
+    "ai",
+    "llm",
+    "automation",
     "nubiia"
   ],
-  "author": "Nubiia",
+  "author": {
+    "name": "Nubiia",
+    "email": "hola@nubiia.es",
+    "url": "https://nubiia.es"
+  },
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
@@ -56,7 +73,7 @@
     "express-rate-limit": "^8.3.1",
     "pino": "^10.3.1",
     "uuid": "^14.0.0",
-    "zod": "^3.23.8"
+    "zod": "^4.4.3"
   },
   "lint-staged": {
     "*.{ts,js}": [
@@ -69,18 +86,18 @@
   "devDependencies": {
     "@types/cors": "^2.8.19",
     "@types/express": "^4.17.21",
-    "@types/node": "^20.10.0",
+    "@types/node": "^26.0.1",
     "@types/uuid": "^10.0.0",
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",
     "@vitest/coverage-v8": "^3.2.6",
     "@vitest/ui": "^3.2.6",
     "dotenv": "^16.0.0",
-    "eslint": "^9.0.0",
+    "eslint": "^10.6.0",
     "fast-check": "^4.8.0",
     "husky": "^9.1.7",
     "lint-staged": "^16.4.0",
-    "nock": "^13.5.0",
+    "nock": "^14.0.16",
     "pino-pretty": "^13.1.3",
     "prettier": "^3.3.0",
     "tsx": "^4.6.0",