> ## Documentation Index
> Fetch the complete documentation index at: /llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/es/features/metrics.md) 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](/es/features/users.md#custom-user-attributes) y los [atributos personalizados de evento](/es/features/events.md#custom-event-attributes) 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](/es/features/milestones.md) 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](/es/features/leaderboards.md) 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](/es/features/points.md), incluidos los [Disparadores](/es/features/points.md#points-triggers), los [Niveles](/es/features/points.md#points-levels) y los [Potenciadores](/es/features/points.md#points-boosts), 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](/es/platform/multi-tenancy.md) 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 |

> [!NOTE]
>
> Si la función multicliente no está habilitada en tu cuenta, estas herramientas no funcionarán.

### Herramientas de entornos

Lista los [entornos](/es/platform/environments.md) 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](/es/features/streaks.md) para los usuarios, como conceder [congelaciones de racha](/es/features/streaks.md#streak-freezes), crear [pausas de racha](/es/features/streaks.md#streak-pauses), [restaurar rachas](/es/features/streaks.md#restoring-a-users-streak), [restablecer rachas](/es/features/streaks.md#resetting-a-users-streak), 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](/es/context/brand-kit.md), la [experimentación](/es/platform/experimentation.md) 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:

```text theme={null}
Create an XP system called 'Kudos' that grants 10 points for each workout completed.
```

```text theme={null}
Schedule 2X XP boosts for the 'Kudos' system across the next 3 weekends (only for paying users - 'plan' attribute is 'pro').
```

```text theme={null}
List all achievements, completion rates and rarity in my Trophy account.
```

```text theme={null}
Get the top 20 rankings for leaderboard weekly-workouts this week.
```

```text theme={null}
Summarize the Kudos points distribution for pro users.
```

```text theme={null}
What are the current streak lengths for users user_123 and user_456?
```

```text theme={null}
Grant two streak freezes to user user_123.
```

```text theme={null}
user_123 wants their streak back, restore it to its previous length.
```

```text theme={null}
Reset the streaks for user_123 and user_456 to zero.
```

```text theme={null}
Create a streak pause for user_123 from 2026-09-15 to 2026-09-22 while they're on holiday.
```

```text theme={null}
What is our current streak configuration, and set freezes to start with 1 and max out at 3?
```

```text theme={null}
Create an achievement called 'First Workout' that unlocks when users complete 1 workout.
```

```text theme={null}
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](/es/platform/environments.md) 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](/es/platform/multi-tenancy.md) está habilitada, las herramientas también pueden limitarse a un [cliente](/es/platform/multi-tenancy.md). 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](/es/platform/environments.md) 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](mailto:support@trophy.so). ¡Estamos aquí para ayudarte!


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.