@nubiia/mcp-freematica 0.6.1

package/dist/tools/albaranes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"albaranes.js","sourceRoot":"","sources":["../../src/tools/albaranes.ts"],"names":[],"mappings":"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"}

package/dist/tools/calendarios.d.ts

@@ -0,0 +1,13 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FreematicaClient } from '../clients/freematica-client.js';
+/**
+ * Registra las tools MCP del dominio Calendarios Laborales.
+ *
+ * Tools expuestas:
+ *  1. freematica_list_calendarios         — lista paginada de calendarios
+ *  2. freematica_list_calendario_periodos — periodos de un calendario (idReg)
+ *
+ * @param server - Instancia del servidor MCP.
+ * @param client - Cliente Freemática autenticado.
+ */
+export declare function registerCalendariosTools(server: McpServer, client: FreematicaClient): void;

package/dist/tools/calendarios.js

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+import { FreematicaError } from '../clients/base-client.js';
+import { PaginationSchema } from '../schemas/pagination.js';
+import { error, okList } from './helpers.js';
+// ---------------------------------------------------------------------------
+// Tool names
+// ---------------------------------------------------------------------------
+const LIST_CALENDARIOS_TOOL_NAME = 'freematica_list_calendarios';
+const LIST_PERIODOS_TOOL_NAME = 'freematica_list_calendario_periodos';
+// ---------------------------------------------------------------------------
+// Descriptions
+// ---------------------------------------------------------------------------
+const LIST_CALENDARIOS_DESCRIPTION = [
+    'Devuelve la lista paginada de calendarios laborales registrados en Freemática.',
+    '',
+    'Endpoint: GET /pgrl/v1/calendarios',
+    '',
+    'Cada item incluye `idReg` opaco que se usa en freematica_list_calendario_periodos',
+    'para obtener los periodos de un calendario concreto.',
+    '',
+    'Soporta paginación estándar (page, items).',
+].join('\n');
+const LIST_PERIODOS_DESCRIPTION = [
+    'Devuelve los periodos de un calendario laboral concreto.',
+    '',
+    'Endpoint: GET /pgrl/v1/calendarios/{idreg}/periodos',
+    '',
+    'El parámetro `idCalendario` DEBE ser el campo `idReg` (string opaco base64)',
+    'que aparece en los items de freematica_list_calendarios.',
+    '',
+    'Soporta paginación estándar (page, items).',
+].join('\n');
+// ---------------------------------------------------------------------------
+// Register function
+// ---------------------------------------------------------------------------
+/**
+ * Registra las tools MCP del dominio Calendarios Laborales.
+ *
+ * Tools expuestas:
+ *  1. freematica_list_calendarios         — lista paginada de calendarios
+ *  2. freematica_list_calendario_periodos — periodos de un calendario (idReg)
+ *
+ * @param server - Instancia del servidor MCP.
+ * @param client - Cliente Freemática autenticado.
+ */
+export function registerCalendariosTools(server, client) {
+    // -------------------------------------------------------------------------
+    // 1. freematica_list_calendarios
+    // -------------------------------------------------------------------------
+    server.tool(LIST_CALENDARIOS_TOOL_NAME, LIST_CALENDARIOS_DESCRIPTION, PaginationSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ page, items }) => {
+        try {
+            const result = await client.listCalendarios({ page, items });
+            return okList({ items: result.items, total: result.total, page, itemsPerPage: items });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    // -------------------------------------------------------------------------
+    // 2. freematica_list_calendario_periodos
+    // -------------------------------------------------------------------------
+    server.tool(LIST_PERIODOS_TOOL_NAME, LIST_PERIODOS_DESCRIPTION, {
+        idCalendario: z
+            .string()
+            .min(1)
+            .describe('idReg opaco del calendario (campo "idReg" en los items de freematica_list_calendarios).'),
+        ...PaginationSchema,
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ idCalendario, page, items }) => {
+        try {
+            const result = await client.listCalendarioPeriodos(idCalendario, { page, items });
+            return okList({ items: result.items, total: result.total, page, itemsPerPage: items });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+}
+//# sourceMappingURL=calendarios.js.map

package/dist/tools/calendarios.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendarios.js","sourceRoot":"","sources":["../../src/tools/calendarios.ts"],"names":[],"mappings":"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"}

package/dist/tools/cartera.d.ts

@@ -0,0 +1,13 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FreematicaClient } from '../clients/freematica-client.js';
+/**
+ * Registra las tools MCP del dominio "Cartera de Clientes".
+ *
+ * Expone 2 tools:
+ * - `freematica_list_cartera_clientes`: listado paginado con filtros FIQL
+ * - `freematica_get_cartera_cliente`: detalle por idReg
+ *
+ * @param server - Instancia MCP donde se registran las tools.
+ * @param client - Cliente tipado de Freemática.
+ */
+export declare function registerCarteraTools(server: McpServer, client: FreematicaClient): void;

package/dist/tools/cartera.js

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+import { FreematicaError } from '../clients/base-client.js';
+import { ListCarteraFiltersSchema } from '../schemas/cartera.js';
+import { error, ok, okList } from './helpers.js';
+const LIST_TOOL_NAME = 'freematica_list_cartera_clientes';
+const GET_TOOL_NAME = 'freematica_get_cartera_cliente';
+const LIST_DESCRIPTION = [
+    'Devuelve la lista paginada de documentos de cartera de clientes (cobros, efectos, impagados).',
+    '',
+    'Útil para analizar el estado de cobros: deudas pendientes, impagados, vencimientos próximos.',
+    '',
+    'Cada item contiene ~40 campos: CARCL_CODAUX (código cliente), CARCL_IMPCOB (importe cobrado),',
+    'CARCL_IMPPEN (importe pendiente), CARCL_FECDOC (fecha documento), CARCL_FECVCTO (fecha vencimiento),',
+    'CARCL_SITCAR (estado: 1=pendiente, 2=cancelado, 3=derivado), CARCL_FECIMPAG (fecha impago, null si no hay)',
+    'más un campo `idReg` opaco (base64) para `freematica_get_cartera_cliente`.',
+    '',
+    'Filtros disponibles:',
+    '- empresa, codCliente, grupoCliente, representante, formaPago, modoPago',
+    '- fechaDocDesde/Hasta (rango de fecha del documento)',
+    '- fechaVencimientoDesde/Hasta (rango de vencimiento)',
+    '- estado: "pendiente" | "cancelado" | "derivado"',
+    '- soloImpagados: true → solo documentos con impago registrado (CARCL_FECIMPAG no nulo)',
+    '- referencia: referencia exacta del documento (CARCL_REFCAR)',
+    '',
+    'Paginación 1-indexed. Default: page=1, items=20.',
+].join('\n');
+const GET_DESCRIPTION = [
+    'Devuelve el detalle completo de un documento de cartera de clientes.',
+    '',
+    'El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece en los items de',
+    'freematica_list_cartera_clientes. NO usar CARCL_CODAUX ni otro código natural.',
+].join('\n');
+const IdSchema = {
+    id: z
+        .string()
+        .min(1)
+        .describe('idReg opaco del documento de cartera (campo "idReg" en los items de freematica_list_cartera_clientes).'),
+};
+/**
+ * Registra las tools MCP del dominio "Cartera de Clientes".
+ *
+ * Expone 2 tools:
+ * - `freematica_list_cartera_clientes`: listado paginado con filtros FIQL
+ * - `freematica_get_cartera_cliente`: detalle por idReg
+ *
+ * @param server - Instancia MCP donde se registran las tools.
+ * @param client - Cliente tipado de Freemática.
+ */
+export function registerCarteraTools(server, client) {
+    server.tool(LIST_TOOL_NAME, LIST_DESCRIPTION, ListCarteraFiltersSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async (args) => {
+        try {
+            const result = await client.listCarteraClientes(args);
+            return okList({
+                items: result.items,
+                total: result.total,
+                page: args.page,
+                itemsPerPage: args.items,
+            });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    server.tool(GET_TOOL_NAME, GET_DESCRIPTION, IdSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ id }) => {
+        try {
+            const doc = await client.getCarteraCliente(id);
+            return ok(doc);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+}
+//# sourceMappingURL=cartera.js.map

package/dist/tools/cartera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cartera.js","sourceRoot":"","sources":["../../src/tools/cartera.ts"],"names":[],"mappings":"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"}

package/dist/tools/clientes.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FreematicaClient } from '../clients/freematica-client.js';
+export declare function registerClientesTools(server: McpServer, client: FreematicaClient): void;

package/dist/tools/clientes.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import { FreematicaError } from '../clients/base-client.js';
+import { PaginationSchema } from '../schemas/pagination.js';
+import { error, ok, okList } from './helpers.js';
+const LIST_TOOL_NAME = 'freematica_list_clientes';
+const GET_TOOL_NAME = 'freematica_get_cliente';
+const LIST_DESCRIPTION = [
+    'Devuelve la lista paginada de clientes de Freemática.',
+    '',
+    'Cada item tiene ~87 campos (COD_CLI, NOMBRE_CLI, NIF, FECHA_ALTA, etc.) más un campo `idReg` opaco (base64) que se usa para el endpoint singular `freematica_get_cliente`.',
+    '',
+    'Paginación 1-indexed: la primera página es page=1. Devuelve también `total` con el total de clientes en el dataset.',
+].join('\n');
+const GET_DESCRIPTION = [
+    'Devuelve el detalle completo de un cliente.',
+    '',
+    'El parámetro `id` DEBE ser el campo `idReg` (string opaco base64) que aparece en los items de freematica_list_clientes. NO usar COD_CLI ni otro código natural — el API devuelve not_found.',
+].join('\n');
+export function registerClientesTools(server, client) {
+    server.tool(LIST_TOOL_NAME, LIST_DESCRIPTION, PaginationSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ page, items }) => {
+        try {
+            const result = await client.listClientes({ page, items });
+            return okList({ items: result.items, total: result.total, page, itemsPerPage: items });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    server.tool(GET_TOOL_NAME, GET_DESCRIPTION, {
+        id: z
+            .string()
+            .min(1)
+            .describe('idReg opaco del cliente (campo "idReg" en los items de freematica_list_clientes).'),
+    }, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ id }) => {
+        try {
+            const cliente = await client.getCliente(id);
+            return ok(cliente);
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+}
+//# sourceMappingURL=clientes.js.map

package/dist/tools/clientes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientes.js","sourceRoot":"","sources":["../../src/tools/clientes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,cAAc,GAAG,0BAA0B,CAAC;AAClD,MAAM,aAAa,GAAG,wBAAwB,CAAC;AAE/C,MAAM,gBAAgB,GAAG;IACvB,uDAAuD;IACvD,EAAE;IACF,4KAA4K;IAC5K,EAAE;IACF,qHAAqH;CACtH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,eAAe,GAAG;IACtB,6CAA6C;IAC7C,EAAE;IACF,6LAA6L;CAC9L,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,MAAwB;IAC/E,MAAM,CAAC,IAAI,CACT,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EACnE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAA2B,EAAE;QACjD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC1D,OAAO,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,CAAmB,CAAC;QAC3G,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,eAAe;gBAAE,OAAO,KAAK,CAAC,GAAG,CAAmB,CAAC;YACxE,OAAO,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAmB,CAAC;QACtF,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,aAAa,EACb,eAAe,EACf;QACE,EAAE,EAAE,CAAC;aACF,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CACP,mFAAmF,CACpF;KACJ,EACD,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EACnE,KAAK,EAAE,EAAE,EAAE,EAAE,EAA2B,EAAE;QACxC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAC5C,OAAO,EAAE,CAAC,OAAO,CAAmB,CAAC;QACvC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,eAAe;gBAAE,OAAO,KAAK,CAAC,GAAG,CAAmB,CAAC;YACxE,OAAO,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAmB,CAAC;QACtF,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/contabilidad.d.ts

@@ -0,0 +1,14 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FreematicaClient } from '../clients/freematica-client.js';
+/**
+ * Registra las 3 tools de contabilidad en el MCP server.
+ *
+ * Tools registradas:
+ * - freematica_list_cuentas_contables  → GET /pcon/v2/cuentas
+ * - freematica_list_cuentas_analiticas → GET /pcon/v2/cuentas-analiticas
+ * - freematica_export_asientos          → GET /pcon/v2/export-asientos
+ *
+ * @param server - Instancia del servidor MCP.
+ * @param client - Cliente tipado de Freemática.
+ */
+export declare function registerContabilidadTools(server: McpServer, client: FreematicaClient): void;

package/dist/tools/contabilidad.js

@@ -0,0 +1,259 @@
+import { z } from 'zod';
+import { FreematicaError } from '../clients/base-client.js';
+import { error, ok, okList } from './helpers.js';
+// ---------------------------------------------------------------------------
+// Tool names
+// ---------------------------------------------------------------------------
+const LIST_CUENTAS_CONTABLES_TOOL = 'freematica_list_cuentas_contables';
+const LIST_CUENTAS_ANALITICAS_TOOL = 'freematica_list_cuentas_analiticas';
+const EXPORT_ASIENTOS_TOOL = 'freematica_export_asientos';
+// ---------------------------------------------------------------------------
+// Descriptions
+// ---------------------------------------------------------------------------
+const LIST_CUENTAS_CONTABLES_DESCRIPTION = [
+    'Devuelve el plan de cuentas contables de Freemática.',
+    '',
+    'Endpoint: GET /pcon/v2/cuentas.',
+    'Devuelve los registros del catálogo de cuentas del Plan Contable (COD_CTA, COD_PLAN, COD_GRUPO_CTA, CTA_ACTIVA, NOMBRE_CTA, etc.).',
+    '',
+    'Filtros FIQL disponibles:',
+    '  - codPlan: filtra por código de plan contable (COD_PLAN).',
+    '  - prefijoCuenta: filtra cuentas cuyo COD_CTA comienza por el prefijo indicado (prefijo match).',
+    '  - activa: si true, devuelve solo cuentas activas (CTA_ACTIVA==1); si false, solo inactivas.',
+    '  - grupoCuenta: filtra por código de grupo de cuenta (COD_GRUPO_CTA).',
+    '',
+    'Los filtros se combinan con AND. Todos son opcionales.',
+].join('\n');
+const LIST_CUENTAS_ANALITICAS_DESCRIPTION = [
+    'Devuelve el catálogo de cuentas analíticas de Freemática.',
+    '',
+    'Endpoint: GET /pcon/v2/cuentas-analiticas.',
+    'Devuelve los registros de cuentas analíticas (COD_CTA_ANL, COD_PLAN, COD_GRUPO_ANL, CTA_ACTIVA_ANL, AREA_ANL, DELEG, etc.).',
+    '',
+    'Filtros FIQL disponibles:',
+    '  - codPlan: filtra por código de plan (COD_PLAN).',
+    '  - prefijoCuenta: filtra cuentas cuyo COD_CTA_ANL comienza por el prefijo indicado.',
+    '  - activa: si true, solo cuentas activas (CTA_ACTIVA_ANL==1); si false, solo inactivas.',
+    '  - grupoCuenta: filtra por código de grupo analítico (COD_GRUPO_ANL).',
+    '  - area: filtra por área analítica (AREA_ANL).',
+    '  - delegacion: filtra por delegación (DELEG).',
+    '',
+    'Los filtros se combinan con AND. Todos son opcionales.',
+].join('\n');
+const EXPORT_ASIENTOS_DESCRIPTION = [
+    'Exporta asientos contables de Freemática en batch.',
+    '',
+    'Endpoint: GET /pcon/v2/export-asientos.',
+    '',
+    '⚠️ AVISO: Este endpoint puede devolver volúmenes MUY GRANDES de datos.',
+    'RECOMENDAR siempre un rango de fechas (fechaDesde + fechaHasta) para acotar',
+    'la respuesta. Sin rango de fechas, puede devolver TODO el histórico contable.',
+    '',
+    'Parámetros obligatorios:',
+    '  - empresa: código de empresa de 4 caracteres exactos (ej. "0001").',
+    '  - cal: código de calendario de 4 caracteres exactos (ej. "GRAL").',
+    '',
+    'Parámetros opcionales nativos (query param directo, no FIQL):',
+    '  - periodo: número de periodo contable (1-12, puede tener ceros, ej. "01").',
+    '',
+    'Filtros FIQL adicionales (opcionales):',
+    '  - fechaDesde / fechaHasta: rango de fechas sobre ASI_FCHASI en formato YYYY-MM-DD.',
+    '  - diario: código del diario contable (ASI_DIARIO).',
+    '  - borrador: si true, incluye solo asientos borrador (ASI_BORR no nulo).',
+    '',
+    'Protección de tamaño: si la respuesta supera FREEMATICA_MAX_RESPONSE_SIZE_MB (default 10 MB),',
+    'la tool devuelve los datos truncados con un campo "warning" indicando el truncado.',
+    'Se recomienda usar rangos de fecha cortos (máx. 1 mes) para evitar truncados.',
+].join('\n');
+// ---------------------------------------------------------------------------
+// Input schemas
+// ---------------------------------------------------------------------------
+/**
+ * Schema de filtros para freematica_list_cuentas_contables.
+ */
+const CuentasContablesFiltersSchema = {
+    codPlan: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código del plan contable (COD_PLAN en Freemática). Opcional.'),
+    prefijoCuenta: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Prefijo del código de cuenta (COD_CTA). La tool aplica prefix match (COD_CTA starts-with). Opcional.'),
+    activa: z
+        .boolean()
+        .optional()
+        .describe('Si true, devuelve solo cuentas activas (CTA_ACTIVA==1). Si false, solo inactivas. Omitir para todas.'),
+    grupoCuenta: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de grupo de cuenta (COD_GRUPO_CTA). Opcional.'),
+};
+/**
+ * Schema de filtros para freematica_list_cuentas_analiticas.
+ */
+const CuentasAnaliticasFiltersSchema = {
+    codPlan: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código del plan contable (COD_PLAN). Opcional.'),
+    prefijoCuenta: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Prefijo del código de cuenta analítica (COD_CTA_ANL). Prefix match. Opcional.'),
+    activa: z
+        .boolean()
+        .optional()
+        .describe('Si true, solo cuentas activas (CTA_ACTIVA_ANL==1). Si false, solo inactivas. Omitir para todas.'),
+    grupoCuenta: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de grupo analítico (COD_GRUPO_ANL). Opcional.'),
+    area: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Área analítica (AREA_ANL). Opcional.'),
+    delegacion: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código de delegación (DELEG). Opcional.'),
+};
+/**
+ * Schema de input para freematica_export_asientos.
+ *
+ * - empresa y cal son obligatorios (4 chars exactos), se envían como query params nativos.
+ * - periodo es opcional (hasta 2 chars) y también es query param nativo.
+ * - fechaDesde/Hasta, diario, borrador son filtros FIQL opcionales.
+ */
+const ExportAsientosSchema = {
+    empresa: z
+        .string()
+        .length(4)
+        .describe('Código de empresa (4 caracteres exactos, ej. "0001"). OBLIGATORIO. Se envía como query param nativo.'),
+    cal: z
+        .string()
+        .length(4)
+        .describe('Código de calendario contable (4 caracteres exactos, ej. "GRAL"). OBLIGATORIO. Se envía como query param nativo.'),
+    periodo: z
+        .string()
+        .max(2)
+        .optional()
+        .describe('Número de periodo contable (máx. 2 chars, ej. "01" para enero). Opcional. Se envía como query param nativo.'),
+    fechaDesde: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, 'Debe ser una fecha en formato YYYY-MM-DD')
+        .optional()
+        .describe('Fecha inicio del rango de asientos en formato YYYY-MM-DD (sobre ASI_FCHASI). Recomendado siempre para acotar el volumen.'),
+    fechaHasta: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/, 'Debe ser una fecha en formato YYYY-MM-DD')
+        .optional()
+        .describe('Fecha fin del rango de asientos en formato YYYY-MM-DD (sobre ASI_FCHASI). Recomendado siempre para acotar el volumen.'),
+    diario: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Código del diario contable (ASI_DIARIO). Opcional.'),
+    borrador: z
+        .boolean()
+        .optional()
+        .describe('Si true, incluye solo asientos en estado borrador (ASI_BORR no nulo). Si false, solo asientos definitivos. Omitir para todos.'),
+};
+// ---------------------------------------------------------------------------
+// Register function
+// ---------------------------------------------------------------------------
+/**
+ * Registra las 3 tools de contabilidad en el MCP server.
+ *
+ * Tools registradas:
+ * - freematica_list_cuentas_contables  → GET /pcon/v2/cuentas
+ * - freematica_list_cuentas_analiticas → GET /pcon/v2/cuentas-analiticas
+ * - freematica_export_asientos          → GET /pcon/v2/export-asientos
+ *
+ * @param server - Instancia del servidor MCP.
+ * @param client - Cliente tipado de Freemática.
+ */
+export function registerContabilidadTools(server, client) {
+    // -------------------------------------------------------------------------
+    // freematica_list_cuentas_contables
+    // -------------------------------------------------------------------------
+    server.tool(LIST_CUENTAS_CONTABLES_TOOL, LIST_CUENTAS_CONTABLES_DESCRIPTION, CuentasContablesFiltersSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ codPlan, prefijoCuenta, activa, grupoCuenta }) => {
+        try {
+            const result = await client.listCuentasContables({
+                codPlan,
+                prefijoCuenta,
+                activa,
+                grupoCuenta,
+            });
+            return okList({ items: result.items, total: result.total });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    // -------------------------------------------------------------------------
+    // freematica_list_cuentas_analiticas
+    // -------------------------------------------------------------------------
+    server.tool(LIST_CUENTAS_ANALITICAS_TOOL, LIST_CUENTAS_ANALITICAS_DESCRIPTION, CuentasAnaliticasFiltersSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ codPlan, prefijoCuenta, activa, grupoCuenta, area, delegacion }) => {
+        try {
+            const result = await client.listCuentasAnaliticas({
+                codPlan,
+                prefijoCuenta,
+                activa,
+                grupoCuenta,
+                area,
+                delegacion,
+            });
+            return okList({ items: result.items, total: result.total });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+    // -------------------------------------------------------------------------
+    // freematica_export_asientos
+    // -------------------------------------------------------------------------
+    server.tool(EXPORT_ASIENTOS_TOOL, EXPORT_ASIENTOS_DESCRIPTION, ExportAsientosSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ empresa, cal, periodo, fechaDesde, fechaHasta, diario, borrador, }) => {
+        try {
+            const result = await client.exportAsientos({
+                empresa,
+                cal,
+                periodo,
+                fechaDesde,
+                fechaHasta,
+                diario,
+                borrador,
+            });
+            if (result.truncated) {
+                // Respuesta truncada por exceder MAX_RESPONSE_SIZE_MB
+                const payload = {
+                    items: result.items,
+                    count: result.items.length,
+                    total: result.total,
+                    warning: result.warning,
+                    truncated: true,
+                };
+                return ok(payload);
+            }
+            return okList({ items: result.items, total: result.total });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+}
+//# sourceMappingURL=contabilidad.js.map

package/dist/tools/contabilidad.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contabilidad.js","sourceRoot":"","sources":["../../src/tools/contabilidad.ts"],"names":[],"mappings":"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"}

package/dist/tools/contactos-clientes.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FreematicaClient } from '../clients/freematica-client.js';
+export declare function registerContactosClientesTools(server: McpServer, client: FreematicaClient): void;

package/dist/tools/contactos-clientes.js

@@ -0,0 +1,25 @@
+import { FreematicaError } from '../clients/base-client.js';
+import { PaginationSchema } from '../schemas/pagination.js';
+import { error, okList } from './helpers.js';
+const LIST_TOOL_NAME = 'freematica_list_contactos_clientes';
+const LIST_DESCRIPTION = [
+    'Devuelve la lista paginada de contactos de clientes (personas asociadas a clientes corporativos).',
+    '',
+    'Cada item incluye un campo `idReg` opaco (base64). En esta versión no exponemos un endpoint singular para contactos; si necesitas el detalle, contacta al mantenedor del MCP.',
+    '',
+    'Paginación 1-indexed.',
+].join('\n');
+export function registerContactosClientesTools(server, client) {
+    server.tool(LIST_TOOL_NAME, LIST_DESCRIPTION, PaginationSchema, { readOnlyHint: true, destructiveHint: false, openWorldHint: true }, async ({ page, items }) => {
+        try {
+            const result = await client.listContactosClientes({ page, items });
+            return okList({ items: result.items, total: result.total, page, itemsPerPage: items });
+        }
+        catch (err) {
+            if (err instanceof FreematicaError)
+                return error(err);
+            return error(err instanceof Error ? err : new Error(String(err)));
+        }
+    });
+}
+//# sourceMappingURL=contactos-clientes.js.map

package/dist/tools/contactos-clientes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contactos-clientes.js","sourceRoot":"","sources":["../../src/tools/contactos-clientes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,cAAc,GAAG,oCAAoC,CAAC;AAE5D,MAAM,gBAAgB,GAAG;IACvB,mGAAmG;IACnG,EAAE;IACF,+KAA+K;IAC/K,EAAE;IACF,uBAAuB;CACxB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,UAAU,8BAA8B,CAAC,MAAiB,EAAE,MAAwB;IACxF,MAAM,CAAC,IAAI,CACT,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EACnE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAA2B,EAAE;QACjD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACnE,OAAO,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,CAAmB,CAAC;QAC3G,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,eAAe;gBAAE,OAAO,KAAK,CAAC,GAAG,CAAmB,CAAC;YACxE,OAAO,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAmB,CAAC;QACtF,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/contratos.d.ts

@@ -0,0 +1,10 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FreematicaClient } from '../clients/freematica-client.js';
+/**
+ * Registers every MCP tool that maps to operations in the "Contratos" API group
+ * (Postman: app `pvss` → group `Contratos`).
+ *
+ * Add new tools here by calling `server.tool(...)` again. When this file grows
+ * past ~15 tools, split it into `src/tools/contratos/<entity>.ts`.
+ */
+export declare function registerContratosTools(server: McpServer, client: FreematicaClient): void;