Referencia completa de los recursos disponibles en el servidor MCP de SouthGames.
El servidor MCP expone los siguientes recursos bajo el esquema southgames://.
Todos son de solo lectura y están limitados a los datos de tu organización.
Series temporales de los dominios que no cubren los recursos de analytics, respaldadas por el rollup nocturno (metricsDaily). Ventana de últimos 30 días (buckets UTC); pueden tener hasta ~24h de retraso (freshness: "daily-rollup").
URI
Descripción
southgames://metrics/overview
Totales de 30 días de todos los dominios del rollup (códigos, puntos, push, journeys, marketplace)
southgames://metrics/codes
Códigos emitidos vs canjeados por día + tasa de canje
southgames://metrics/push
Entrega push por día (enviadas/entregadas/clicks) + tasas
southgames://metrics/journeys
Inscripciones a journeys por día
southgames://metrics/marketplace
Compras y revenue (USD) del marketplace por día
southgames://metrics/points-timeseries
Puntos emitidos vs gastados por día (complementa points/stats)
Clientes y Segmentos
URI
Descripción
southgames://clients
Lista de clientes (límite 50, orden por última actividad)
southgames://clients/{clientId}
Perfil completo del cliente (XP, tier, puntos, geo, etc.)
southgames://segments
Lista de segmentos definidos
southgames://segments/{segmentId}
Detalle de un segmento con sus reglas
Notificaciones
URI
Descripción
southgames://notifications/push-sends
Historial de envíos push (límite 20)
southgames://notifications/in-app
Lista de notificaciones in-app
southgames://notifications/templates
Templates de notificaciones
Eventos
URI
Descripción
southgames://events/definitions
Catálogo de eventos con conteos totales
southgames://events/recent
Últimos 50 eventos trackeados
southgames://events/by-client/{clientId}
Eventos de un cliente específico (límite 50)
Tiers
URI
Descripción
southgames://tiers/config
Configuración de tiers (nombres, XP requerido, beneficios)
southgames://tiers/client/{clientId}
Tier y XP actual de un cliente
southgames://tiers/distribution
Distribución de clientes por tier
Puntos
URI
Descripción
southgames://points/config
Configuración del programa de puntos
southgames://points/client/{clientId}/balance
Saldo de puntos de un cliente
southgames://points/client/{clientId}/ledger
Historial de transacciones (límite 50)
southgames://points/rewards
Catálogo de rewards disponibles
southgames://points/stats
Estadísticas globales del programa
southgames://points/top-earners
Top 10 clientes por puntos acumulados
Journeys
URI
Descripción
southgames://journeys
Lista de journeys/automatizaciones (límite 50)
southgames://journeys/{journeyId}
Detalle incluyendo nodos y edges
southgames://journeys/{journeyId}/enrollments
Clientes enrollados (límite 50)
southgames://journeys/{journeyId}/analytics
Distribución por nodo y conversión
Misiones
URI
Descripción
southgames://missions
Lista de misiones (límite 50)
southgames://missions/{missionId}
Detalle de una misión
southgames://missions/{missionId}/analytics
Analytics de completions
southgames://missions/{missionId}/progress
Progreso de clientes (límite 50)
Rankings
URI
Descripción
southgames://rankings/leaderboard
Top 20 del leaderboard global
southgames://rankings/config
Configuración de pesos del ranking
Referidos
URI
Descripción
southgames://referrals/config
Configuración del programa de referidos
southgames://referrals
Lista de referidos (límite 50)
southgames://referrals/stats
Estadísticas: total, conversiones, top referrers
Configuración
URI
Descripción
southgames://settings/org
Perfil de la organización (nombre, slug, plan, timezone)
Todos los recursos retornan JSON con mimeType: "application/json". Los campos sensibles
(credenciales, API keys, webhooks) no están expuestos.
