@retainq/mcp

Servidor MCP de RetainQ — Conecta asistentes de IA a tu plataforma de reducción de churn.

¿Qué es esto?

Este es un servidor de Model Context Protocol (MCP) para RetainQ. Permite que los asistentes de IA (como Claude, Cursor, Kiro, etc.) interactúen con tu espacio de trabajo de RetainQ — consultar métricas de retención, gestionar flujos, analizar datos de churn y más.

Related MCP server: Attio MCP Server

Instalación

npx @retainq/mcp

O instala globalmente:

npm install -g @retainq/mcp

Configuración

Variable de entorno

Configura tu clave de API de RetainQ:

export RETAINQ_API_KEY=rq_live_your_key_here

Obtén una clave de API en Configuración → Claves de API en tu panel de RetainQ.

Configuración del cliente MCP

Añade a la configuración de tu cliente MCP (p. ej., Claude Desktop, Kiro, Cursor):

{
  "mcpServers": {
    "retainq": {
      "command": "npx",
      "args": ["@retainq/mcp"],
      "env": {
        "RETAINQ_API_KEY": "rq_live_your_key_here"
      }
    }
  }
}

Herramientas disponibles (32)

Analítica

• get_retention_stats — Resumen de métricas del espacio de trabajo

• get_recent_sessions — Sesiones de flujo recientes con resultados

• get_top_churn_reasons — Motivos de cancelación ordenados por frecuencia

• get_high_risk_customers — Clientes por encima del umbral de riesgo de churn

• get_offer_performance — Tasas de aceptación de ofertas e ingresos

Flujos

• list_flows — Lista todos los flujos

• get_flow — Obtén los detalles del flujo

• create_flow — Crea un nuevo flujo (simple o avanzado)

• update_flow — Actualiza los metadatos del flujo

• delete_flow — Archiva un flujo

• configure_simple_flow — Configura el flujo simple (encuesta, ofertas, comentarios, diseño)

• set_advanced_flow_schema — Configura el esquema de flujo basado en nodos

• publish_flow — Publica y activa

• get_flow_schema — Obtén el esquema publicado actual

Ofertas

• list_offers — Lista todas las ofertas de retención

• create_offer — Crea una nueva oferta

• update_offer — Actualiza la oferta

• delete_offer — Archiva la oferta

Clientes

• list_customers — Lista clientes con puntuaciones de churn

• get_customer — Obtén el cliente por correo electrónico

• get_customer_sessions — Obtén el historial de sesiones de un cliente

Oportunidades

• list_opportunities — Lista oportunidades de retención

• confirm_opportunity — Confirma/cumple una oportunidad

• reject_opportunity — Rechaza una oportunidad

Inteligencia de IA

• run_churn_analysis — Ejecuta un análisis de churn con IA

• ask_ai — Haz una pregunta a la IA de RetainQ sobre tus datos

Notificaciones

• list_notifications — Obtén notificaciones recientes

• get_notification_preferences — Obtén la configuración de notificaciones

• update_notification_preferences — Actualiza la configuración de notificaciones

Comentarios

• list_feedback — Obtén comentarios/respuestas de sesión

• export_feedback_csv — Exporta comentarios como CSV

URL base de la API

Por defecto se conecta a https://app.retainq.com/api/v1/public. Sobrescríbelo con:

export RETAINQ_API_URL=http://localhost:3000/api/v1/public

Licencia

MIT