refacil-pay-mcp 1.0.0

package/dist/core/tools.js

@@ -0,0 +1,1721 @@
+// Tipos para herramientas MCP
+import { z } from 'zod';
+import axios from 'axios';
+import { getAuthHeaders } from './auth.js';
+import { appConfig } from '../config.js';
+// Configuración de la API
+const API_CONFIG = {
+    get baseUrl() {
+        return appConfig.baseUrl;
+    },
+    timeout: 30000
+};
+// Helper para asignar valores definidos (incluye null) sin mutar argumentos originales
+function assignIfDefined(target, source, key) {
+    if (Object.prototype.hasOwnProperty.call(source, key) && source[key] !== undefined) {
+        target[key] = source[key];
+    }
+}
+// Función helper para hacer requests HTTP
+// secretId puede venir del contexto de la request (HTTP mode) o undefined (STDIO mode)
+async function makeApiRequest(method, endpoint, data, params, secretId) {
+    try {
+        // Obtener headers de autenticación según el tipo
+        const headers = await getAuthHeaders();
+        const url = `${API_CONFIG.baseUrl}${endpoint}`;
+        const config = {
+            method: method.toLowerCase(),
+            url,
+            headers,
+            timeout: API_CONFIG.timeout
+        };
+        if (params && Object.keys(params).length > 0) {
+            config.params = params;
+        }
+        if (data && method !== 'GET') {
+            config.data = data;
+        }
+        const response = await axios(config);
+        // Formato estándar del protocolo MCP
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        statusCode: response.status,
+                        data: response.data,
+                        message: 'Operación exitosa'
+                    }, null, 2)
+                }
+            ]
+        };
+    }
+    catch (error) {
+        const errorData = {
+            success: false,
+            statusCode: error.response?.status || 500,
+            data: error.response?.data || null,
+            message: error.response?.data?.message || error.message || 'Error en la operación',
+            error: error.code || 'UNKNOWN_ERROR'
+        };
+        // Formato estándar del protocolo MCP para errores
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(errorData, null, 2)
+                }
+            ],
+            isError: true
+        };
+    }
+}
+const auth_loginInputJsonSchema = {
+    "type": "object",
+    "properties": {
+        "username": {
+            "type": "string",
+            "description": "Campo del body: username",
+            "default": "{{username}}"
+        },
+        "password": {
+            "type": "string",
+            "description": "Campo del body: password",
+            "default": "{{secretKey}}"
+        }
+    },
+    "required": []
+};
+const auth_loginInputShape = {
+    username: z.string().optional().describe("Campo del body: username"),
+    password: z.string().optional().describe("Campo del body: password")
+};
+const auth_loginInputValidator = z.object(auth_loginInputShape);
+// Herramienta: auth_login
+export const auth_loginTool = {
+    name: 'auth_login',
+    description: "| **Name** | **Type** | **Description** |\\n| --- | --- | --- |\\n| **username** \\\\* | string | User |\\n| **password** \\\\* | string | Password |\n\nContexto: Endpoint: POST /auth/login | Autenticación > Auth > Login | Uso: Genera un token JWT usando las credenciales configuradas en el MCP",
+    inputSchema: auth_loginInputShape,
+    jsonSchema: auth_loginInputJsonSchema,
+    endpoint: '/auth/login',
+    method: 'POST',
+    parameters: [],
+    headers: [{ "key": "Content-Type", "value": "application/json" }],
+    handler: async (rawArgs) => {
+        try {
+            const normalizedArgs = rawArgs ?? {};
+            // Extraer secretId del contexto (si viene del HTTP mode)
+            const secretId = normalizedArgs._secretId;
+            // Remover _secretId de los args antes de validar
+            const { _secretId, ...argsToValidate } = normalizedArgs;
+            const validatedInput = validateToolInput(auth_loginInputValidator, argsToValidate);
+            const args = validatedInput;
+            const bodyData = {};
+            const usernameValue = args.username !== undefined ? args.username : "{{username}}";
+            if (usernameValue !== undefined)
+                bodyData.username = usernameValue;
+            const passwordValue = args.password !== undefined ? args.password : "{{secretKey}}";
+            if (passwordValue !== undefined)
+                bodyData.password = passwordValue;
+            return await makeApiRequest('POST', '/auth/login', bodyData, undefined, secretId);
+        }
+        catch (error) {
+            // Formato estándar del protocolo MCP para errores
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            statusCode: 500,
+                            data: null,
+                            message: error instanceof Error ? error.message : 'Error desconocido',
+                            error: 'HANDLER_ERROR'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+const trx_token_generateInputJsonSchema = {
+    "type": "object",
+    "properties": {
+        "service": {
+            "type": "string",
+            "description": "Campo del body: service",
+            "default": "/cash-in/generate/payment-link/token"
+        }
+    },
+    "required": []
+};
+const trx_token_generateInputShape = {
+    service: z.string().optional().describe("Campo del body: service")
+};
+const trx_token_generateInputValidator = z.object(trx_token_generateInputShape);
+// Herramienta: trx_token_generate
+export const trx_token_generateTool = {
+    name: 'trx_token_generate',
+    description: "| **Name** | **Type** | **Description** |\\n| --- | --- | --- |\\n| **service** \\\\* | string | Value of the service to be consumed |\n\nContexto: Endpoint: POST /trx-token/generate | Trx token > Generate",
+    inputSchema: trx_token_generateInputShape,
+    jsonSchema: trx_token_generateInputJsonSchema,
+    endpoint: '/trx-token/generate',
+    method: 'POST',
+    parameters: [],
+    headers: [{ "key": "Authorization", "value": "Bearer {{tokenLogin}}", "type": "text" }],
+    handler: async (rawArgs) => {
+        try {
+            const normalizedArgs = rawArgs ?? {};
+            // Extraer secretId del contexto (si viene del HTTP mode)
+            const secretId = normalizedArgs._secretId;
+            // Remover _secretId de los args antes de validar
+            const { _secretId, ...argsToValidate } = normalizedArgs;
+            const validatedInput = validateToolInput(trx_token_generateInputValidator, argsToValidate);
+            const args = validatedInput;
+            const bodyData = {};
+            const serviceValue = args.service !== undefined ? args.service : "/cash-in/generate/payment-link/token";
+            if (serviceValue !== undefined)
+                bodyData.service = serviceValue;
+            return await makeApiRequest('POST', '/trx-token/generate', bodyData, undefined, secretId);
+        }
+        catch (error) {
+            // Formato estándar del protocolo MCP para errores
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            statusCode: 500,
+                            data: null,
+                            message: error instanceof Error ? error.message : 'Error desconocido',
+                            error: 'HANDLER_ERROR'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+const trx_token_generate_3InputJsonSchema = {
+    "type": "object",
+    "properties": {
+        "service": {
+            "type": "string",
+            "description": "Campo del body: service",
+            "default": "/cash-in/payment-method/token"
+        }
+    },
+    "required": []
+};
+const trx_token_generate_3InputShape = {
+    service: z.string().optional().describe("Campo del body: service")
+};
+const trx_token_generate_3InputValidator = z.object(trx_token_generate_3InputShape);
+// Herramienta: trx_token_generate_3
+export const trx_token_generate_3Tool = {
+    name: 'trx_token_generate_3',
+    description: "| **Name** | **Type** | **Description** |\\n| --- | --- | --- |\\n| **service** \\\\* | string | Value of the service to be consumed |\n\nContexto: Endpoint: POST /trx-token/generate | Trx token > Generate",
+    inputSchema: trx_token_generate_3InputShape,
+    jsonSchema: trx_token_generate_3InputJsonSchema,
+    endpoint: '/trx-token/generate',
+    method: 'POST',
+    parameters: [],
+    headers: [{ "key": "Authorization", "value": "Bearer {{tokenLogin}}", "type": "text" }],
+    handler: async (rawArgs) => {
+        try {
+            const normalizedArgs = rawArgs ?? {};
+            // Extraer secretId del contexto (si viene del HTTP mode)
+            const secretId = normalizedArgs._secretId;
+            // Remover _secretId de los args antes de validar
+            const { _secretId, ...argsToValidate } = normalizedArgs;
+            const validatedInput = validateToolInput(trx_token_generate_3InputValidator, argsToValidate);
+            const args = validatedInput;
+            const bodyData = {};
+            const serviceValue = args.service !== undefined ? args.service : "/cash-in/payment-method/token";
+            if (serviceValue !== undefined)
+                bodyData.service = serviceValue;
+            return await makeApiRequest('POST', '/trx-token/generate', bodyData, undefined, secretId);
+        }
+        catch (error) {
+            // Formato estándar del protocolo MCP para errores
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            statusCode: 500,
+                            data: null,
+                            message: error instanceof Error ? error.message : 'Error desconocido',
+                            error: 'HANDLER_ERROR'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+const trx_token_generate_4InputJsonSchema = {
+    "type": "object",
+    "properties": {
+        "service": {
+            "type": "string",
+            "description": "Campo del body: service",
+            "default": "/cash-out/generate/withdraw-method/token"
+        }
+    },
+    "required": []
+};
+const trx_token_generate_4InputShape = {
+    service: z.string().optional().describe("Campo del body: service")
+};
+const trx_token_generate_4InputValidator = z.object(trx_token_generate_4InputShape);
+// Herramienta: trx_token_generate_4
+export const trx_token_generate_4Tool = {
+    name: 'trx_token_generate_4',
+    description: "| **Name** | **Type** | **Description** |\\n| --- | --- | --- |\\n| **service** \\\\* | string | Value of the service to be consumed |\n\nContexto: Endpoint: POST /trx-token/generate | Trx token > Generate",
+    inputSchema: trx_token_generate_4InputShape,
+    jsonSchema: trx_token_generate_4InputJsonSchema,
+    endpoint: '/trx-token/generate',
+    method: 'POST',
+    parameters: [],
+    headers: [{ "key": "Authorization", "value": "Bearer {{tokenLogin}}", "type": "text" }],
+    handler: async (rawArgs) => {
+        try {
+            const normalizedArgs = rawArgs ?? {};
+            // Extraer secretId del contexto (si viene del HTTP mode)
+            const secretId = normalizedArgs._secretId;
+            // Remover _secretId de los args antes de validar
+            const { _secretId, ...argsToValidate } = normalizedArgs;
+            const validatedInput = validateToolInput(trx_token_generate_4InputValidator, argsToValidate);
+            const args = validatedInput;
+            const bodyData = {};
+            const serviceValue = args.service !== undefined ? args.service : "/cash-out/generate/withdraw-method/token";
+            if (serviceValue !== undefined)
+                bodyData.service = serviceValue;
+            return await makeApiRequest('POST', '/trx-token/generate', bodyData, undefined, secretId);
+        }
+        catch (error) {
+            // Formato estándar del protocolo MCP para errores
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            statusCode: 500,
+                            data: null,
+                            message: error instanceof Error ? error.message : 'Error desconocido',
+                            error: 'HANDLER_ERROR'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+const trx_token_generate_5InputJsonSchema = {
+    "type": "object",
+    "properties": {
+        "service": {
+            "type": "string",
+            "description": "Campo del body: service",
+            "default": "/merchant-key/create"
+        }
+    },
+    "required": []
+};
+const trx_token_generate_5InputShape = {
+    service: z.string().optional().describe("Campo del body: service")
+};
+const trx_token_generate_5InputValidator = z.object(trx_token_generate_5InputShape);
+// Herramienta: trx_token_generate_5
+export const trx_token_generate_5Tool = {
+    name: 'trx_token_generate_5',
+    description: "| **Name** | **Type** | **Description** |\\n| --- | --- | --- |\\n| **service** \\\\* | string | Value of the service to be consumed |\n\nContexto: Endpoint: POST /trx-token/generate | Trx token > Generate",
+    inputSchema: trx_token_generate_5InputShape,
+    jsonSchema: trx_token_generate_5InputJsonSchema,
+    endpoint: '/trx-token/generate',
+    method: 'POST',
+    parameters: [],
+    headers: [{ "key": "Authorization", "value": "Bearer {{tokenLogin}}", "type": "text" }],
+    handler: async (rawArgs) => {
+        try {
+            const normalizedArgs = rawArgs ?? {};
+            // Extraer secretId del contexto (si viene del HTTP mode)
+            const secretId = normalizedArgs._secretId;
+            // Remover _secretId de los args antes de validar
+            const { _secretId, ...argsToValidate } = normalizedArgs;
+            const validatedInput = validateToolInput(trx_token_generate_5InputValidator, argsToValidate);
+            const args = validatedInput;
+            const bodyData = {};
+            const serviceValue = args.service !== undefined ? args.service : "/merchant-key/create";
+            if (serviceValue !== undefined)
+                bodyData.service = serviceValue;
+            return await makeApiRequest('POST', '/trx-token/generate', bodyData, undefined, secretId);
+        }
+        catch (error) {
+            // Formato estándar del protocolo MCP para errores
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            statusCode: 500,
+                            data: null,
+                            message: error instanceof Error ? error.message : 'Error desconocido',
+                            error: 'HANDLER_ERROR'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+const trx_token_generate_6InputJsonSchema = {
+    "type": "object",
+    "properties": {
+        "service": {
+            "type": "string",
+            "description": "Campo del body: service",
+            "default": "/merchant-key/cancel"
+        }
+    },
+    "required": []
+};
+const trx_token_generate_6InputShape = {
+    service: z.string().optional().describe("Campo del body: service")
+};
+const trx_token_generate_6InputValidator = z.object(trx_token_generate_6InputShape);
+// Herramienta: trx_token_generate_6
+export const trx_token_generate_6Tool = {
+    name: 'trx_token_generate_6',
+    description: "| **Name** | **Type** | **Description** |\\n| --- | --- | --- |\\n| **service** \\\\* | string | Value of the service to be consumed |\n\nContexto: Endpoint: POST /trx-token/generate | Trx token > Generate",
+    inputSchema: trx_token_generate_6InputShape,
+    jsonSchema: trx_token_generate_6InputJsonSchema,
+    endpoint: '/trx-token/generate',
+    method: 'POST',
+    parameters: [],
+    headers: [{ "key": "Authorization", "value": "Bearer {{tokenLogin}}", "type": "text" }],
+    handler: async (rawArgs) => {
+        try {
+            const normalizedArgs = rawArgs ?? {};
+            // Extraer secretId del contexto (si viene del HTTP mode)
+            const secretId = normalizedArgs._secretId;
+            // Remover _secretId de los args antes de validar
+            const { _secretId, ...argsToValidate } = normalizedArgs;
+            const validatedInput = validateToolInput(trx_token_generate_6InputValidator, argsToValidate);
+            const args = validatedInput;
+            const bodyData = {};
+            const serviceValue = args.service !== undefined ? args.service : "/merchant-key/cancel";
+            if (serviceValue !== undefined)
+                bodyData.service = serviceValue;
+            return await makeApiRequest('POST', '/trx-token/generate', bodyData, undefined, secretId);
+        }
+        catch (error) {
+            // Formato estándar del protocolo MCP para errores
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            statusCode: 500,
+                            data: null,
+                            message: error instanceof Error ? error.message : 'Error desconocido',
+                            error: 'HANDLER_ERROR'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+const cash_in_generate_payment_link_tokenInputJsonSchema = {
+    "type": "object",
+    "properties": {
+        "expiresIn": {
+            "type": "number",
+            "description": "Campo del body: expiresIn",
+            "default": 12360
+        },
+        "amount": {
+            "type": "number",
+            "description": "Campo del body: amount",
+            "default": 2000
+        },
+        "brandId": {
+            "type": "number",
+            "description": "Campo del body: brandId",
+            "default": 117
+        },
+        "webhookUrl": {
+            "type": "string",
+            "description": "Campo del body: webhookUrl",
+            "default": "https://webhook.site/8965aa0a-e3e7-4092-aa7d-6c44bf63f7a8"
+        },
+        "userMetadata": {
+            "type": "object",
+            "description": "Campo del body: userMetadata",
+            "default": {
+                "ip": "1.2.3.2",
+                "identifier": "123467hyujikolpñmnaafsddssd",
+                "urlCommerce": "https://url-tucomercio.com"
+            }
+        },
+        "returnUrl": {
+            "type": "string",
+            "description": "Campo del body: returnUrl",
+            "default": "https://www.google.com"
+        },
+        "reference1": {
+            "type": "string",
+            "description": "Campo del body: reference1",
+            "default": "Ref01350"
+        },
+        "reference2": {
+            "type": "object",
+            "description": "Campo del body: reference2",
+            "default": {
+                "Label": {
+                    "Name": "Juanita Perez",
+                    "Email": "pqacLO87V77DgF62P8PXENA==do",
+                    "CellPhone": "1VM6daPPJcXCD4Cw93272oQ==8",
+                    "Type Person": "NATURAL",
+                    "Type Document": "CEDULA",
+                    "DocumentNumber": 79706920,
+                    "Nodo": 47474
+                },
+                "Data": {
+                    "Typedoc": "cedula",
+                    "docnum": "1088307172"
+                }
+            }
+        }
+    },
+    "required": []
+};
+const cash_in_generate_payment_link_tokenInputShape = {
+    expiresIn: z.number().optional().describe("Campo del body: expiresIn"),
+    amount: z.number().optional().describe("Campo del body: amount"),
+    brandId: z.number().optional().describe("Campo del body: brandId"),
+    webhookUrl: z.string().optional().describe("Campo del body: webhookUrl"),
+    userMetadata: z.record(z.any()).optional().describe("Campo del body: userMetadata"),
+    returnUrl: z.string().optional().describe("Campo del body: returnUrl"),
+    reference1: z.string().optional().describe("Campo del body: reference1"),
+    reference2: z.record(z.any()).optional().describe("Campo del body: reference2")
+};
+const cash_in_generate_payment_link_tokenInputValidator = z.object(cash_in_generate_payment_link_tokenInputShape);
+// Herramienta: cash_in_generate_payment_link_token
+export const cash_in_generate_payment_link_tokenTool = {
+    name: 'cash_in_generate_payment_link_token',
+    description: "## 📥 Request Body Parameters\\n\\n| **Field** | **Type** | **Required** | **Description** |\\n| --- | --- | --- | --- |\\n| \\`amount\\` | number | ✅ | Value of the payment. |\\n| \\`brandId\\` | number | ❌ | ID of the customer\\'s white label; if one is not available, the default ID 79 is sent. |\\n| \\`expiresIn\\` | number | ❌ | Time in minutes for the expiration of the resource or payment link. |\\n| \\`reference1\\` | string | ✅ | Customer identifier, must be between 1 and 30 characters. |\\n| \\`reference2\\` | object | ❌ | Object for additional information. |\\n| \\`reference2.Commerce\\` | object | ❌ | Object for information related to the store or commerce. |\\n| \\`reference2.Data\\` | object | ❌ | Object for information related to the conciliation of the transaction. |\\n| \\`reference2.Label\\` | object | ❌ | Object to send information to be displayed in the payment summary. |\\n| \\`returnUrl\\` | string | ❌ | Link that the customer will see when clicking on the back to commerce button. |\\n| \\`showSummary\\` | boolean | ❌ | Indicates whether the RefácilPay payment summary will be shown or not (false: do not show, true: show). Default: true. |\\n| \\`userMetadata\\` | object | ✅ | Object containing key details about the user or merchant generating the payment resource. |\\n| \\`userMetadata.identifier\\` | string | ✅ | Unique identifier of the user or merchant generating the payment resource (max 36 characters). |\\n| \\`userMetadata.ip\\` | string | ✅ | IP address associated with the user\\'s identifier. Must be a valid IP address. |\\n| \\`userMetadata.urlCommerce\\` | string | ✅ | URL that identifies the commerce. Must follow valid URL structure with http:// or https:// protocol. Maximum length: 500 characters. |\\n| \\`webhookUrl\\` | string | ✅ | URL of the client\\'s webhook to receive real-time payment status updates. |\\n\n\nContexto: Endpoint: POST /cash-in/generate/payment-link/token | Cash in > Generate > Payment link > Token",
+    inputSchema: cash_in_generate_payment_link_tokenInputShape,
+    jsonSchema: cash_in_generate_payment_link_tokenInputJsonSchema,
+    endpoint: '/cash-in/generate/payment-link/token',
+    method: 'POST',
+    parameters: [],
+    headers: [{ "key": "Content-Type", "value": "application/json" }, { "key": "x-transaction-token", "value": "{{transactionalToken}}" }, { "key": "Authorization", "value": "Bearer {{tokenLogin}}" }],
+    handler: async (rawArgs) => {
+        try {
+            const normalizedArgs = rawArgs ?? {};
+            // Extraer secretId del contexto (si viene del HTTP mode)
+            const secretId = normalizedArgs._secretId;
+            // Remover _secretId de los args antes de validar
+            const { _secretId, ...argsToValidate } = normalizedArgs;
+            const validatedInput = validateToolInput(cash_in_generate_payment_link_tokenInputValidator, argsToValidate);
+            const args = validatedInput;
+            const bodyData = {};
+            const expiresInValue = args.expiresIn !== undefined ? args.expiresIn : 12360;
+            if (expiresInValue !== undefined)
+                bodyData.expiresIn = expiresInValue;
+            const amountValue = args.amount !== undefined ? args.amount : 2000;
+            if (amountValue !== undefined)
+                bodyData.amount = amountValue;
+            const brandIdValue = args.brandId !== undefined ? args.brandId : 117;
+            if (brandIdValue !== undefined)
+                bodyData.brandId = brandIdValue;
+            const webhookUrlValue = args.webhookUrl !== undefined ? args.webhookUrl : "https://webhook.site/8965aa0a-e3e7-4092-aa7d-6c44bf63f7a8";
+            if (webhookUrlValue !== undefined)
+                bodyData.webhookUrl = webhookUrlValue;
+            const userMetadataValue = args.userMetadata !== undefined ? args.userMetadata : { "ip": "1.2.3.2", "identifier": "123467hyujikolpñmnaafsddssd", "urlCommerce": "https://url-tucomercio.com" };
+            if (userMetadataValue !== undefined)
+                bodyData.userMetadata = userMetadataValue;
+            const returnUrlValue = args.returnUrl !== undefined ? args.returnUrl : "https://www.google.com";
+            if (returnUrlValue !== undefined)
+                bodyData.returnUrl = returnUrlValue;
+            const reference1Value = args.reference1 !== undefined ? args.reference1 : "Ref01350";
+            if (reference1Value !== undefined)
+                bodyData.reference1 = reference1Value;
+            const reference2Value = args.reference2 !== undefined ? args.reference2 : { "Label": { "Name": "Juanita Perez", "Email": "pqacLO87V77DgF62P8PXENA==do", "CellPhone": "1VM6daPPJcXCD4Cw93272oQ==8", "Type Person": "NATURAL", "Type Document": "CEDULA", "DocumentNumber": 79706920, "Nodo": 47474 }, "Data": { "Typedoc": "cedula", "docnum": "1088307172" } };
+            if (reference2Value !== undefined)
+                bodyData.reference2 = reference2Value;
+            return await makeApiRequest('POST', '/cash-in/generate/payment-link/token', bodyData, undefined, secretId);
+        }
+        catch (error) {
+            // Formato estándar del protocolo MCP para errores
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            statusCode: 500,
+                            data: null,
+                            message: error instanceof Error ? error.message : 'Error desconocido',
+                            error: 'HANDLER_ERROR'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+const cash_in_generate_payment_method_tokenInputJsonSchema = {
+    "type": "object",
+    "properties": {
+        "expiresIn": {
+            "type": "number",
+            "description": "Campo del body: expiresIn",
+            "default": 0
+        },
+        "paymentMethod": {
+            "type": "object",
+            "description": "Campo del body: paymentMethod",
+            "default": {
+                "id": 155,
+                "cellphone": "3051000002"
+            }
+        },
+        "userMetadata": {
+            "type": "object",
+            "description": "Campo del body: userMetadata",
+            "default": {
+                "ip": "1.2.3.2",
+                "identifier": "123467hyujikolpñmnaafsddssd",
+                "urlCommerce": "https://url-tucomercio.com"
+            }
+        },
+        "amount": {
+            "type": "number",
+            "description": "Campo del body: amount",
+            "default": 10000
+        },
+        "brandId": {
+            "type": "number",
+            "description": "Campo del body: brandId",
+            "default": 1
+        },
+        "webhookUrl": {
+            "type": "string",
+            "description": "Campo del body: webhookUrl",
+            "default": "https://webhook.site/271888cd-bd07-469a-88a8-e0ed7e93c368"
+        },
+        "returnUrl": {
+            "type": "string",
+            "description": "Campo del body: returnUrl",
+            "default": "https://www.google.com/?hl=es"
+        },
+        "showSummary": {
+            "type": "boolean",
+            "description": "Campo del body: showSummary",
+            "default": true
+        },
+        "reference1": {
+            "type": "string",
+            "description": "Campo del body: reference1",
+            "default": "EGfbOsiYQspMpgDD"
+        },
+        "reference2": {
+            "type": "object",
+            "description": "Campo del body: reference2",
+            "default": {
+                "Label": {
+                    "Campos": "string"
+                }
+            }
+        }
+    },
+    "required": []
+};
+const cash_in_generate_payment_method_tokenInputShape = {
+    expiresIn: z.number().optional().describe("Campo del body: expiresIn"),
+    paymentMethod: z.record(z.any()).optional().describe("Campo del body: paymentMethod"),
+    userMetadata: z.record(z.any()).optional().describe("Campo del body: userMetadata"),
+    amount: z.number().optional().describe("Campo del body: amount"),
+    brandId: z.number().optional().describe("Campo del body: brandId"),
+    webhookUrl: z.string().optional().describe("Campo del body: webhookUrl"),
+    returnUrl: z.string().optional().describe("Campo del body: returnUrl"),
+    showSummary: z.boolean().optional().describe("Campo del body: showSummary"),
+    reference1: z.string().optional().describe("Campo del body: reference1"),
+    reference2: z.record(z.any()).optional().describe("Campo del body: reference2")
+};
+const cash_in_generate_payment_method_tokenInputValidator = z.object(cash_in_generate_payment_method_tokenInputShape);
+// Herramienta: cash_in_generate_payment_method_token
+export const cash_in_generate_payment_method_tokenTool = {
+    name: 'cash_in_generate_payment_method_token',
+    description: "This endpoint allows you to **generate payment requests** through the available _cash-in_ methods.\\n\\n---\\n\\n### 💡 Overview\\n\\nThe table below lists the available payment methods along with their corresponding IDs and **minimum expiration times** (\\`expiresIn\\`) required when creating a payment request.\\n\\n| **Method ID** | **Description** | **Minimum Expiration (seconds)** |\\n| --- | --- | --- |\\n| \\`130\\` | Cash-in via **Nequi** | 43,200 |\\n| \\`131\\` | Cash-in via **Daviplata** | 43,200 |\\n| \\`133\\` | Cash-in via **PSE** | 1,800 |\\n| \\`262\\` | Cash-in via **PSE Gateway** | 1,800 |\\n| \\`134\\` | Cash-in via **IPay** | 43,200 |\\n| \\`153\\` | Cash-in via **Recaudo Efectivo** | 86,400 |\\n| \\`155\\` | Cash-in via **Transfiya Recaudo** | 43,200 |\\n| \\`163\\` | Cash-in via **TPaga** | 43,200 |\\n| \\`248\\` | Cash-in via **QR Interoperable** | N/A |\\n\\n> ⚠ **Important:**  \\nThe value provided in the \\`expiresIn\\` field **must be greater than or equal** to the minimum expiration defined for the selected payment method. \\n  \\n\\n---\\n\\n## 🧩 Payment Method Details\\n\\nEach payment method requires a specific object structure within the \\`\\\"paymentMethod\\\"\\` field.\\n\\n---\\n\\n### **Nequi**\\n\\n\\`\\`\\` json\\n\\\"paymentMethod\\\": {\\n  \\\"id\\\": 130,\\n  \\\"cellphone\\\": \\\"3105293225\\\"\\n}\\n\\n \\`\\`\\`\\n\\n---\\n\\n### **Daviplata**\\n\\n\\`\\`\\` json\\n\\\"paymentMethod\\\": {\\n  \\\"id\\\": 131,\\n  \\\"cellphone\\\": \\\"3208385715\\\"\\n}\\n\\n \\`\\`\\`\\n\\n---\\n\\n### **PSE**\\n\\nFor this payment method, depending on the \\`typePerson\\` selected, only specific document types are accepted:\\n\\n- **\\`typePerson\\`****:** **\\`\\\"0\\\"\\`** → corresponds to a **Natural Person** and only accepts the following values for \\`documentType\\`:\\n    \\n    - \\`RCN\\`\\n        \\n    - \\`TI\\`\\n        \\n    - \\`CC\\`\\n        \\n    - \\`TE\\`\\n        \\n    - \\`CE\\`\\n        \\n    - \\`PA\\`\\n        \\n    - \\`DIE\\`\\n        \\n- **\\`typePerson\\`****:** **\\`\\\"1\\\"\\`** → corresponds to a **Legal Person** and only accepts the following value for \\`documentType\\`:\\n    \\n    - \\`NIT\\`\\n        \\n\\n\\`\\`\\` json\\n\\\"paymentMethod\\\": {\\n  \\\"id\\\": 133,\\n  \\\"documentType\\\": \\\"CC\\\",\\n  \\\"typePerson\\\": \\\"0\\\",\\n  \\\"bankId\\\": \\\"string\\\",\\n  \\\"documentNumber\\\": \\\"string\\\",\\n  \\\"name\\\": \\\"string\\\",\\n  \\\"cellphone\\\": \\\"string\\\",\\n  \\\"address\\\": \\\"string\\\",\\n  \\\"email\\\": \\\"string\\\"\\n}\\n\\n \\`\\`\\`\\n\\n---\\n\\n### **PSE Gateway**\\n\\nThis payment method enables direct integration with the PSE network for processing online bank payments.  \\nTo consume this product, it is required to have the following parameters previously configured and associated with your product:\\n\\n- \\`entity_code\\`\\n    \\n- \\`service_code\\`\\n    \\n- \\`company_ciiu\\`\\n    \\n- \\`company_name\\`\\n    \\n\\nThese parameters identify your company within the PSE network and are necessary for successful transaction routing and validation.\\n\\n> 💬 **For more information or to request these credentials, please contact the support team.** \\n  \\n\\nThis method follows **the same structure and validation rules** as **PSE**, but must use the following identifier:\\n\\n\\`\\`\\` json\\n\\\"paymentMethod\\\": {\\n  \\\"id\\\": 262,\\n  \\\"documentType\\\": \\\"CC\\\",\\n  \\\"typePerson\\\": \\\"0\\\",\\n  \\\"bankId\\\": \\\"string\\\",\\n  \\\"documentNumber\\\": \\\"string\\\",\\n  \\\"name\\\": \\\"string\\\",\\n  \\\"cellphone\\\": \\\"string\\\",\\n  \\\"address\\\": \\\"string\\\",\\n  \\\"email\\\": \\\"string\\\"\\n}\\n\\n \\`\\`\\`\\n\\nThe **PSE integration** relies heavily on the correct configuration of the \\`showSummary\\` and \\`returnUrl\\` parameters.  \\nThese parameters control the **user experience** and the **finalization flow** of the payment process.\\n\\n| Scenario | \\`showSummary\\` | \\`returnUrl\\` | Flow Description |\\n| --- | --- | --- | --- |\\n| **1\\\\. Standard Redirect (Default)** | \\`true\\` or not sent | ✅ Present | Displays a transaction summary screen with key payment details and retrieves the final transaction status. After the payment is completed, the user is redirected to the specified \\`returnUrl\\`. |\\n| **2\\\\. Without Transaction Summary Screen** | \\`false\\` | ✅ Present | Skips the transaction summary screen and redirects the user directly to the \\`returnUrl\\`. In this case, the merchant’s system must display the transaction summary on the destination page. |\\n\\n> ⚠️ **Note:**  \\nFor **PSE** and **PSE Gateway**, it is **strongly recommended** to use \\`showSummary: true\\` along with a valid \\`returnUrl\\` to ensure a seamless customer experience and accurate transaction tracking. \\n  \\n> 🔗 **See also:** \\n  \\n\\n- [Transaction Summary](https://documenter.getpostman.com/view/35146358/2sA3QpDEFA#45e0d76a-fabd-442e-9b17-e2f6b8354ec5)\\n    \\n- [Transaction Status](https://documenter.getpostman.com/view/35146358/2sA3QpDEFA#dd3ba9f5-1f10-4109-b59d-6e5aad5e3799)\\n    \\n\\n---\\n\\n### **IPay**\\n\\n\\`\\`\\` json\\n\\\"paymentMethod\\\": {\\n  \\\"id\\\": 134\\n}\\n\\n \\`\\`\\`\\n\\n---\\n\\n### **Recaudo Efectivo**\\n\\n\\`\\`\\` json\\n\\\"paymentMethod\\\": {\\n  \\\"id\\\": 153\\n}\\n\\n \\`\\`\\`\\n\\n---\\n\\n### **Transfiya Recaudo**\\n\\n\\`\\`\\` json\\n\\\"paymentMethod\\\": {\\n  \\\"id\\\": 155,\\n  \\\"cellphone\\\": \\\"3105293225\\\"\\n}\\n\\n \\`\\`\\`\\n\\n---\\n\\n### **TPaga**\\n\\nThis payment method supports an optional parameter called \\`isQr\\`, which determines the type of resource returned in the \\`url\\` field:\\n\\n| **Value** | **Description** |\\n| --- | --- |\\n| \\`true\\` | The \\`url\\` field returns a link to a **QR code** displaying transaction details. |\\n| \\`false\\` | The \\`url\\` field returns a **deeplink** to open directly in the TPAGA wallet app. |\\n\\n> 🧠 **Behavior:**  \\nIf \\`isQr\\` is not provided, the default behavior is equivalent to \\`isQr: false\\`.  \\nTransactions can only be completed **from a mobile device**.  \\nIf the request is made from a desktop or tablet, it is recommended to send \\`isQr: true\\` so the user can scan the QR from a mobile device. \\n  \\n\\n\\`\\`\\` json\\n\\\"paymentMethod\\\": {\\n  \\\"id\\\": 163,\\n  \\\"isQr\\\": false\\n}\\n\\n \\`\\`\\`\\n\\n---\\n\\n### **QR Interoperable**\\n\\nFor this method, the following fields are **optional**:\\n\\n- \\`cellphone\\`\\n    \\n- \\`documentNumber\\`\\n    \\n- \\`documentType\\`\\n    \\n- \\`merchantId\\`\\n    \\n\\nThe service can function using only the payment method ID; however, providing these optional fields can **improve response time**.  \\nYou may retrieve this data through the \\`enrollment-data\\` service in the [Merchant Enrollment](https://documenter.getpostman.com/view/35146358/2sA3QpDEFA#8c9f5a18-a19a-4b8f-baba-cd7501aa29a0) section.\\n\\n> ⚠ **Prerequisite:**  \\nThe merchant must complete the **Merchant Enrollment** process before using this method.  \\nSee the _Merchant Enrollment_ section for setup details. \\n  \\n> 🔁 **Open Resource:**  \\nThe **QR Interoperable** operates as an _open resource_, meaning the generated QR can be used multiple times by the same user. \\n  \\n> ⚙️ **Technical Note — Dynamic QR Behavior:**  \\nDynamic QR codes may be scanned multiple times due to current limitations in the Redeban system.  \\nThis is **not** an error in our platform. \\n  \\n\\n#### Behavior Details\\n\\n- Redeban does not automatically invalidate a dynamic QR after its first scan.\\n    \\n- As a result, the same QR may generate multiple transaction records.\\n    \\n\\n#### Recommendations\\n\\n- Implement **application-level validation** to detect multiple payments from the same QR code.\\n    \\n- Monitor dynamic QR transactions and confirm status before marking payments as completed.\\n    \\n- Inform end-users to verify the success of a transaction before rescanning.\\n    \\n\\n#### Future Considerations\\n\\n- Redeban is evaluating support for **single-use dynamic QR control**.\\n    \\n- Stay updated with interoperability provider announcements to adjust integrations accordingly.\\n    \\n\\n\\`\\`\\` json\\n\\\"paymentMethod\\\": {\\n  \\\"id\\\": 248,\\n  \\\"cellphone\\\": \\\"string\\\",\\n  \\\"documentType\\\": \\\"string\\\",\\n  \\\"documentNumber\\\": \\\"string\\\",\\n  \\\"merchantId\\\": \\\"string\\\"\\n}\\n\\n \\`\\`\\`\\n\\n---\\n\\n## 📥 Request Body Parameters\\n\\n| **Field** | **Type** | **Required** | **Description** |\\n| --- | --- | --- | --- |\\n| \\`amount\\` | number | ✅ | Value of the payment. |\\n| \\`brandId\\` | number | ❌ | ID of the customer\\'s white label; if one is not available, the default ID 79 is sent. |\\n| \\`expiresIn\\` | number | ❌ | Time in seconds for the expiration of the resource or payment link. |\\n| \\`paymentMethod\\` | object | ✅ | Object specifying the payment method and its details. |\\n| \\`paymentMethod.id\\` | number | ✅ | ID of the selected payment method (see available payment methods). |\\n| \\`reference1\\` | string | ✅ | Customer identifier, must be between 1 and 30 characters. |\\n| \\`reference2\\` | object | ❌ | Object for additional information. |\\n| \\`reference2.Commerce\\` | object | ❌ | Object for information related to the store or commerce. |\\n| \\`reference2.Data\\` | object | ❌ | Object for information related to the conciliation of the transaction. |\\n| \\`reference2.Label\\` | object | ❌ | Object to send information to be displayed in the payment summary. |\\n| \\`returnUrl\\` | string | ❌ | Link that the customer will see when clicking on the back to commerce button. |\\n| \\`showSummary\\` | boolean | ❌ | Indicates whether the RefácilPay payment summary will be shown or not (false: do not show, true: show). Default: true. |\\n| \\`userMetadata\\` | object | ✅ | Object containing key details about the user or merchant generating the payment resource. |\\n| \\`userMetadata.identifier\\` | string | ✅ | Unique identifier of the user or merchant generating the payment resource (max 36 characters). |\\n| \\`userMetadata.ip\\` | string | ✅ | IP address associated with the user\\'s identifier. Must be a valid IP address. |\\n| \\`userMetadata.urlCommerce\\` | string | ✅ | URL that identifies the commerce. Must follow valid URL structure with http:// or https:// protocol. Maximum length: 500 characters. |\\n| \\`webhookUrl\\` | string | ✅ | URL of the client\\'s webhook to receive real-time payment status updates. |\n\nContexto: Endpoint: POST /cash-in/generate/payment-method/token | Cash in > Generate > Payment method > Token",
+    inputSchema: cash_in_generate_payment_method_tokenInputShape,
+    jsonSchema: cash_in_generate_payment_method_tokenInputJsonSchema,
+    endpoint: '/cash-in/generate/payment-method/token',
+    method: 'POST',
+    parameters: [],
+    headers: [{ "key": "Content-Type", "value": "application/json" }, { "key": "x-transaction-token", "value": "{{transactionalToken}}" }, { "key": "Authorization", "value": "Bearer {{tokenLogin}}" }],
+    handler: async (rawArgs) => {
+        try {
+            const normalizedArgs = rawArgs ?? {};
+            // Extraer secretId del contexto (si viene del HTTP mode)
+            const secretId = normalizedArgs._secretId;
+            // Remover _secretId de los args antes de validar
+            const { _secretId, ...argsToValidate } = normalizedArgs;
+            const validatedInput = validateToolInput(cash_in_generate_payment_method_tokenInputValidator, argsToValidate);
+            const args = validatedInput;
+            const bodyData = {};
+            const expiresInValue = args.expiresIn !== undefined ? args.expiresIn : 0;
+            if (expiresInValue !== undefined)
+                bodyData.expiresIn = expiresInValue;
+            const paymentMethodValue = args.paymentMethod !== undefined ? args.paymentMethod : { "id": 155, "cellphone": "3051000002" };
+            if (paymentMethodValue !== undefined)
+                bodyData.paymentMethod = paymentMethodValue;
+            const userMetadataValue = args.userMetadata !== undefined ? args.userMetadata : { "ip": "1.2.3.2", "identifier": "123467hyujikolpñmnaafsddssd", "urlCommerce": "https://url-tucomercio.com" };
+            if (userMetadataValue !== undefined)
+                bodyData.userMetadata = userMetadataValue;
+            const amountValue = args.amount !== undefined ? args.amount : 10000;
+            if (amountValue !== undefined)
+                bodyData.amount = amountValue;
+            const brandIdValue = args.brandId !== undefined ? args.brandId : 1;
+            if (brandIdValue !== undefined)
+                bodyData.brandId = brandIdValue;
+            const webhookUrlValue = args.webhookUrl !== undefined ? args.webhookUrl : "https://webhook.site/271888cd-bd07-469a-88a8-e0ed7e93c368";
+            if (webhookUrlValue !== undefined)
+                bodyData.webhookUrl = webhookUrlValue;
+            const returnUrlValue = args.returnUrl !== undefined ? args.returnUrl : "https://www.google.com/?hl=es";
+            if (returnUrlValue !== undefined)
+                bodyData.returnUrl = returnUrlValue;
+            const showSummaryValue = args.showSummary !== undefined ? args.showSummary : true;
+            if (showSummaryValue !== undefined)
+                bodyData.showSummary = showSummaryValue;
+            const reference1Value = args.reference1 !== undefined ? args.reference1 : "EGfbOsiYQspMpgDD";
+            if (reference1Value !== undefined)
+                bodyData.reference1 = reference1Value;
+            const reference2Value = args.reference2 !== undefined ? args.reference2 : { "Label": { "Campos": "string" } };
+            if (reference2Value !== undefined)
+                bodyData.reference2 = reference2Value;
+            return await makeApiRequest('POST', '/cash-in/generate/payment-method/token', bodyData, undefined, secretId);
+        }
+        catch (error) {
+            // Formato estándar del protocolo MCP para errores
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            statusCode: 500,
+                            data: null,
+                            message: error instanceof Error ? error.message : 'Error desconocido',
+                            error: 'HANDLER_ERROR'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+const cash_out_generate_withdraw_method_tokenInputJsonSchema = {
+    "type": "object",
+    "properties": {
+        "amount": {
+            "type": "number",
+            "description": "Campo del body: amount",
+            "default": 1000
+        },
+        "reference1": {
+            "type": "string",
+            "description": "Campo del body: reference1",
+            "default": "EGfbOsiYQspMpgBd"
+        },
+        "bankName": {
+            "type": "string",
+            "description": "Campo del body: bankName",
+            "default": "Banco Rojo"
+        },
+        "webhookRequest": {
+            "type": "string",
+            "description": "Campo del body: webhookRequest",
+            "default": "https://****gerstg.azure-api.net/SkCo.PagosEnLinea.API/payonline/PostStatus"
+        },
+        "withdrawMethod": {
+            "type": "object",
+            "description": "Campo del body: withdrawMethod",
+            "default": {
+                "id": 245,
+                "cellphone": "3125763074"
+            }
+        },
+        "userMetadata": {
+            "type": "object",
+            "description": "Campo del body: userMetadata",
+            "default": {
+                "identifier": "1234567890",
+                "ip": "127.0.0.1",
+                "urlCommerce": "https://url-tucomercio.com"
+            }
+        }
+    },
+    "required": []
+};
+const cash_out_generate_withdraw_method_tokenInputShape = {
+    amount: z.number().optional().describe("Campo del body: amount"),
+    reference1: z.string().optional().describe("Campo del body: reference1"),
+    bankName: z.string().optional().describe("Campo del body: bankName"),
+    webhookRequest: z.string().optional().describe("Campo del body: webhookRequest"),
+    withdrawMethod: z.record(z.any()).optional().describe("Campo del body: withdrawMethod"),
+    userMetadata: z.record(z.any()).optional().describe("Campo del body: userMetadata")
+};
+const cash_out_generate_withdraw_method_tokenInputValidator = z.object(cash_out_generate_withdraw_method_tokenInputShape);
+// Herramienta: cash_out_generate_withdraw_method_token
+export const cash_out_generate_withdraw_method_tokenTool = {
+    name: 'cash_out_generate_withdraw_method_token',
+    description: "This endpoint allows you to **generate withdrawal (cash-out) requests** through the available payout methods.\\n\\n---\\n\\n### 💡 Overview\\n\\nThe table below lists the available payout methods along with their corresponding IDs and brief descriptions.\\n\\n| **Method ID** | **Description** |\\n| --- | --- |\\n| \\`245\\` | Cash-out via **Transfiya** |\\n| \\`264\\` | Cash-out via **Bre-B** |\\n\\n> ⚠ **Note:**  \\nEach withdrawal method requires a specific object structure within the \\`\\\"withdrawMethod\\\"\\` field, as shown below. \\n  \\n\\n---\\n\\n## 🧩 Payout Method Details\\n\\n### **Transfiya**\\n\\n\\`\\`\\` json\\n\\\"withdrawMethod\\\": {\\n  \\\"id\\\": 245,\\n  \\\"cellphone\\\": \\\"3125763074\\\"\\n}\\n\\n \\`\\`\\`\\n\\n**Description:**  \\nTransfers funds to a recipient using their registered Transfiya cellphone number.\\n\\n> ⚠ **Important:**  \\nEnsure the cellphone number is registered with Transfiya and capable of receiving funds. \\n  \\n\\n---\\n\\n### **Bre-B**\\n\\n\\`\\`\\` json\\n\\\"withdrawMethod\\\": {\\n  \\\"id\\\": 264,\\n  \\\"key\\\": \\\"@REPRUEBAL7717\\\"\\n}\\n\\n \\`\\`\\`\\n\\n**Description:**  \\nTransfers funds directly to a Bre-B account using the beneficiary’s unique Bre-B key.\\n\\n> 💡 **Tip:**  \\nThe \\`key\\` field must contain a valid Bre-B account alias in the format \\`@USERNAME\\`. \\n  \\n\\n---\\n\\n## 📥 Request Body Parameters\\n\\n| **Field** | **Type** | **Required** | **Description** |\\n| --- | --- | --- | --- |\\n| \\`amount\\` | number | ✅ | Amount to be withdrawn. |\\n| \\`reference1\\` | string | ✅ | Unique transaction reference generated by the client (max 20 characters). |\\n| \\`webhookRequest\\` | string | ✅ | Customer’s webhook URL to receive real-time withdrawal status updates. |\\n| \\`userMetadata\\` | object | ✅ | Object containing metadata related to the origin of the transaction. |\\n| \\`userMetadata.identifier\\` | string | ✅ | Identifier for the user or merchant initiating the transaction. |\\n| \\`userMetadata.ip\\` | string | ✅ | IP address from which the transaction was initiated. |\\n| \\`userMetadata.urlCommerce\\` | string | ✅ | Commerce or customer’s URL associated with the transaction. |\\n| \\`withdrawMethod\\` | object | ✅ | Object specifying the withdrawal method and destination details. |\\n| \\`withdrawMethod.id\\` | number | ✅ | ID of the selected payout method (see table above). |\\n| \\`withdrawMethod.cellphone\\` | string | Conditional | Required for **Transfiya** withdrawals. |\\n| \\`withdrawMethod.key\\` | string | Conditional | Required for **Bre-B** withdrawals. |\\n| \\`withdrawMethod.bankName\\` | string | ❌ | Optional bank name, if applicable for future payout methods. |\\n\\n---\n\nContexto: Endpoint: POST /cash-out/generate/withdraw-method/token | Cash out > Generate > Withdraw method > Token",
+    inputSchema: cash_out_generate_withdraw_method_tokenInputShape,
+    jsonSchema: cash_out_generate_withdraw_method_tokenInputJsonSchema,
+    endpoint: '/cash-out/generate/withdraw-method/token',
+    method: 'POST',
+    parameters: [],
+    headers: [{ "key": "Content-Type", "value": "application/json" }, { "key": "x-transaction-token", "value": "{{transactionalToken}}" }, { "key": "Authorization", "value": "Bearer {{tokenLogin}}" }],
+    handler: async (rawArgs) => {
+        try {
+            const normalizedArgs = rawArgs ?? {};
+            // Extraer secretId del contexto (si viene del HTTP mode)
+            const secretId = normalizedArgs._secretId;
+            // Remover _secretId de los args antes de validar
+            const { _secretId, ...argsToValidate } = normalizedArgs;
+            const validatedInput = validateToolInput(cash_out_generate_withdraw_method_tokenInputValidator, argsToValidate);
+            const args = validatedInput;
+            const bodyData = {};
+            const amountValue = args.amount !== undefined ? args.amount : 1000;
+            if (amountValue !== undefined)
+                bodyData.amount = amountValue;
+            const reference1Value = args.reference1 !== undefined ? args.reference1 : "EGfbOsiYQspMpgBd";
+            if (reference1Value !== undefined)
+                bodyData.reference1 = reference1Value;
+            const bankNameValue = args.bankName !== undefined ? args.bankName : "Banco Rojo";
+            if (bankNameValue !== undefined)
+                bodyData.bankName = bankNameValue;
+            const webhookRequestValue = args.webhookRequest !== undefined ? args.webhookRequest : "https://****gerstg.azure-api.net/SkCo.PagosEnLinea.API/payonline/PostStatus";
+            if (webhookRequestValue !== undefined)
+                bodyData.webhookRequest = webhookRequestValue;
+            const withdrawMethodValue = args.withdrawMethod !== undefined ? args.withdrawMethod : { "id": 245, "cellphone": "3125763074" };
+            if (withdrawMethodValue !== undefined)
+                bodyData.withdrawMethod = withdrawMethodValue;
+            const userMetadataValue = args.userMetadata !== undefined ? args.userMetadata : { "identifier": "1234567890", "ip": "127.0.0.1", "urlCommerce": "https://url-tucomercio.com" };
+            if (userMetadataValue !== undefined)
+                bodyData.userMetadata = userMetadataValue;
+            return await makeApiRequest('POST', '/cash-out/generate/withdraw-method/token', bodyData, undefined, secretId);
+        }
+        catch (error) {
+            // Formato estándar del protocolo MCP para errores
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            statusCode: 500,
+                            data: null,
+                            message: error instanceof Error ? error.message : 'Error desconocido',
+                            error: 'HANDLER_ERROR'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+const customer_getbalanceInputJsonSchema = {
+    "type": "object",
+    "properties": {
+        "userId": {
+            "type": "number",
+            "description": "Campo del body: userId",
+            "default": 1085718
+        }
+    },
+    "required": []
+};
+const customer_getbalanceInputShape = {
+    userId: z.number().optional().describe("Campo del body: userId")
+};
+const customer_getbalanceInputValidator = z.object(customer_getbalanceInputShape);
+// Herramienta: customer_getbalance
+export const customer_getbalanceTool = {
+    name: 'customer_getbalance',
+    description: "This service allows you to consult the balance exchange and the dispersion exchange associated with the client\\'s identifier.\\n\\n> To use the service, an authentication token is required, which must be sent as an Authorization header. \\n  \\n\\nHeaders\\n\\n| **Name** | **Value** |\\n| --- | --- |\\n| Content-Type | application/json |\\n| Authorization | Bearer |\\n\\nBody\\n\\n| Name | Type | Description |\\n| --- | --- | --- |\\n| \\`userId\\`\\\\* | number | Integrated unique user identifier |\n\nContexto: Endpoint: POST /customer/getBalance | Customer > GetBalance",
+    inputSchema: customer_getbalanceInputShape,
+    jsonSchema: customer_getbalanceInputJsonSchema,
+    endpoint: '/customer/getBalance',
+    method: 'POST',
+    parameters: [],
+    headers: [{ "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{tokenLogin}}" }],
+    handler: async (rawArgs) => {
+        try {
+            const normalizedArgs = rawArgs ?? {};
+            // Extraer secretId del contexto (si viene del HTTP mode)
+            const secretId = normalizedArgs._secretId;
+            // Remover _secretId de los args antes de validar
+            const { _secretId, ...argsToValidate } = normalizedArgs;
+            const validatedInput = validateToolInput(customer_getbalanceInputValidator, argsToValidate);
+            const args = validatedInput;
+            const bodyData = {};
+            const userIdValue = args.userId !== undefined ? args.userId : 1085718;
+            if (userIdValue !== undefined)
+                bodyData.userId = userIdValue;
+            return await makeApiRequest('POST', '/customer/getBalance', bodyData, undefined, secretId);
+        }
+        catch (error) {
+            // Formato estándar del protocolo MCP para errores
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            statusCode: 500,
+                            data: null,
+                            message: error instanceof Error ? error.message : 'Error desconocido',
+                            error: 'HANDLER_ERROR'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+const payment_transfiya_banksInputJsonSchema = {
+    "type": "object",
+    "properties": {
+        "cellphone": {
+            "type": "string",
+            "description": "Campo del body: cellphone",
+            "default": "3051000002"
+        }
+    },
+    "required": []
+};
+const payment_transfiya_banksInputShape = {
+    cellphone: z.string().optional().describe("Campo del body: cellphone")
+};
+const payment_transfiya_banksInputValidator = z.object(payment_transfiya_banksInputShape);
+// Herramienta: payment_transfiya_banks
+export const payment_transfiya_banksTool = {
+    name: 'payment_transfiya_banks',
+    description: "This service allows you to consult the balance exchange and the dispersion exchange associated with the client\\'s identifier.\\n\\n> To use the service, an authentication token is required, which must be sent as an Authorization header. \\n  \\n\\nHeaders\\n\\n| **Name** | **Value** |\\n| --- | --- |\\n| Content-Type | application/json |\\n| Authorization | Bearer |\\n\\nBody\\n\\n| Name | Type | Description |\\n| --- | --- | --- |\\n| \\`cellphone\\`\\\\* | number | The cell phone number to be used to consult the list of banks. |\n\nContexto: Endpoint: POST /payment/transfiya-banks | Payment > Transfiya banks",
+    inputSchema: payment_transfiya_banksInputShape,
+    jsonSchema: payment_transfiya_banksInputJsonSchema,
+    endpoint: '/payment/transfiya-banks',
+    method: 'POST',
+    parameters: [],
+    headers: [{ "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{tokenLogin}}" }],
+    handler: async (rawArgs) => {
+        try {
+            const normalizedArgs = rawArgs ?? {};
+            // Extraer secretId del contexto (si viene del HTTP mode)
+            const secretId = normalizedArgs._secretId;
+            // Remover _secretId de los args antes de validar
+            const { _secretId, ...argsToValidate } = normalizedArgs;
+            const validatedInput = validateToolInput(payment_transfiya_banksInputValidator, argsToValidate);
+            const args = validatedInput;
+            const bodyData = {};
+            const cellphoneValue = args.cellphone !== undefined ? args.cellphone : "3051000002";
+            if (cellphoneValue !== undefined)
+                bodyData.cellphone = cellphoneValue;
+            return await makeApiRequest('POST', '/payment/transfiya-banks', bodyData, undefined, secretId);
+        }
+        catch (error) {
+            // Formato estándar del protocolo MCP para errores
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            statusCode: 500,
+                            data: null,
+                            message: error instanceof Error ? error.message : 'Error desconocido',
+                            error: 'HANDLER_ERROR'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+const payment_statusInputJsonSchema = {
+    "type": "object",
+    "properties": {
+        "reference": {
+            "type": "string",
+            "description": "Campo del body: reference",
+            "default": "12442830-7afb-11ed-b265-b9457b46***3"
+        }
+    },
+    "required": []
+};
+const payment_statusInputShape = {
+    reference: z.string().optional().describe("Campo del body: reference")
+};
+const payment_statusInputValidator = z.object(payment_statusInputShape);
+// Herramienta: payment_status
+export const payment_statusTool = {
+    name: 'payment_status',
+    description: "This service allows you to check the status of a transaction made, for this you must have the _reference_ data that returned the response when generating any payment resource.\\n\\nIn the response you will get the _status_ _id_ which will mean the following\\n\\n0 - Transaction Rejected\\n\\n1 - Pending Transaction\\n\\n2 - Transaction Approved\\n\\n3 - Failed Transaction\\n\\n5 - Transaction Cancelled\\n\\n9 - Processing Transaction\\n\\nHeaders\\n\\n| **Name** | **Value** |\\n| --- | --- |\\n| Content-Type | application/json |\\n| Authorization | Bearer |\\n\\nBody\\n\\n| Name | Type | Description |\\n| --- | --- | --- |\\n| \\`reference\\`\\\\* | string | Product reference |\n\nContexto: Endpoint: POST /payment/status | Payment > Status",
+    inputSchema: payment_statusInputShape,
+    jsonSchema: payment_statusInputJsonSchema,
+    endpoint: '/payment/status',
+    method: 'POST',
+    parameters: [],
+    headers: [{ "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{tokenLogin}}" }],
+    handler: async (rawArgs) => {
+        try {
+            const normalizedArgs = rawArgs ?? {};
+            // Extraer secretId del contexto (si viene del HTTP mode)
+            const secretId = normalizedArgs._secretId;
+            // Remover _secretId de los args antes de validar
+            const { _secretId, ...argsToValidate } = normalizedArgs;
+            const validatedInput = validateToolInput(payment_statusInputValidator, argsToValidate);
+            const args = validatedInput;
+            const bodyData = {};
+            const referenceValue = args.reference !== undefined ? args.reference : "12442830-7afb-11ed-b265-b9457b46***3";
+            if (referenceValue !== undefined)
+                bodyData.reference = referenceValue;
+            return await makeApiRequest('POST', '/payment/status', bodyData, undefined, secretId);
+        }
+        catch (error) {
+            // Formato estándar del protocolo MCP para errores
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            statusCode: 500,
+                            data: null,
+                            message: error instanceof Error ? error.message : 'Error desconocido',
+                            error: 'HANDLER_ERROR'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+const payment_customer_reference_statusInputJsonSchema = {
+    "type": "object",
+    "properties": {
+        "customerReference": {
+            "type": "string",
+            "description": "Campo del body: customerReference",
+            "default": "12442830-7afb-11ed-b265-b9457b46***3"
+        }
+    },
+    "required": []
+};
+const payment_customer_reference_statusInputShape = {
+    customerReference: z.string().optional().describe("Campo del body: customerReference")
+};
+const payment_customer_reference_statusInputValidator = z.object(payment_customer_reference_statusInputShape);
+// Herramienta: payment_customer_reference_status
+export const payment_customer_reference_statusTool = {
+    name: 'payment_customer_reference_status',
+    description: "## 🔍 Check Transaction by Customer Reference\\n\\nThis endpoint allows **API Pay** users to query the status of a transaction using only the \\`customerReference\\` value originally provided when generating a resource as \\`reference1\\` through any of the following endpoints:\\n\\n- \\`/cash-in/generate/payment-link/token\\`\\n    \\n- \\`/cash-in/generate/payment-method/token\\`\\n    \\n- \\`/cash-out/generate/withdraw-method/token\\`\\n    \\n\\nThis service is useful for retrieving the internal **Refacil** transaction information associated with a previously submitted customer reference.\\n\\n---\\n\\n## 🔐 Authentication\\n\\nThis endpoint **requires** a valid Bearer Token in the request headers. Requests without valid authentication will be rejected with an \\`Unauthorized\\` error.\\n\\n## 📤 Successful Response\\n\\n- \\`exists\\`: \\`true\\` indicates that the transaction associated with the provided \\`customerReference\\` was found.\\n    \\n- \\`id\\`: Internal Refacil transaction ID.\\n    \\n- \\`status\\`: Transaction status code (see table below).\\n    \\n- \\`reference\\`: Full Refacil transaction reference, which can be used to query \\`/payment/status\\`.\\n    \\n\\n### ℹ️ Status Code Reference\\n\\n| Status Code | Meaning |\\n| --- | --- |\\n| \\`0\\` | Transaction Rejected |\\n| \\`1\\` | Transaction Pending |\\n| \\`2\\` | Transaction Approved |\\n| \\`3\\` | Transaction Failed |\\n| \\`5\\` | Transaction Cancelled |\\n| \\`9\\` | Transaction Processing |\\n\\n---\n\nContexto: Endpoint: POST /payment/customer-reference/status | Payment > Customer reference > Status",
+    inputSchema: payment_customer_reference_statusInputShape,
+    jsonSchema: payment_customer_reference_statusInputJsonSchema,
+    endpoint: '/payment/customer-reference/status',
+    method: 'POST',
+    parameters: [],
+    headers: [{ "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{tokenLogin}}" }],
+    handler: async (rawArgs) => {
+        try {
+            const normalizedArgs = rawArgs ?? {};
+            // Extraer secretId del contexto (si viene del HTTP mode)
+            const secretId = normalizedArgs._secretId;
+            // Remover _secretId de los args antes de validar
+            const { _secretId, ...argsToValidate } = normalizedArgs;
+            const validatedInput = validateToolInput(payment_customer_reference_statusInputValidator, argsToValidate);
+            const args = validatedInput;
+            const bodyData = {};
+            const customerReferenceValue = args.customerReference !== undefined ? args.customerReference : "12442830-7afb-11ed-b265-b9457b46***3";
+            if (customerReferenceValue !== undefined)
+                bodyData.customerReference = customerReferenceValue;
+            return await makeApiRequest('POST', '/payment/customer-reference/status', bodyData, undefined, secretId);
+        }
+        catch (error) {
+            // Formato estándar del protocolo MCP para errores
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            statusCode: 500,
+                            data: null,
+                            message: error instanceof Error ? error.message : 'Error desconocido',
+                            error: 'HANDLER_ERROR'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+const payment_featuresInputJsonSchema = {
+    "type": "object",
+    "properties": {
+        "id": {
+            "type": "number",
+            "description": "Campo del body: id",
+            "default": 133
+        }
+    },
+    "required": []
+};
+const payment_featuresInputShape = {
+    id: z.number().optional().describe("Campo del body: id")
+};
+const payment_featuresInputValidator = z.object(payment_featuresInputShape);
+// Herramienta: payment_features
+export const payment_featuresTool = {
+    name: 'payment_features',
+    description: "This service allows you to consult the necessary characteristics of a payment method to successfully generate a resource. For example, obtain the PSE banks\\n\\nHeaders\\n\\n| **Name** | **Value** |\\n| --- | --- |\\n| Content-Type | application/json |\\n| Authorization | Bearer |\\n\\nBody\\n\\n| Name | Type | Description |\\n| --- | --- | --- |\\n| \\`id\\`\\\\* | integer | Product identification |\n\nContexto: Endpoint: POST /payment/features | Payment > Features",
+    inputSchema: payment_featuresInputShape,
+    jsonSchema: payment_featuresInputJsonSchema,
+    endpoint: '/payment/features',
+    method: 'POST',
+    parameters: [],
+    headers: [{ "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{tokenLogin}}" }],
+    handler: async (rawArgs) => {
+        try {
+            const normalizedArgs = rawArgs ?? {};
+            // Extraer secretId del contexto (si viene del HTTP mode)
+            const secretId = normalizedArgs._secretId;
+            // Remover _secretId de los args antes de validar
+            const { _secretId, ...argsToValidate } = normalizedArgs;
+            const validatedInput = validateToolInput(payment_featuresInputValidator, argsToValidate);
+            const args = validatedInput;
+            const bodyData = {};
+            const idValue = args.id !== undefined ? args.id : 133;
+            if (idValue !== undefined)
+                bodyData.id = idValue;
+            return await makeApiRequest('POST', '/payment/features', bodyData, undefined, secretId);
+        }
+        catch (error) {
+            // Formato estándar del protocolo MCP para errores
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            statusCode: 500,
+                            data: null,
+                            message: error instanceof Error ? error.message : 'Error desconocido',
+                            error: 'HANDLER_ERROR'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+const webhook_notifyInputJsonSchema = {
+    "type": "object",
+    "properties": {
+        "reference": {
+            "type": "string",
+            "description": "Campo del body: reference",
+            "default": "12442830-7afb-11ed-b265-b9457b46***3"
+        }
+    },
+    "required": []
+};
+const webhook_notifyInputShape = {
+    reference: z.string().optional().describe("Campo del body: reference")
+};
+const webhook_notifyInputValidator = z.object(webhook_notifyInputShape);
+// Herramienta: webhook_notify
+export const webhook_notifyTool = {
+    name: 'webhook_notify',
+    description: "Body\\n\\n| Name | Type | Description |\\n| --- | --- | --- |\\n| amount\\\\* | Integer | Total transaction value |\\n| cost\\\\* | Integer | Transaction cost |\\n| Resource | Object | Object |\\n| id | Integer | Identifier of the payment resource |\\n| updatedAt | String | Date and time at which the transaction was processed |\\n| status\\\\* | Object | Transaction status identifier |\\n| transfiyaStatus | String | The TransfiYa status, see the details below |\\n| id\\\\* | String | Transaction status ID : 1 Pending , 2 Approved ,3 Failed |\\n| id \\\\* | Integer | transaction identifier |\\n| description | String | Status detail |\\n| Key | interger | Key |\\n| PaymentMethod | Object | Payment method |\\n| id | String | Method identifier |\\n| name | String | payment method name |\\n| type | String | method |\\n| extra | Object | Object |\\n| reference1\\\\* | String | Unique reference to the transaction provided when sending the request to generate the resource |\\n| reference2 | String | Allows to append extra information provided by the client |\\n| reference3 | String | Allows to append extra information provided by the customer |\\n| commerceId | String | Commerce identifier |\\n| createdAt | String | Date and time the transaction was created |\\n| signature | String | Signature generated for webhook notification |\\n| data | Object | Object with all data |\\n| Transaction | String |  |\\n\\n\\n## TransfiYa Status\\n\\n| **transfiyaStatus** |  Description |\\n| --- | --- |\\n| \\`CREATED\\` |  Transfer is received and queued for processing. |\\n| \\`PENDING\\` |  Transfer is valid and is waiting for the target to accept it. |\\n| \\`ACCEPTED\\` | Transfer has been accepted by the target, and payment is pending in the target bank. |\\n| \\`COMPLETED\\` | The payment is valid and completely processed, visible in the receiving bank account. |\\n| \\`REJECTED\\` | Payment was rejected. |\\n| \\`ERROR\\` | An error occurred during payment. |\\n\\n### Transfer state machine\\n\\n<img src=\\\"https://content.pstmn.io/89f89557-2e1b-44c2-8dcb-d9e7d2f32c54/aW1hZ2UucG5n\\\" width=\\\"293\\\" height=\\\"380\\\">\n\nContexto: Endpoint: POST /webhook/notify | Webhook > Notify",
+    inputSchema: webhook_notifyInputShape,
+    jsonSchema: webhook_notifyInputJsonSchema,
+    endpoint: '/webhook/notify',
+    method: 'POST',
+    parameters: [],
+    headers: [{ "key": "Content-Type", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{tokenLogin}}" }],
+    handler: async (rawArgs) => {
+        try {
+            const normalizedArgs = rawArgs ?? {};
+            // Extraer secretId del contexto (si viene del HTTP mode)
+            const secretId = normalizedArgs._secretId;
+            // Remover _secretId de los args antes de validar
+            const { _secretId, ...argsToValidate } = normalizedArgs;
+            const validatedInput = validateToolInput(webhook_notifyInputValidator, argsToValidate);
+            const args = validatedInput;
+            const bodyData = {};
+            const referenceValue = args.reference !== undefined ? args.reference : "12442830-7afb-11ed-b265-b9457b46***3";
+            if (referenceValue !== undefined)
+                bodyData.reference = referenceValue;
+            return await makeApiRequest('POST', '/webhook/notify', bodyData, undefined, secretId);
+        }
+        catch (error) {
+            // Formato estándar del protocolo MCP para errores
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            statusCode: 500,
+                            data: null,
+                            message: error instanceof Error ? error.message : 'Error desconocido',
+                            error: 'HANDLER_ERROR'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+const merchant_enrollmentInputJsonSchema = {
+    "type": "object",
+    "properties": {},
+    "required": []
+};
+const merchant_enrollmentInputShape = {};
+const merchant_enrollmentInputValidator = z.object(merchant_enrollmentInputShape);
+// Herramienta: merchant_enrollment
+export const merchant_enrollmentTool = {
+    name: 'merchant_enrollment',
+    description: "This endpoint initiates the merchant enrollment process required to use the QR interoperable payment method. Once the request is made, the enrollment process may take up to **7 minutes** to complete.\n\nContexto: Endpoint: GET /merchant/enrollment | Merchant > Enrollment",
+    inputSchema: merchant_enrollmentInputShape,
+    jsonSchema: merchant_enrollmentInputJsonSchema,
+    endpoint: '/merchant/enrollment',
+    method: 'GET',
+    parameters: [],
+    headers: [{ "key": "Authorization", "value": "Bearer {{tokenLogin}}", "type": "text" }],
+    handler: async (rawArgs) => {
+        try {
+            const normalizedArgs = rawArgs ?? {};
+            // Extraer secretId del contexto (si viene del HTTP mode)
+            const secretId = normalizedArgs._secretId;
+            // Remover _secretId de los args antes de validar
+            const { _secretId, ...argsToValidate } = normalizedArgs;
+            const validatedInput = validateToolInput(merchant_enrollmentInputValidator, argsToValidate);
+            const args = validatedInput;
+            return await makeApiRequest('GET', '/merchant/enrollment', undefined, undefined, secretId);
+        }
+        catch (error) {
+            // Formato estándar del protocolo MCP para errores
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            statusCode: 500,
+                            data: null,
+                            message: error instanceof Error ? error.message : 'Error desconocido',
+                            error: 'HANDLER_ERROR'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+const merchant_enrollment_dataInputJsonSchema = {
+    "type": "object",
+    "properties": {},
+    "required": []
+};
+const merchant_enrollment_dataInputShape = {};
+const merchant_enrollment_dataInputValidator = z.object(merchant_enrollment_dataInputShape);
+// Herramienta: merchant_enrollment_data
+export const merchant_enrollment_dataTool = {
+    name: 'merchant_enrollment_data',
+    description: "This endpoint retrieves the merchant\\'s enrollment details after the enrollment process has been completed. It provides necessary information to use the QR interoperable payment method.\n\nContexto: Endpoint: GET /merchant/enrollment-data | Merchant > Enrollment data",
+    inputSchema: merchant_enrollment_dataInputShape,
+    jsonSchema: merchant_enrollment_dataInputJsonSchema,
+    endpoint: '/merchant/enrollment-data',
+    method: 'GET',
+    parameters: [],
+    headers: [{ "key": "Authorization", "value": "Bearer {{tokenLogin}}", "type": "text" }],
+    handler: async (rawArgs) => {
+        try {
+            const normalizedArgs = rawArgs ?? {};
+            // Extraer secretId del contexto (si viene del HTTP mode)
+            const secretId = normalizedArgs._secretId;
+            // Remover _secretId de los args antes de validar
+            const { _secretId, ...argsToValidate } = normalizedArgs;
+            const validatedInput = validateToolInput(merchant_enrollment_dataInputValidator, argsToValidate);
+            const args = validatedInput;
+            return await makeApiRequest('GET', '/merchant/enrollment-data', undefined, undefined, secretId);
+        }
+        catch (error) {
+            // Formato estándar del protocolo MCP para errores
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            statusCode: 500,
+                            data: null,
+                            message: error instanceof Error ? error.message : 'Error desconocido',
+                            error: 'HANDLER_ERROR'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+const merchant_key_createInputJsonSchema = {
+    "type": "object",
+    "properties": {
+        "webhookUrl": {
+            "type": "string",
+            "description": "Campo del body: webhookUrl",
+            "default": "https://mi-comercio.com/webhook"
+        },
+        "reference1": {
+            "type": "string",
+            "description": "Campo del body: reference1",
+            "default": "Ref1053"
+        },
+        "reference2": {
+            "type": "object",
+            "description": "Campo del body: reference2",
+            "default": {
+                "Label": {
+                    "title": "Pago de servicios",
+                    "description": "Pago mensual de servicios básicos"
+                },
+                "Data": {
+                    "invoiceId": "INV-001",
+                    "customerId": "CUST-123"
+                },
+                "Commerce": {
+                    "name": "Mi Comercio",
+                    "category": "Servicios"
+                }
+            }
+        },
+        "userMetadata": {
+            "type": "object",
+            "description": "Campo del body: userMetadata",
+            "default": {
+                "identifier": "user-12345",
+                "ip": "192.168.1.100",
+                "urlCommerce": "https://mi-comercio.com"
+            }
+        },
+        "typeKey": {
+            "type": "string",
+            "description": "Campo del body: typeKey",
+            "default": "document"
+        },
+        "key": {
+            "type": "string",
+            "description": "Campo del body: key",
+            "default": "15545216"
+        },
+        "otp": {
+            "type": "string",
+            "description": "Campo del body: otp",
+            "default": "123456"
+        },
+        "termsAndConditions": {
+            "type": "boolean",
+            "description": "Campo del body: termsAndConditions",
+            "default": true
+        }
+    },
+    "required": []
+};
+const merchant_key_createInputShape = {
+    webhookUrl: z.string().optional().describe("Campo del body: webhookUrl"),
+    reference1: z.string().optional().describe("Campo del body: reference1"),
+    reference2: z.record(z.any()).optional().describe("Campo del body: reference2"),
+    userMetadata: z.record(z.any()).optional().describe("Campo del body: userMetadata"),
+    typeKey: z.string().optional().describe("Campo del body: typeKey"),
+    key: z.string().optional().describe("Campo del body: key"),
+    otp: z.string().optional().describe("Campo del body: otp"),
+    termsAndConditions: z.boolean().optional().describe("Campo del body: termsAndConditions")
+};
+const merchant_key_createInputValidator = z.object(merchant_key_createInputShape);
+// Herramienta: merchant_key_create
+export const merchant_key_createTool = {
+    name: 'merchant_key_create',
+    description: "This endpoint will allow you to create 4 types of keys: \\`alias\\`, \\`email\\`, \\`cellphone\\`, and \\`document\\`.\\n\\n⚠ **Important**:\\n\\n- **Alias key:** To generate this key, it is not necessary to send the \\`key\\` field and the \\`otp\\` field. A random key is generated from various parameters of the merchant user, beginning with the character @.\\n    \\n- **Document key:** To generate this key, it is not necessary to send the \\`otp\\` field, and the key field must contain the document provided in the technical data sheet shared with the merchant.\\n    \\n- **Email key:** To generate this key, you must first use the service that generates and sends the OTP to the \\`email\\` address. The key field must contain the \\`email\\` address provided in the technical data sheet.\\n    \\n- **Cellphone key:** To generate this key, you must first use the service that generates and sends the OTP to the \\`cellphone\\`. The key field must contain the \\`cellphone\\` number provided in the technical data sheet.\\n    \\n\\nHeaders\\n\\n| **Name** | **Value** |\\n| --- | --- |\\n| Content-Type | application/json |\\n| Authorization | Bearer |\\n| x-transaction-token | 9b48edde-652d-11ed-984e-02c840fe**** |\\n\\nBody\\n\\n| Name | Type | Description |\\n| --- | --- | --- |\\n| \\`webhookUrl\\`\\\\* | string | URL of the client\\'s webhook. |\\n| \\`userMetadata\\`\\\\* | object | Object containing key details about the user or merchant generating the payment resource. |\\n| \\`ip\\`\\\\* | string | Alphanumeric parameter that provides the IP address associated with the user\\'s identifier |\\n| \\`identifier\\`\\\\* | string | Alphanumeric parameter of 20 characters specifying the unique identifier of the user or merchant generating the payment resource. |\\n| \\`urlCommerce\\`\\\\* | string | URL that identifies the commerce. Must follow valid URL structure with http:// or https:// protocol. Maximum length: 500 characters. |\\n| \\`reference1\\`\\\\* | string | Customer identifier, must not exceed 20 characters. |\\n| \\`reference2\\` | object | Object for additional information. |\\n| \\`Label\\` | object | Object to send information to be displayed in the payment summary. |\\n| \\`Data\\` | object | Object for information related to the conciliation of the transaction. |\\n| \\`typeKey\\`\\\\* | string | Can be \\`alias\\`, \\`document\\`, \\`email\\`, and \\`cellphone\\` |\\n| \\`key\\` | string | Key to create |\\n| \\`otp\\` | string | OTP code for cellphone and email keys |\\n| \\`termsAndConditions\\`\\\\* | boolean | It must always be set to true. |\n\nContexto: Endpoint: POST /merchant-key/create | Merchant key > Create",
+    inputSchema: merchant_key_createInputShape,
+    jsonSchema: merchant_key_createInputJsonSchema,
+    endpoint: '/merchant-key/create',
+    method: 'POST',
+    parameters: [],
+    headers: [{ "key": "Authorization", "value": "Bearer {{tokenLogin}}", "type": "text" }, { "key": "x-transaction-token", "value": "{{transactionalToken}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }],
+    handler: async (rawArgs) => {
+        try {
+            const normalizedArgs = rawArgs ?? {};
+            // Extraer secretId del contexto (si viene del HTTP mode)
+            const secretId = normalizedArgs._secretId;
+            // Remover _secretId de los args antes de validar
+            const { _secretId, ...argsToValidate } = normalizedArgs;
+            const validatedInput = validateToolInput(merchant_key_createInputValidator, argsToValidate);
+            const args = validatedInput;
+            const bodyData = {};
+            const webhookUrlValue = args.webhookUrl !== undefined ? args.webhookUrl : "https://mi-comercio.com/webhook";
+            if (webhookUrlValue !== undefined)
+                bodyData.webhookUrl = webhookUrlValue;
+            const reference1Value = args.reference1 !== undefined ? args.reference1 : "Ref1053";
+            if (reference1Value !== undefined)
+                bodyData.reference1 = reference1Value;
+            const reference2Value = args.reference2 !== undefined ? args.reference2 : { "Label": { "title": "Pago de servicios", "description": "Pago mensual de servicios básicos" }, "Data": { "invoiceId": "INV-001", "customerId": "CUST-123" }, "Commerce": { "name": "Mi Comercio", "category": "Servicios" } };
+            if (reference2Value !== undefined)
+                bodyData.reference2 = reference2Value;
+            const userMetadataValue = args.userMetadata !== undefined ? args.userMetadata : { "identifier": "user-12345", "ip": "192.168.1.100", "urlCommerce": "https://mi-comercio.com" };
+            if (userMetadataValue !== undefined)
+                bodyData.userMetadata = userMetadataValue;
+            const typeKeyValue = args.typeKey !== undefined ? args.typeKey : "document";
+            if (typeKeyValue !== undefined)
+                bodyData.typeKey = typeKeyValue;
+            const keyValue = args.key !== undefined ? args.key : "15545216";
+            if (keyValue !== undefined)
+                bodyData.key = keyValue;
+            const otpValue = args.otp !== undefined ? args.otp : "123456";
+            if (otpValue !== undefined)
+                bodyData.otp = otpValue;
+            const termsAndConditionsValue = args.termsAndConditions !== undefined ? args.termsAndConditions : true;
+            if (termsAndConditionsValue !== undefined)
+                bodyData.termsAndConditions = termsAndConditionsValue;
+            return await makeApiRequest('POST', '/merchant-key/create', bodyData, undefined, secretId);
+        }
+        catch (error) {
+            // Formato estándar del protocolo MCP para errores
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            statusCode: 500,
+                            data: null,
+                            message: error instanceof Error ? error.message : 'Error desconocido',
+                            error: 'HANDLER_ERROR'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+const merchant_key_cancelInputJsonSchema = {
+    "type": "object",
+    "properties": {
+        "userMetadata": {
+            "type": "object",
+            "description": "Campo del body: userMetadata",
+            "default": {
+                "identifier": "user-12345",
+                "ip": "192.168.1.100",
+                "urlCommerce": "https://mi-comercio.com"
+            }
+        },
+        "key": {
+            "type": "string",
+            "description": "Campo del body: key",
+            "default": "15545216"
+        }
+    },
+    "required": []
+};
+const merchant_key_cancelInputShape = {
+    userMetadata: z.record(z.any()).optional().describe("Campo del body: userMetadata"),
+    key: z.string().optional().describe("Campo del body: key")
+};
+const merchant_key_cancelInputValidator = z.object(merchant_key_cancelInputShape);
+// Herramienta: merchant_key_cancel
+export const merchant_key_cancelTool = {
+    name: 'merchant_key_cancel',
+    description: "This endpoint allows you to cancel an existing key, which will then become inactive and unable to receive transactions.\\n\\nHeaders\\n\\n| **Name** | **Value** |\\n| --- | --- |\\n| Content-Type | application/json |\\n| Authorization | Bearer |\\n| x-transaction-token | 9b48edde-652d-11ed-984e-02c840fe**** |\\n\\nBody\\n\\n| Name | Type | Description |\\n| --- | --- | --- |\\n| \\`userMetadata\\`\\\\* | object | Object containing key details about the user or merchant generating the payment resource. |\\n| \\`ip\\`\\\\* | string | Alphanumeric parameter that provides the IP address associated with the user\\'s identifier |\\n| \\`identifier\\`\\\\* | string | Alphanumeric parameter of 20 characters specifying the unique identifier of the user or merchant generating the payment resource. |\\n| \\`urlCommerce\\`\\\\* | string | URL that identifies the commerce. Must follow valid URL structure with http:// or https:// protocol. Maximum length: 500 characters. |\\n| \\`key\\` | string | Key to cancel |\n\nContexto: Endpoint: POST /merchant-key/cancel | Merchant key > Cancel",
+    inputSchema: merchant_key_cancelInputShape,
+    jsonSchema: merchant_key_cancelInputJsonSchema,
+    endpoint: '/merchant-key/cancel',
+    method: 'POST',
+    parameters: [],
+    headers: [{ "key": "Authorization", "value": "Bearer {{tokenLogin}}", "type": "text" }, { "key": "x-transaction-token", "value": "{{transactionalToken}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }],
+    handler: async (rawArgs) => {
+        try {
+            const normalizedArgs = rawArgs ?? {};
+            // Extraer secretId del contexto (si viene del HTTP mode)
+            const secretId = normalizedArgs._secretId;
+            // Remover _secretId de los args antes de validar
+            const { _secretId, ...argsToValidate } = normalizedArgs;
+            const validatedInput = validateToolInput(merchant_key_cancelInputValidator, argsToValidate);
+            const args = validatedInput;
+            const bodyData = {};
+            const userMetadataValue = args.userMetadata !== undefined ? args.userMetadata : { "identifier": "user-12345", "ip": "192.168.1.100", "urlCommerce": "https://mi-comercio.com" };
+            if (userMetadataValue !== undefined)
+                bodyData.userMetadata = userMetadataValue;
+            const keyValue = args.key !== undefined ? args.key : "15545216";
+            if (keyValue !== undefined)
+                bodyData.key = keyValue;
+            return await makeApiRequest('POST', '/merchant-key/cancel', bodyData, undefined, secretId);
+        }
+        catch (error) {
+            // Formato estándar del protocolo MCP para errores
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            statusCode: 500,
+                            data: null,
+                            message: error instanceof Error ? error.message : 'Error desconocido',
+                            error: 'HANDLER_ERROR'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+const merchant_key_generate_otpInputJsonSchema = {
+    "type": "object",
+    "properties": {
+        "key": {
+            "type": "string",
+            "description": "Campo del body: key",
+            "default": "j.salgado@refacil.com"
+        },
+        "typeKey": {
+            "type": "string",
+            "description": "Campo del body: typeKey",
+            "default": "email"
+        }
+    },
+    "required": []
+};
+const merchant_key_generate_otpInputShape = {
+    key: z.string().optional().describe("Campo del body: key"),
+    typeKey: z.string().optional().describe("Campo del body: typeKey")
+};
+const merchant_key_generate_otpInputValidator = z.object(merchant_key_generate_otpInputShape);
+// Herramienta: merchant_key_generate_otp
+export const merchant_key_generate_otpTool = {
+    name: 'merchant_key_generate_otp',
+    description: "This endpoint will allow you to generate and send an OTP. It is only permitted and necessary for \\`email\\` and \\`cellphone\\` keys. This OTP will be sent to its corresponding destination.\\n\\nHeaders\\n\\n| **Name** | **Value** |\\n| --- | --- |\\n| Content-Type | application/json |\\n| Authorization | Bearer |\\n\\nBody\\n\\n| Name | Type | Description |\\n| --- | --- | --- |\\n| \\`typeKey\\`\\\\* | string | Can be \\`email\\` and \\`cellphone\\` |\\n| \\`key\\` | string | key for which the OTP will be generated |\n\nContexto: Endpoint: POST /merchant-key/generate-otp | Merchant key > Generate otp",
+    inputSchema: merchant_key_generate_otpInputShape,
+    jsonSchema: merchant_key_generate_otpInputJsonSchema,
+    endpoint: '/merchant-key/generate-otp',
+    method: 'POST',
+    parameters: [],
+    headers: [{ "key": "Authorization", "value": "Bearer {{tokenLogin}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" }],
+    handler: async (rawArgs) => {
+        try {
+            const normalizedArgs = rawArgs ?? {};
+            // Extraer secretId del contexto (si viene del HTTP mode)
+            const secretId = normalizedArgs._secretId;
+            // Remover _secretId de los args antes de validar
+            const { _secretId, ...argsToValidate } = normalizedArgs;
+            const validatedInput = validateToolInput(merchant_key_generate_otpInputValidator, argsToValidate);
+            const args = validatedInput;
+            const bodyData = {};
+            const keyValue = args.key !== undefined ? args.key : "j.salgado@refacil.com";
+            if (keyValue !== undefined)
+                bodyData.key = keyValue;
+            const typeKeyValue = args.typeKey !== undefined ? args.typeKey : "email";
+            if (typeKeyValue !== undefined)
+                bodyData.typeKey = typeKeyValue;
+            return await makeApiRequest('POST', '/merchant-key/generate-otp', bodyData, undefined, secretId);
+        }
+        catch (error) {
+            // Formato estándar del protocolo MCP para errores
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            statusCode: 500,
+                            data: null,
+                            message: error instanceof Error ? error.message : 'Error desconocido',
+                            error: 'HANDLER_ERROR'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+const merchant_key_get_keysInputJsonSchema = {
+    "type": "object",
+    "properties": {},
+    "required": []
+};
+const merchant_key_get_keysInputShape = {};
+const merchant_key_get_keysInputValidator = z.object(merchant_key_get_keysInputShape);
+// Herramienta: merchant_key_get_keys
+export const merchant_key_get_keysTool = {
+    name: 'merchant_key_get_keys',
+    description: "This endpoint allows you to obtain all keys created and in active status that belong to the merchant.\n\nContexto: Endpoint: GET /merchant-key/get-keys | Merchant key > Get keys",
+    inputSchema: merchant_key_get_keysInputShape,
+    jsonSchema: merchant_key_get_keysInputJsonSchema,
+    endpoint: '/merchant-key/get-keys',
+    method: 'GET',
+    parameters: [],
+    headers: [{ "key": "Authorization", "value": "Bearer {{tokenLogin}}", "type": "text" }],
+    handler: async (rawArgs) => {
+        try {
+            const normalizedArgs = rawArgs ?? {};
+            // Extraer secretId del contexto (si viene del HTTP mode)
+            const secretId = normalizedArgs._secretId;
+            // Remover _secretId de los args antes de validar
+            const { _secretId, ...argsToValidate } = normalizedArgs;
+            const validatedInput = validateToolInput(merchant_key_get_keysInputValidator, argsToValidate);
+            const args = validatedInput;
+            return await makeApiRequest('GET', '/merchant-key/get-keys', undefined, undefined, secretId);
+        }
+        catch (error) {
+            // Formato estándar del protocolo MCP para errores
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            statusCode: 500,
+                            data: null,
+                            message: error instanceof Error ? error.message : 'Error desconocido',
+                            error: 'HANDLER_ERROR'
+                        }, null, 2)
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+};
+// Array de todas las herramientas disponibles
+export const tools = [
+    auth_loginTool,
+    trx_token_generateTool,
+    trx_token_generate_3Tool,
+    trx_token_generate_4Tool,
+    trx_token_generate_5Tool,
+    trx_token_generate_6Tool,
+    cash_in_generate_payment_link_tokenTool,
+    cash_in_generate_payment_method_tokenTool,
+    cash_out_generate_withdraw_method_tokenTool,
+    customer_getbalanceTool,
+    payment_transfiya_banksTool,
+    payment_statusTool,
+    payment_customer_reference_statusTool,
+    payment_featuresTool,
+    webhook_notifyTool,
+    merchant_enrollmentTool,
+    merchant_enrollment_dataTool,
+    merchant_key_createTool,
+    merchant_key_cancelTool,
+    merchant_key_generate_otpTool,
+    merchant_key_get_keysTool
+];
+// Configuración de herramientas del MCP
+export const toolsConfig = {
+    name: 'refacil-pay',
+    description: 'MCP para Refacil Pay API - Gestión de pagos y transacciones',
+    version: '1.0.0',
+    tools: 21
+};
+// Función para obtener información de las herramientas
+export function getToolsInfo() {
+    return {
+        ...toolsConfig,
+        tools: tools.map(tool => ({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.jsonSchema
+        }))
+    };
+}
+// Función helper para validar parámetros de entrada
+export function validateToolInput(validator, input) {
+    try {
+        return validator.parse(input);
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            const errors = error.errors.map(err => `${err.path.join('.')} : ${err.message}`).join(', ');
+            throw new Error(`Validación fallida: ${errors}`);
+        }
+        throw error;
+    }
+}
+// Sistema de logging para las herramientas
+export class ToolLogger {
+    toolName;
+    startTime;
+    constructor(toolName) {
+        this.toolName = toolName;
+        this.startTime = Date.now();
+    }
+    logStart(args) {
+        console.log(`[${new Date().toISOString()}] ${this.toolName} iniciada`, {
+            tool: this.toolName,
+            args: JSON.stringify(args),
+            timestamp: this.startTime
+        });
+    }
+    logSuccess(result) {
+        const duration = Date.now() - this.startTime;
+        console.log(`[${new Date().toISOString()}] ${this.toolName} completada exitosamente`, {
+            tool: this.toolName,
+            duration: `${duration}ms`,
+            statusCode: result?.statusCode
+        });
+    }
+    logError(error) {
+        const duration = Date.now() - this.startTime;
+        console.error(`[${new Date().toISOString()}] ${this.toolName} falló`, {
+            tool: this.toolName,
+            duration: `${duration}ms`,
+            error: error?.message || error
+        });
+    }
+}
+//# sourceMappingURL=tools.js.map