Payware MCP Server

import { registerAudio, getProductAudios, getAudio, updateAudio, deleteAudio } from '../../shared/products/products-api.js'; import { getPartnerIdSafe, getPrivateKeySafe } from '../../config/env.js'; /** * Register audio tool implementation for merchants */ export const registerAudioTool = { name: "payware_products_register_audio", description: `Register an audio file (soundbite) for a product to enable audio-based payment initiation. **Supported formats:** Most audio/video formats (up to 200MB) **Note:** For video files, only the audio channel is registered`, inputSchema: { type: "object", properties: { productId: { type: "string", description: "Product identifier (starts with 'pr')", pattern: "^pr[a-zA-Z0-9]+$" }, audioPath: { type: "string", description: "Path to the audio file to upload (e.g., '/path/to/audio.mp3')" }, partnerId: { type: "string", description: "Merchant partner ID (uses PAYWARE_PARTNER_ID env var as default)", default: getPartnerIdSafe() }, privateKey: { type: "string", description: "RSA private key for authentication (uses environment-specific private key as default)", default: getPrivateKeySafe() }, useSandbox: { type: "boolean", description: "Use sandbox environment", default: true } }, required: ["productId", "audioPath"] }, async handler(args) { const { productId, audioPath, partnerId = getPartnerIdSafe(), privateKey = getPrivateKeySafe(), useSandbox = true } = args; if (!productId) { throw new Error("Product ID is required"); } if (!audioPath) { throw new Error("Audio file path is required"); } if (!partnerId || !privateKey) { throw new Error("Partner ID and private key are required"); } try { const result = await registerAudio({ productId, audioPath, partnerType: 'merchant', partnerId, privateKey, useSandbox }); const audio = result.data; return { content: [{ type: "text", text: `🎵 **Audio Registered Successfully** **Audio Details:** - ID: ${audio.id} - Product ID: ${audio.productId} - Title: ${audio.title} - Status: ${audio.status === '1' ? '✅ Ready' : '⏳ Processing'} - Duration: ${audio.duration} seconds - Uploaded: ${audio.uploadedAt} **API Response:** \`\`\`json ${JSON.stringify(audio, null, 2)} \`\`\` **API Call Details:** - Endpoint: ${result.requestInfo.method} ${result.requestInfo.url} - Status: ${result.requestInfo.statusCode} **Important Notes:** ${audio.status === '0' ? '⏳ Audio is being processed. Check status with `payware_products_get_audio`' : ''} ${audio.status === '1' ? '✅ Audio is ready for use in soundbite transactions' : ''} **Next Steps:** - Use \`payware_products_get_audios\` to view all product audios - Use \`payware_products_get_audio\` to check processing status - Create soundbite transactions using this audio` }] }; } catch (error) { return { content: [{ type: "text", text: `❌ **Audio Registration Failed** **Error Details:** - Message: ${error.message} - Product ID: ${productId} - Audio Path: ${audioPath} **Troubleshooting:** 1. Verify the audio file path exists and is accessible 2. Check file size (max 200MB) 3. Ensure supported audio/video format 4. Verify the product ID exists and belongs to your account 5. Check available storage space` }] }; } } }; /** * Get product audios tool implementation for merchants */ export const getAudiosTool = { name: "payware_products_get_audios", description: "Get all registered audio files for a product", inputSchema: { type: "object", properties: { productId: { type: "string", description: "Product identifier (starts with 'pr')", pattern: "^pr[a-zA-Z0-9]+$" }, partnerId: { type: "string", description: "Merchant partner ID (uses PAYWARE_PARTNER_ID env var as default)", default: getPartnerIdSafe() }, privateKey: { type: "string", description: "RSA private key for authentication (uses environment-specific private key as default)", default: getPrivateKeySafe() }, useSandbox: { type: "boolean", description: "Use sandbox environment", default: true } }, required: ["productId"] }, async handler(args) { const { productId, partnerId = getPartnerIdSafe(), privateKey = getPrivateKeySafe(), useSandbox = true } = args; if (!productId) { throw new Error("Product ID is required"); } if (!partnerId || !privateKey) { throw new Error("Partner ID and private key are required"); } try { const result = await getProductAudios({ productId, partnerType: 'merchant', partnerId, privateKey, useSandbox }); const audios = result.data; const audioCount = Array.isArray(audios) ? audios.length : 0; let audiosList = ''; if (Array.isArray(audios) && audios.length > 0) { audiosList = audios.map(audio => `**Audio ${audio.id}:** - Title: ${audio.title} - Status: ${audio.status === '1' ? '✅ Ready' : '⏳ Processing'} - Duration: ${audio.duration} seconds - Uploaded: ${audio.uploadedAt}` ).join('\n\n'); } else { audiosList = 'No audio files found for this product.'; } return { content: [{ type: "text", text: `🎵 **Product Audio Files** **Product ID:** ${productId} **Total Audio Files:** ${audioCount} **Audio Files:** ${audiosList} **API Call Details:** - Endpoint: ${result.requestInfo.method} ${result.requestInfo.url} - Status: ${result.requestInfo.statusCode} **Available Actions:** - \`payware_products_register_audio\` - Upload new audio file - \`payware_products_get_audio\` - Get specific audio details - \`payware_products_update_audio\` - Update audio information - \`payware_products_delete_audio\` - Delete audio file` }] }; } catch (error) { return { content: [{ type: "text", text: `❌ **Failed to Get Audio Files** **Error Details:** - Message: ${error.message} - Product ID: ${productId}` }] }; } } }; /** * Get audio tool implementation for merchants */ export const getAudioTool = { name: "payware_products_get_audio", description: "Get detailed information about a specific audio file", inputSchema: { type: "object", properties: { productId: { type: "string", description: "Product identifier (starts with 'pr')", pattern: "^pr[a-zA-Z0-9]+$" }, audioId: { type: "number", description: "Audio identifier" }, partnerId: { type: "string", description: "Merchant partner ID (uses PAYWARE_PARTNER_ID env var as default)", default: getPartnerIdSafe() }, privateKey: { type: "string", description: "RSA private key for authentication (uses environment-specific private key as default)", default: getPrivateKeySafe() }, useSandbox: { type: "boolean", description: "Use sandbox environment", default: true } }, required: ["productId", "audioId"] }, async handler(args) { const { productId, audioId, partnerId = getPartnerIdSafe(), privateKey = getPrivateKeySafe(), useSandbox = true } = args; if (!productId || !audioId) { throw new Error("Product ID and audio ID are required"); } if (!partnerId || !privateKey) { throw new Error("Partner ID and private key are required"); } try { const result = await getAudio({ productId, audioId, partnerType: 'merchant', partnerId, privateKey, useSandbox }); const audio = result.data; return { content: [{ type: "text", text: `🎵 **Audio Details** **Audio Information:** - ID: ${audio.id} - Product ID: ${audio.productId} - Title: ${audio.title} - Status: ${audio.status === '1' ? '✅ Ready for use' : '⏳ Processing'} - Duration: ${audio.duration} seconds - Uploaded: ${audio.uploadedAt} **API Response:** \`\`\`json ${JSON.stringify(audio, null, 2)} \`\`\` **API Call Details:** - Endpoint: ${result.requestInfo.method} ${result.requestInfo.url} - Status: ${result.requestInfo.statusCode} **Status Information:** ${audio.status === '0' ? '⏳ **Processing:** Audio is being processed and will be available soon' : ''} ${audio.status === '1' ? '✅ **Ready:** Audio is processed and ready for soundbite transactions' : ''} **Available Actions:** - \`payware_products_update_audio\` - Update audio title or reassign to another product - \`payware_products_delete_audio\` - Delete this audio file` }] }; } catch (error) { return { content: [{ type: "text", text: `❌ **Failed to Get Audio** **Error Details:** - Message: ${error.message} - Product ID: ${productId} - Audio ID: ${audioId}` }] }; } } }; /** * Update audio tool implementation for merchants */ export const updateAudioTool = { name: "payware_products_update_audio", description: "Update audio information (title) or reassign audio to another product", inputSchema: { type: "object", properties: { productId: { type: "string", description: "Current product identifier (starts with 'pr')", pattern: "^pr[a-zA-Z0-9]+$" }, audioId: { type: "number", description: "Audio identifier" }, title: { type: "string", description: "New audio title", maxLength: 150 }, newProductId: { type: "string", description: "New product ID to reassign audio to (starts with 'pr')", pattern: "^pr[a-zA-Z0-9]+$" }, partnerId: { type: "string", description: "Merchant partner ID (uses PAYWARE_PARTNER_ID env var as default)", default: getPartnerIdSafe() }, privateKey: { type: "string", description: "RSA private key for authentication (uses environment-specific private key as default)", default: getPrivateKeySafe() }, useSandbox: { type: "boolean", description: "Use sandbox environment", default: true } }, required: ["productId", "audioId"] }, async handler(args) { const { productId, audioId, title, newProductId, partnerId = getPartnerIdSafe(), privateKey = getPrivateKeySafe(), useSandbox = true } = args; if (!productId || !audioId) { throw new Error("Product ID and audio ID are required"); } if (!title && !newProductId) { throw new Error("Either title or newProductId must be provided to update"); } if (!partnerId || !privateKey) { throw new Error("Partner ID and private key are required"); } try { const result = await updateAudio({ productId, audioId, title, newProductId, partnerType: 'merchant', partnerId, privateKey, useSandbox }); const audio = result.data; return { content: [{ type: "text", text: `✅ **Audio Updated Successfully** **Updated Audio:** - ID: ${audio.id} - Product ID: ${audio.productId}${newProductId ? ` (reassigned from ${productId})` : ''} - Title: ${audio.title} - Status: ${audio.status === '1' ? '✅ Ready' : '⏳ Processing'} - Duration: ${audio.duration} seconds - Uploaded: ${audio.uploadedAt} **Changes Made:** ${title ? `- Title updated to: "${title}"` : ''} ${newProductId ? `- Reassigned from product ${productId} to ${newProductId}` : ''} **API Response:** \`\`\`json ${JSON.stringify(audio, null, 2)} \`\`\` **API Call Details:** - Endpoint: ${result.requestInfo.method} ${result.requestInfo.url} - Status: ${result.requestInfo.statusCode}` }] }; } catch (error) { return { content: [{ type: "text", text: `❌ **Audio Update Failed** **Error Details:** - Message: ${error.message} - Product ID: ${productId} - Audio ID: ${audioId} **Troubleshooting:** 1. Verify both product IDs exist and belong to your account 2. Check that the audio ID is correct 3. Ensure title length is within limits (150 chars) 4. Verify JWT token is valid and not expired` }] }; } } }; /** * Delete audio tool implementation for merchants */ export const deleteAudioTool = { name: "payware_products_delete_audio", description: "Delete an audio file from a product. This action cannot be undone.", inputSchema: { type: "object", properties: { productId: { type: "string", description: "Product identifier (starts with 'pr')", pattern: "^pr[a-zA-Z0-9]+$" }, audioId: { type: "number", description: "Audio identifier" }, partnerId: { type: "string", description: "Merchant partner ID (uses PAYWARE_PARTNER_ID env var as default)", default: getPartnerIdSafe() }, privateKey: { type: "string", description: "RSA private key for authentication (uses environment-specific private key as default)", default: getPrivateKeySafe() }, useSandbox: { type: "boolean", description: "Use sandbox environment", default: true } }, required: ["productId", "audioId"] }, async handler(args) { const { productId, audioId, partnerId = getPartnerIdSafe(), privateKey = getPrivateKeySafe(), useSandbox = true } = args; if (!productId || !audioId) { throw new Error("Product ID and audio ID are required"); } if (!partnerId || !privateKey) { throw new Error("Partner ID and private key are required"); } try { const result = await deleteAudio({ productId, audioId, partnerType: 'merchant', partnerId, privateKey, useSandbox }); return { content: [{ type: "text", text: `🗑️ **Audio Deleted Successfully** **Deleted Audio:** - Product ID: ${productId} - Audio ID: ${audioId} **API Call Details:** - Endpoint: ${result.requestInfo.method} ${result.requestInfo.url} - Status: ${result.requestInfo.statusCode} **Important Notes:** ⚠️ This action cannot be undone ⚠️ Any soundbite transactions using this audio may be affected **Next Steps:** - Use \`payware_products_get_audios\` to view remaining audio files - Upload new audio files with \`payware_products_register_audio\` - Check for any active soundbite transactions that used this audio` }] }; } catch (error) { return { content: [{ type: "text", text: `❌ **Audio Deletion Failed** **Error Details:** - Message: ${error.message} - Product ID: ${productId} - Audio ID: ${audioId} **Troubleshooting:** 1. Verify the audio ID exists and belongs to the specified product 2. Check if the audio is currently being used in active transactions 3. Ensure proper permissions and JWT token validity` }] }; } } };