Asterisk S2S MCP Server

Instructions

Implementation Reference

• index.ts:98-112 (registration)

  Registers the 'phone_get_metrics' MCP tool with empty input schema and an inline handler that fetches metrics via phoneTools.getCallMetrics() and returns formatted text output.

  server.tool(
    "phone_get_metrics",
    "Obtener métricas y estadísticas del sistema telefónico",
    {},
    async () => {
      const result = await phoneTools.getCallMetrics();
  
      return {
        content: [{ 
          type: "text", 
          text: `📊 **Métricas del Sistema Telefónico**\n\n**Total de llamadas:** ${result.totalCalls}\n**Llamadas exitosas:** ${result.successfulCalls}\n**Llamadas fallidas:** ${result.failedCalls}\n**Tasa de éxito:** ${result.successRate}%\n**Duración promedio:** ${Math.round(result.averageDuration)} segundos\n\n**Top propósitos:**\n${result.topPurposes.map(p => `- ${p.proposito}: ${p.count} llamadas`).join('\n')}`
        }],
      };
    }
  );

• operations/realtime-assistant.ts:317-392 (handler)

  Core implementation of getCallMetrics(): computes comprehensive phone call metrics from in-memory activeCalls and conversationHistory, including totals, success/failure counts, average duration, daily stats, and top purposes.

  export function getCallMetrics(): CallMetrics {
    const now = new Date();
    const calls = Array.from(activeCalls.values()).concat(
      conversationHistory.map(h => ({
        callId: h.callId,
        status: 'completed' as const,
        lastUpdate: now.toISOString(),
        usuario: '',
        telefono: '',
        proposito: ''
      }))
    );
    
    const totalCalls = calls.length;
    const successfulCalls = calls.filter(c => c.status === 'completed').length;
    const failedCalls = calls.filter(c => c.status === 'failed').length;
    
    const durations = calls.filter(c => c.duration).map(c => c.duration!);
    const averageDuration = durations.length > 0 
      ? durations.reduce((a, b) => a + b, 0) / durations.length 
      : 0;
    
    const callsByStatus = calls.reduce((acc, call) => {
      acc[call.status] = (acc[call.status] || 0) + 1;
      return acc;
    }, {} as Record<CallStatus['status'], number>);
    
    // Stats diarias (últimos 7 días)
    const dailyStats = [];
    for (let i = 6; i >= 0; i--) {
      const date = new Date(now);
      date.setDate(date.getDate() - i);
      const dateStr = date.toISOString().split('T')[0];
      
      const dayCalls = calls.filter(c => 
        c.lastUpdate.startsWith(dateStr)
      );
      
      const dayDurations = dayCalls.filter(c => c.duration).map(c => c.duration!);
      const dayAvgDuration = dayDurations.length > 0 
        ? dayDurations.reduce((a, b) => a + b, 0) / dayDurations.length 
        : 0;
      
      dailyStats.push({
        date: dateStr,
        calls: dayCalls.length,
        successRate: dayCalls.length > 0 
          ? dayCalls.filter(c => c.status === 'completed').length / dayCalls.length * 100 
          : 0,
        averageDuration: dayAvgDuration
      });
    }
    
    // Top propósitos
    const purposeCounts: Record<string, number> = {};
    calls.forEach(call => {
      if (call.proposito) {
        purposeCounts[call.proposito] = (purposeCounts[call.proposito] || 0) + 1;
      }
    });
    
    const topPurposes = Object.entries(purposeCounts)
      .map(([proposito, count]) => ({ proposito, count }))
      .sort((a, b) => b.count - a.count)
      .slice(0, 5);
    
    return {
      totalCalls,
      successfulCalls,
      failedCalls,
      averageDuration,
      callsByStatus,
      dailyStats,
      topPurposes
    };
  }

• tools/realtime-assistant.ts:158-185 (helper)

  Helper wrapper getCallMetrics() that invokes the operations-level getCallMetrics() and adds successRate calculation to the returned metrics.

  export async function getCallMetrics(): Promise<{
    totalCalls: number;
    successfulCalls: number;
    failedCalls: number;
    averageDuration: number;
    successRate: number;
    dailyStats: Array<{
      date: string;
      calls: number;
      successRate: number;
      averageDuration: number;
    }>;
    topPurposes: Array<{
      proposito: string;
      count: number;
    }>;
  }> {
    const metrics = phoneOps.getCallMetrics();
    
    const successRate = metrics.totalCalls > 0 
      ? (metrics.successfulCalls / metrics.totalCalls) * 100 
      : 0;
  
    return {
      ...metrics,
      successRate: Math.round(successRate * 100) / 100
    };
  }