Capacidades

Descubre qué puede hacer el servidor MCP de cuenta de Trophy.

Una vez conectado, el servidor MCP de cuenta expone herramientas que tu agente puede llamar para inspeccionar y gestionar tu cuenta.

La mayoría de los recursos de configuración ofrecen herramientas de lectura y escritura emparejadas:

• Las herramientas de lectura listan y obtienen recursos
• Las herramientas de escritura crean o actualizan recursos por lotes para agilizar las operaciones

​

Referencia de herramientas

La lista completa de herramientas disponibles en el servidor MCP de cuenta de Trophy.

​

Herramientas de métricas

Crea y gestiona las Métricas que impulsan las rachas, los logros, los puntos y las clasificaciones.

Herramienta	Qué hace
read_metrics	Lista métricas u obtiene una métrica concreta por ID
write_metrics	Crea o actualiza métricas

​

Herramientas de atributos

Gestiona los atributos personalizados de usuario y los atributos personalizados de evento que se usan para la segmentación de funcionalidades y la personalización.

Herramienta	Qué hace
read_attributes	Lista atributos u obtiene un atributo concreto por ID
write_attributes	Crea o actualiza atributos

​

Herramientas de logros

Configura los Logros y consulta las analíticas de finalización de tu cuenta.

Herramienta	Qué hace
read_achievements	Lista logros u obtiene un logro concreto por ID
write_achievements	Crea o actualiza logros
read_achievements_analytics	Lista logros con recuentos de finalización y rareza; opcionalmente, filtra por user_attributes

​

Herramientas de clasificaciones

Configura las Clasificaciones y consulta las posiciones en tiempo real.

Herramienta	Qué hace
read_leaderboards	Lista clasificaciones u obtiene una clasificación concreta por ID
write_leaderboards	Crea o actualiza clasificaciones
read_leaderboard_rankings	Obtiene una clasificación con posiciones en tiempo real por clave (paginación opcional, fecha de ejecución, centrado en el usuario y filtros de atributos)

​

Herramientas de Puntos

Configura sistemas completos de Puntos, incluidos los Disparadores, los Niveles y los Potenciadores, y consulta las analíticas de distribución.

Herramienta	Qué hace
read_points_systems	Lista los sistemas de puntos u obtiene uno por ID
write_points_systems	Crea o actualiza sistemas de puntos (opcionalmente con disparadores, niveles y potenciadores anidados)
read_points_triggers	Lista u obtiene los disparadores de un sistema de puntos
write_points_triggers	Crea o actualiza los disparadores de un sistema de puntos
read_points_levels	Lista u obtiene los niveles de un sistema de puntos
write_points_levels	Crea o actualiza los niveles de un sistema de puntos
read_points_boosts	Lista u obtiene los potenciadores de un sistema de puntos
write_points_boosts	Crea o actualiza los potenciadores de un sistema de puntos
read_points_analytics	Distribución de puntos y desglose por niveles de un sistema (summary o level_summary; user_attributes opcional en el resumen)

​

Herramientas de Clientes

Gestiona los registros de organizaciones multicliente cuando la función multicliente está habilitada en tu cuenta.

Herramienta	Qué hace
read_tenants	Lista clientes u obtiene un cliente concreto por ID
write_tenants	Crea o actualiza clientes

Si la función multicliente no está habilitada en tu cuenta, estas herramientas no funcionarán.

​

Herramientas de entornos

Lista los entornos de tu cuenta de Trophy.

Herramienta	Qué hace
read_environments	Lista todos los entornos activos ordenados por prioridad (nombre, clave y prioridad; producción siempre tiene prioridad 1)

​

Herramientas de Rachas

Consulta y ejecuta acciones operativas de Rachas para los usuarios, como conceder congelaciones de racha, crear pausas de racha, restaurar rachas, restablecer rachas, y leer o actualizar la configuración de rachas de la organización.

Herramienta	Qué hace
list_user_streaks	Obtiene la longitud de la racha (y la marca de tiempo de la última extensión) de hasta 100 usuarios, ordenados de mayor a menor longitud
grant_streak_freezes	Concede congelaciones de racha a uno o más usuarios
restore_streaks	Restaura una racha interrumpida a su longitud anterior
reset_streaks	Restablece a cero las rachas de uno o más usuarios (hasta 100 por solicitud)
create_streak_pauses	Crea pausas de racha para usuarios en un intervalo de fechas (hasta 100 por solicitud)
delete_streak_pauses	Elimina pausas de racha por ID (hasta 100 por solicitud)
get_streak_settings	Obtiene la configuración de rachas de la organización (frecuencia, modo de evaluación, métricas, días libres, congelaciones)
update_streak_settings	Actualiza la configuración de rachas de la organización

​

Herramientas de configuración

Lee y actualiza la configuración de la organización, incluidas la marca, la experimentación y el período de agregación.

Herramienta	Qué hace
get_settings	Obtiene la configuración de marca, experimentación y período de agregación
update_settings	Actualiza la configuración de marca, experimentación y período de agregación

​

Ejemplos de prompts

Usa lenguaje natural: tu agente elige la herramienta y los parámetros adecuados:

Create an XP system called 'Kudos' that grants 10 points for each workout completed.

Schedule 2X XP boosts for the 'Kudos' system across the next 3 weekends (only for paying users - 'plan' attribute is 'pro').

List all achievements, completion rates and rarity in my Trophy account.

Get the top 20 rankings for leaderboard weekly-workouts this week.

Summarize the Kudos points distribution for pro users.

What are the current streak lengths for users user_123 and user_456?

Grant two streak freezes to user user_123.

user_123 wants their streak back, restore it to its previous length.

Reset the streaks for user_123 and user_456 to zero.

Create a streak pause for user_123 from 2026-09-15 to 2026-09-22 while they're on holiday.

What is our current streak configuration, and set freezes to start with 1 and max out at 3?

Create an achievement called 'First Workout' that unlocks when users complete 1 workout.

Update our brand color to #0F766E and set the aggregation period to weekly.

​

Alcance y seguridad

• El acceso se limita a la organización de Trophy que autorizas durante OAuth.
• Las herramientas actúan sobre un entorno específico. Si la cuenta solo tiene uno, las llamadas a las herramientas lo usan por defecto (normalmente production). Si hay varios, pasa la clave environment que quieras, o usa read_environments para listarlos y elegir.
• Cuando la multitenencia está habilitada, las herramientas también pueden limitarse a un cliente. Si solo hay un cliente activo, las llamadas a las herramientas pueden usarlo por defecto. Si hay varios, pasa el id de tenant que quieras, o usa read_tenants para listarlos y elegir.
• Las herramientas de escritura pueden modificar la configuración en producción. Es preferible usar un entorno de staging o sandbox mientras iteras.
• La mayoría de las herramientas no pueden eliminar recursos. La excepción es delete_streak_pauses, que elimina pausas de racha por ID.
• reset_streaks restablece a cero las rachas actuales de los usuarios. Usa restore_streaks si necesitas recuperar una racha después.

​

Obtener soporte

¿Quieres ponerte en contacto con el equipo de Trophy? Escríbenos por correo electrónico. ¡Estamos aquí para ayudarte!