Recursos MCP

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.

Campañas

URIDescripción
southgames://campaignsLista de campañas (límite 50, orden por fecha)
southgames://campaigns/{campaignId}Detalle de una campaña
southgames://campaigns/{campaignId}/statsEstadísticas: plays, wins, códigos generados/canjeados

Códigos Promo

URIDescripción
southgames://promo-codesLista de códigos promo (límite 50)

Analytics

Todos los recursos de analytics usan los últimos 30 días como ventana de tiempo por defecto.

URIDescripción
southgames://analytics/overviewKPIs principales: plays, clientes únicos, conversiones
southgames://analytics/games-over-timeSeries temporales de sesiones de juego
southgames://analytics/top-campaignsTop 10 campañas por sesiones
southgames://analytics/game-type-breakdownDesglose de sesiones por tipo de juego
southgames://analytics/engagementMétricas de engagement y comparativa
southgames://analytics/client-dashboard/{clientId}Dashboard consolidado de un cliente

Clientes y Segmentos

URIDescripción
southgames://clientsLista de clientes (límite 50, orden por última actividad)
southgames://clients/{clientId}Perfil completo del cliente (XP, tier, puntos, geo, etc.)
southgames://segmentsLista de segmentos definidos
southgames://segments/{segmentId}Detalle de un segmento con sus reglas

Notificaciones

URIDescripción
southgames://notifications/push-sendsHistorial de envíos push (límite 20)
southgames://notifications/in-appLista de notificaciones in-app
southgames://notifications/templatesTemplates de notificaciones

Eventos

URIDescripción
southgames://events/definitionsCatá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

URIDescripción
southgames://tiers/configConfiguración de tiers (nombres, XP requerido, beneficios)
southgames://tiers/client/{clientId}Tier y XP actual de un cliente
southgames://tiers/distributionDistribución de clientes por tier

Puntos

URIDescripción
southgames://points/configConfiguración del programa de puntos
southgames://points/client/{clientId}/balanceSaldo de puntos de un cliente
southgames://points/client/{clientId}/ledgerHistorial de transacciones (límite 50)
southgames://points/rewardsCatálogo de rewards disponibles
southgames://points/statsEstadísticas globales del programa
southgames://points/top-earnersTop 10 clientes por puntos acumulados

Journeys

URIDescripción
southgames://journeysLista de journeys/automatizaciones (límite 50)
southgames://journeys/{journeyId}Detalle incluyendo nodos y edges
southgames://journeys/{journeyId}/enrollmentsClientes enrollados (límite 50)
southgames://journeys/{journeyId}/analyticsDistribución por nodo y conversión

Misiones

URIDescripción
southgames://missionsLista de misiones (límite 50)
southgames://missions/{missionId}Detalle de una misión
southgames://missions/{missionId}/analyticsAnalytics de completions
southgames://missions/{missionId}/progressProgreso de clientes (límite 50)

Rankings

URIDescripción
southgames://rankings/leaderboardTop 20 del leaderboard global
southgames://rankings/configConfiguración de pesos del ranking

Referidos

URIDescripción
southgames://referrals/configConfiguración del programa de referidos
southgames://referralsLista de referidos (límite 50)
southgames://referrals/statsEstadísticas: total, conversiones, top referrers

Configuración

URIDescripción
southgames://settings/orgPerfil 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.