46elks MCP Server

import { SendSmsResponse, ElksMessage, AccountInfo } from './elks-client.js'; /** * Format SMS response for MCP tool output */ export const formatSmsResponse = (response: SendSmsResponse, isDryRun: boolean): string => { const mode = isDryRun ? '🧪 DRY RUN' : '📱 SENT'; const cost = response.estimated_cost ? `Estimated cost: ${response.estimated_cost / 10000} SEK` : response.cost ? `Cost: ${response.cost / 10000} SEK` : 'Cost: N/A'; let output = `${mode} SMS Status: ${response.status}\n`; output += `To: ${response.to}\n`; output += `From: ${response.from}\n`; output += `Message: ${response.message}\n`; output += `${cost}\n`; if (response.parts) { output += `Message parts: ${response.parts}\n`; } if (response.id) { output += `Message ID: ${response.id}\n`; } if (isDryRun) { output += '\n⚠️ This was a test - no actual SMS was sent'; } return output; }; /** * Format SMS message history for MCP tool output */ export const formatSmsHistory = (messages: ElksMessage[], limit: number): string => { if (messages.length === 0) { return '📭 No SMS messages found'; } let output = `📱 SMS Message History (${messages.length} of ${limit} requested)\n\n`; messages.forEach((msg, index) => { const direction = msg.direction === 'outbound' ? '📤 Sent' : '📥 Received'; const cost = msg.cost ? ` (${msg.cost / 10000} SEK)` : ''; const date = new Date(msg.created).toLocaleString(); output += `${index + 1}. ${direction}${cost}\n`; output += ` To: ${msg.to}\n`; output += ` From: ${msg.from}\n`; output += ` Status: ${msg.status}\n`; output += ` Created: ${date}\n`; output += ` Message: ${msg.message}\n`; if (msg.id) { output += ` ID: ${msg.id}\n`; } output += '\n'; }); return output.trim(); }; /** * Format account balance information for MCP tool output */ export const formatAccountBalance = (accountInfo: AccountInfo): string => { const balanceInCurrency = accountInfo.balance / 10000; const formattedBalance = `${balanceInCurrency.toFixed(2)} ${accountInfo.currency}`; let output = `💰 Account Balance Information\n\n`; output += `Balance: ${formattedBalance}\n`; output += `Account: ${accountInfo.displayname}\n`; output += `Mobile: ${accountInfo.mobilenumber}\n`; output += `Email: ${accountInfo.email}\n`; output += `Currency: ${accountInfo.currency}\n`; output += `Account ID: ${accountInfo.id}\n\n`; // Add balance status indication if (balanceInCurrency < 10) { output += `⚠️ Low balance warning: Consider adding funds to your account\n`; output += `💡 Note: Adding funds must be done through the 46elks web interface at https://dashboard.46elks.com/`; } else { output += `✅ Balance sufficient for SMS sending`; } return output; }; /** * Calculate and format delivery statistics from messages */ export const formatDeliveryStatistics = (messages: ElksMessage[]): string => { if (messages.length === 0) { return '📊 No messages found to analyze'; } // Filter only outbound messages (we can't analyze delivery for inbound) const outboundMessages = messages.filter(msg => msg.direction === 'outbound'); if (outboundMessages.length === 0) { return '📊 No outbound messages found to analyze delivery statistics'; } // Count messages by status const statusCounts = outboundMessages.reduce((counts, msg) => { counts[msg.status] = (counts[msg.status] || 0) + 1; return counts; }, {} as Record<string, number>); // Calculate costs const totalCost = outboundMessages .filter(msg => msg.cost) .reduce((sum, msg) => sum + (msg.cost || 0), 0) / 10000; const averageCost = totalCost / Math.max(outboundMessages.filter(msg => msg.cost).length, 1); // Calculate success rate const deliveredCount = statusCounts.delivered || 0; const sentCount = statusCounts.sent || 0; const successfulMessages = deliveredCount + sentCount; const successRate = Math.round((successfulMessages / outboundMessages.length) * 100); // Build statistics output let output = `📊 SMS Delivery Statistics\n\n`; output += `📈 Summary (Last ${outboundMessages.length} outbound messages)\n`; output += `Success Rate: ${successRate}% (${successfulMessages}/${outboundMessages.length})\n`; output += `Total Cost: ${totalCost.toFixed(2)} SEK\n`; output += `Average Cost: ${averageCost.toFixed(2)} SEK per SMS\n\n`; output += `📋 Message Status Breakdown:\n`; Object.entries(statusCounts).forEach(([status, count]) => { const percentage = Math.round((count / outboundMessages.length) * 100); const statusEmoji = getStatusEmoji(status); output += `${statusEmoji} ${status}: ${count} (${percentage}%)\n`; }); output += `\n📅 Analysis Period: ${new Date(outboundMessages[outboundMessages.length - 1].created).toLocaleDateString()} - ${new Date(outboundMessages[0].created).toLocaleDateString()}`; // Add recommendations if (successRate < 90) { output += `\n\n⚠️ Low success rate detected. Consider:\n`; output += `• Verifying phone number formats\n`; output += `• Checking message content for blocked words\n`; output += `• Ensuring recipient numbers are active`; } else { output += `\n\n✅ Good delivery performance!`; } return output; }; /** * Get emoji for message status */ function getStatusEmoji(status: string): string { switch (status) { case 'delivered': return '✅'; case 'sent': return '📤'; case 'failed': return '❌'; case 'created': return '🕐'; default: return '❓'; } }