Capacidades

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 emparejadas de lectura y escritura:

Las herramientas de lectura listan y obtienen recursos
Las herramientas de escritura crean o actualizan recursos en lote para acelerar 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 rachas, logros, puntos y clasificaciones.

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

Herramientas de atributos

Gestiona Atributos de usuario personalizados y Atributos de evento personalizados utilizados para segmentación de funcionalidades y personalización.

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

Herramientas de logros

Configura Logros y consulta análisis de completitud para tu cuenta.

Herramienta	Qué hace
`read_achievements`	Lista logros, u obtiene un logro individual por ID
`write_achievements`	Crea o actualiza logros
`read_achievements_analytics`	Lista logros con conteos de completitud y rareza; opcionalmente filtra por `user_attributes`

Herramientas de clasificaciones

Configura Clasificaciones y consulta rankings en vivo.

Herramienta	Qué hace
`read_leaderboards`	Listar clasificaciones o obtener una clasificación individual por ID
`write_leaderboards`	Crear o actualizar clasificaciones
`read_leaderboard_rankings`	Obtener una clasificación con rankings en vivo por clave (paginación, fecha de ejecución, centrado de usuario y filtros de atributos opcionales)

Herramientas de Puntos

Configure sistemas completos de Puntos, incluyendo Desencadenadores, Niveles y Impulsos, y consulte análisis de distribución.

Herramienta	Qué hace
`read_points_systems`	Listar sistemas de puntos u obtener uno por ID
`write_points_systems`	Crear o actualizar sistemas de puntos (opcionalmente con desencadenadores, niveles e impulsos anidados)
`read_points_triggers`	Listar u obtener desencadenadores de un sistema de puntos
`write_points_triggers`	Crear o actualizar desencadenadores de un sistema de puntos
`read_points_levels`	Listar u obtener niveles de un sistema de puntos
`write_points_levels`	Crear o actualizar niveles de un sistema de puntos
`read_points_boosts`	Listar u obtener impulsos de un sistema de puntos
`write_points_boosts`	Crear o actualizar impulsos de un sistema de puntos
`read_points_analytics`	Distribución de puntos y desglose de niveles para un sistema (`summary` o `level_summary`; `user_attributes` opcional en el resumen)

Herramientas de Clientes

Gestione registros de organizaciones Multi-Cliente cuando la funcionalidad multi-cliente esté habilitada en su cuenta.

Herramienta	Qué hace
`read_tenants`	Listar clientes u obtener un cliente individual por ID
`write_tenants`	Crear o actualizar clientes

Si la funcionalidad multi-cliente no está habilitada en su cuenta, estas herramientas no funcionarán.

Herramientas de Entornos

Lista los Entornos en tu cuenta de Trophy.

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

Herramientas de Rachas

Consulta y ejecuta acciones operativas de Rachas para usuarios, incluyendo la concesión de Congelaciones de Racha, creación de Pausas de Racha, restauración de rachas, y lectura o actualización de 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) para hasta 100 usuarios, clasificados de mayor a menor
`grant_streak_freezes`	Concede congelaciones de racha a uno o más usuarios
`restore_streaks`	Restaura una racha rota a su longitud anterior
`create_streak_pauses`	Crea pausas de racha para usuarios durante un rango 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, incluyendo Marca, Experimentación y 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 Instrucciones

Usa lenguaje natural — tu agente selecciona la herramienta y los parámetros correctos:

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.

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 está limitado a la organización de Trophy que autorices durante OAuth.
Las herramientas actúan en un entorno específico. Si la cuenta tiene solo uno, las llamadas de herramienta usan ese por defecto (normalmente production). Si hay múltiples, pasa la clave environment que desees, o usa read_environments para listarlos y elegir.
Cuando la multi-tenencia está habilitada, las herramientas también pueden estar limitadas a un cliente. Si hay solo un cliente activo, las llamadas de herramienta pueden usar ese por defecto. Si hay múltiples, pasa el id tenant que desees, o usa read_tenants para listarlos y elegir.
Las herramientas de escritura pueden cambiar la configuración en producción. Prefiere un entorno de staging o sandbox cuando estés iterando.
La mayoría de las herramientas no pueden eliminar recursos. La excepción es delete_streak_pauses, que elimina pausas de racha por ID.

Obtener soporte

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

Primeros pasos

Servidor MCP de docs

Servidor MCP de cuenta

Referencia de herramientas

Herramientas de métricas

Herramientas de atributos

Herramientas de logros

Herramientas de clasificaciones

Herramientas de Puntos

Herramientas de Clientes

Herramientas de Entornos

Herramientas de Rachas

Herramientas de Configuración

Ejemplos de Instrucciones

Alcance y seguridad

Obtener soporte

​Referencia de herramientas

​Herramientas de métricas

​Herramientas de atributos

​Herramientas de logros

​Herramientas de clasificaciones

​Herramientas de Puntos

​Herramientas de Clientes

​Herramientas de Entornos

​Herramientas de Rachas

​Herramientas de Configuración

​Ejemplos de Instrucciones

​Alcance y seguridad

​Obtener soporte

Referencia de herramientas

Herramientas de métricas

Herramientas de atributos

Herramientas de logros

Herramientas de clasificaciones

Herramientas de Puntos

Herramientas de Clientes

Herramientas de Entornos

Herramientas de Rachas

Herramientas de Configuración

Ejemplos de Instrucciones

Alcance y seguridad

Obtener soporte