diff --git a/es/mcp/account-mcp-server/capabilities.mdx b/es/mcp/account-mcp-server/capabilities.mdx index b502032..7fe3c88 100644 --- a/es/mcp/account-mcp-server/capabilities.mdx +++ b/es/mcp/account-mcp-server/capabilities.mdx @@ -1,138 +1,169 @@ --- title: Capacidades -description: Aprende qué puede hacer el servidor MCP de Trophy Account. -og:description: Aprende qué puede hacer el servidor MCP de Trophy Account. +description: Aprende qué puede hacer el servidor MCP de cuenta de Trophy. +og:description: Aprende qué puede hacer el servidor MCP de cuenta de Trophy. icon: wrench --- -Una vez conectado, el servidor MCP de Account expone herramientas que tu agente puede llamar para inspeccionar y gestionar tu cuenta. +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: +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 acelerar las operaciones +- Las herramientas **de lectura** listan y obtienen recursos +- Las herramientas **de escritura** crean o actualizan recursos por lotes para acelerar las operaciones ## Referencia de herramientas {#tool-reference} -La lista completa de herramientas disponibles en el servidor MCP de Trophy Account. +La lista completa de herramientas disponibles en el servidor MCP de cuenta de Trophy. -### Herramientas de Métricas {#metrics-tools} +### Herramientas de métricas {#metrics-tools} Crea y gestiona las [Métricas](/es/features/metrics) que impulsan rachas, logros, puntos y clasificaciones. | Herramienta | Qué hace | | --- | --- | -| `read_metrics` | Lista métricas u obtiene una métrica específica por ID | +| `read_metrics` | Lista métricas u obtiene una métrica individual por ID | | `write_metrics` | Crea o actualiza métricas | ### Herramientas de atributos {#attributes-tools} -Gestiona [atributos de usuario personalizados](/es/features/users#custom-user-attributes) y [atributos de eventos personalizados](/es/features/events#custom-event-attributes) utilizados para segmentación de funcionalidades y personalización. +Gestiona [Atributos de usuario personalizados](/es/features/users#custom-user-attributes) y [Atributos de evento personalizados](/es/features/events#custom-event-attributes) utilizados para segmentación de funcionalidades y personalización. | Herramienta | Qué hace | | --- | --- | -| `read_attributes` | Lista atributos u obtiene un atributo específico por ID | +| `read_attributes` | Lista atributos u obtiene un atributo individual por ID | | `write_attributes` | Crea o actualiza atributos | -### Herramientas de Logros {#achievements-tools} +### Herramientas de logros {#achievements-tools} -Lee [Logros](/es/features/achievements) y analíticas de finalización de tu cuenta. +Configura [Logros](/es/features/achievements) y lee analíticas de finalización para tu cuenta. | Herramienta | Qué hace | | --- | --- | -| `read_achievements` | Lista logros con conteos de finalización y rareza; opcionalmente filtra por `user_attributes` | +| `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 finalización y rareza; opcionalmente filtra por `user_attributes` | -### Herramientas de Clasificaciones {#leaderboards-tools} +### Herramientas de clasificaciones {#leaderboards-tools} -Configura [Clasificaciones](/es/features/leaderboards) y lee rankings en vivo. +Configura [Clasificaciones](/es/features/leaderboards) y lee clasificaciones en vivo. | Herramienta | Qué hace | | --- | --- | -| `read_leaderboards` | Lista clasificaciones u obtiene una clasificación específica por ID | -| `write_leaderboards` | Crea o actualiza clasificaciones | -| `read_leaderboard_rankings` | Obtiene una clasificación con rankings en vivo por clave (paginación opcional, fecha de ejecución, centrado en usuario y filtros de atributos) | +| `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 opcional, fecha de ejecución, centrado en usuario y filtros de atributos) | ### Herramientas de Puntos {#points-tools} -Configura sistemas completos de [Puntos](/es/features/points), incluyendo [Activadores](/es/features/points#points-triggers), [Niveles](/es/features/points#points-levels) y [Potenciadores](/es/features/points#points-boosts), y consulta análisis de distribución. +Configure sistemas completos de [Puntos](/es/features/points), incluyendo [Triggers](/es/features/points#points-triggers), [Niveles](/es/features/points#points-levels) y [Boosts](/es/features/points#points-boosts), y consulte análisis de distribución. | Herramienta | Qué hace | | --- | --- | -| `read_points_systems` | Lista sistemas de puntos u obtén uno por ID | -| `write_points_systems` | Crea o actualiza sistemas de puntos (opcionalmente con activadores, niveles y potenciadores anidados) | -| `read_points_triggers` | Lista u obtén activadores para un sistema de puntos | -| `write_points_triggers` | Crea o actualiza activadores para un sistema de puntos | -| `read_points_levels` | Lista u obtén niveles para un sistema de puntos | -| `write_points_levels` | Crea o actualiza niveles para un sistema de puntos | -| `read_points_boosts` | Lista u obtén potenciadores para un sistema de puntos | -| `write_points_boosts` | Crea o actualiza potenciadores para un sistema de puntos | +| `read_points_systems` | Listar sistemas de puntos u obtener uno por ID | +| `write_points_systems` | Crear o actualizar sistemas de puntos (opcionalmente con triggers, niveles y boosts anidados) | +| `read_points_triggers` | Listar u obtener triggers para un sistema de puntos | +| `write_points_triggers` | Crear o actualizar triggers para un sistema de puntos | +| `read_points_levels` | Listar u obtener niveles para un sistema de puntos | +| `write_points_levels` | Crear o actualizar niveles para un sistema de puntos | +| `read_points_boosts` | Listar u obtener boosts para un sistema de puntos | +| `write_points_boosts` | Crear o actualizar boosts para 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 {#tenants-tools} -Administra registros de organizaciones [Multi-Cliente](/es/platform/multi-tenancy) cuando la multi-tenencia esté habilitada en tu cuenta. +Administre registros de organización [Multi-Tenant](/es/platform/multi-tenancy) cuando multi-tenancy esté habilitado en su cuenta. | Herramienta | Qué hace | | --- | --- | -| `read_tenants` | Lista clientes u obtén un cliente individual por ID | -| `write_tenants` | Crea o actualiza clientes | +| `read_tenants` | Listar clientes u obtener un cliente individual por ID | +| `write_tenants` | Crear o actualizar clientes | -Si la multi-tenencia no está habilitada en tu cuenta, estas herramientas no funcionarán. +Si multi-tenancy no está habilitado en su cuenta, estas herramientas no funcionarán. ### Herramientas de Rachas {#streaks-tools} -Consulta y ejecuta acciones operativas de [Rachas](/es/features/streaks) para usuarios, incluyendo la concesión de [Congelaciones de Racha](/es/features/streaks#streak-freezes) o la [restauración de rachas](/es/features/streaks#restoring-a-users-streak). +Consulta y ejecuta acciones operacionales de [Rachas](/es/features/streaks) para usuarios, incluyendo otorgar [Congelaciones de Racha](/es/features/streaks#streak-freezes), crear [Pausas de Racha](/es/features/streaks#streak-pauses), [restaurar rachas](/es/features/streaks#restoring-a-users-streak), y leer o actualizar la configuración de rachas de la organización. | Herramienta | Qué hace | | --- | --- | -| `list_user_streaks` | Obtén la longitud de 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 interrumpida a su longitud anterior | +| `list_user_streaks` | Obtener la longitud de racha (y última marca de tiempo de extensión) para hasta 100 usuarios, clasificados por la más larga primero | +| `grant_streak_freezes` | Otorgar congelaciones de racha a uno o más usuarios | +| `restore_streaks` | Restaurar una racha rota a su longitud anterior | +| `create_streak_pauses` | Crear pausas de racha para usuarios durante un rango de fechas (hasta 100 por solicitud) | +| `delete_streak_pauses` | Eliminar pausas de racha por ID (hasta 100 por solicitud) | +| `get_streak_settings` | Obtener la configuración de rachas de la organización (frecuencia, modo de evaluación, métricas, días libres, congelaciones) | +| `update_streak_settings` | Actualizar la configuración de rachas de la organización | -## Ejemplos de prompts {#example-prompts} +### Herramientas de Configuración {#settings-tools} -Usa lenguaje natural: tu agente selecciona la herramienta y los parámetros adecuados: +Lee y actualiza la configuración de la organización, incluyendo [Branding](/es/account/branding), [Experimentación](/es/platform/experimentation) y período de agregación. + +| Herramienta | Qué hace | +| --- | --- | +| `get_settings` | Obtener la configuración de branding, experimentación y período de agregación | +| `update_settings` | Actualizar la configuración de branding, experimentación y período de agregación | + +## Ejemplos de Prompts {#example-prompts} + +Usa lenguaje natural — tu agente selecciona la herramienta y los parámetros correctos: + +```text +Crea un sistema de XP llamado 'Kudos' que otorga 10 puntos por cada entrenamiento completado. +``` + +```text +Programa potenciadores de XP 2X para el sistema 'Kudos' durante los próximos 3 fines de semana (solo para usuarios de pago - el atributo 'plan' es 'pro'). +``` + +```text +Lista todos los logros, tasas de finalización y rareza en mi cuenta de Trophy. +``` + +```text +Obtén el top 20 de rankings de la clasificación weekly-workouts de esta semana. +``` ```text -Create an XP system called 'Kudos' that grants 10 points for each workout completed. +Resume la distribución de puntos de Kudos para usuarios pro. ``` ```text -Schedule 2X XP boosts for the 'Kudos' system across the next 3 weekends (only for paying users - 'plan' attribute is 'pro'). +¿Cuáles son las longitudes de racha actuales de los usuarios user_123 y user_456? ``` ```text -List all achievements, completion rates and rarity in my Trophy account. +Otorga dos congelaciones de racha al usuario user_123. ``` ```text -Get the top 20 rankings for leaderboard weekly-workouts this week. +user_123 quiere recuperar su racha, restáurala a su longitud anterior. ``` ```text -Summarize the Kudos points distribution for pro users. +Crea una pausa de racha para user_123 desde 2026-09-15 hasta 2026-09-22 mientras está de vacaciones. ``` ```text -What are the current streak lengths for users user_123 and user_456? +¿Cuál es nuestra configuración actual de rachas, y configura las congelaciones para empezar con 1 y un máximo de 3? ``` ```text -Grant two streak freezes to user user_123. +Crea un logro llamado 'Primer Entrenamiento' que se desbloquea cuando los usuarios completan 1 entrenamiento. ``` ```text -user_123 wants their streak back, restore it to its previous length. +Actualiza nuestro color de marca a #0F766E y configura el período de agregación en semanal. ``` -## Alcance y seguridad {#scope-and-safety} +## Alcance y Seguridad {#scope-and-safety} -- Las herramientas solo actuarán sobre el [entorno](/es/platform/environments) de Trophy asociado a la clave de API que proporciones en `x-trophy-api-key`. -- Las herramientas de escritura pueden modificar la configuración activa. Usa un [entorno](/es/platform/environments) de pruebas o sandbox al iterar. -- Las herramientas no pueden eliminar recursos. +- Las herramientas solo actuarán en el [entorno](/es/platform/environments) de Trophy vinculado a la clave de API que pases en `x-trophy-api-key`. +- Las herramientas de escritura pueden cambiar la configuración en producción. Prefiere un [entorno](/es/platform/environments) de staging o sandbox al iterar. +- 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 {#get-support} +## Obtener Soporte {#get-support} -¿Quieres ponerte en contacto con el equipo de Trophy? Escríbenos por [correo electrónico](mailto:support@trophy.so). ¡Estamos aquí para ayudarte! +¿Quieres ponerte en contacto con el equipo de Trophy? Contáctanos por [correo electrónico](mailto:support@trophy.so). ¡Estamos aquí para ayudarte! diff --git a/es/mcp/account-mcp-server/introduction.mdx b/es/mcp/account-mcp-server/introduction.mdx index be76684..c6fce69 100644 --- a/es/mcp/account-mcp-server/introduction.mdx +++ b/es/mcp/account-mcp-server/introduction.mdx @@ -1,11 +1,11 @@ --- title: Introducción -description: Aprende sobre el servidor MCP de cuenta y por qué existe para agentes de IA. +description: Conoce el servidor Account MCP y por qué existe para agentes de IA. subtitle: Proporciona a los agentes de IA acceso seguro y estructurado a tu cuenta de Trophy. --- -El servidor MCP de cuenta es un servidor remoto de [Model Context Protocol](https://modelcontextprotocol.io) que permite a los agentes de IA leer y gestionar la configuración de gamificación en tu cuenta de Trophy. +El servidor Account MCP es un servidor remoto de [Model Context Protocol](https://modelcontextprotocol.io) que permite a los agentes de IA leer y gestionar la configuración de gamificación en tu cuenta de Trophy. En lugar de copiar y pegar clics del panel de control en el chat, puedes pedirle a tu agente que inspeccione Métricas, cree sistemas de Puntos, actualice Clasificaciones, restaure Rachas y más. @@ -13,31 +13,31 @@ En lugar de copiar y pegar clics del panel de control en el chat, puedes pedirle https://mcp.trophy.so ``` -## ¿Por qué el MCP de cuenta? {#why-the-account-mcp} +## ¿Por qué el Account MCP? {#why-the-account-mcp} -Los agentes de programación con IA ya son donde los equipos diseñan y envían trabajo de producto, y Trophy ha simplificado esto al proporcionar infraestructura preconstruida para crear funciones comunes de gamificación. Sin embargo, esto implica en gran medida mirar pantallas y hacer clic en botones. +Los agentes de IA para programación ya son donde los equipos diseñan y entregan trabajo de producto, y Trophy ha simplificado esto proporcionando infraestructura prediseñada para construir funciones comunes de gamificación. Sin embargo, esto implica en gran medida mirar pantallas y hacer clic en botones. -El servidor MCP de cuenta es la **capa de acción**: después de que el agente comprende *qué* construir (a menudo a través del [servidor MCP de documentación](/es/mcp/docs-mcp-server/introduction)), puede descubrir la configuración de cuenta en vivo, realizar cambios específicos y validar resultados sin que un humano toque el panel de control. +El servidor Account MCP es la **capa de acción**: después de que el agente comprende *qué* construir (a menudo a través del [servidor Docs MCP](/es/mcp/docs-mcp-server/introduction)), puede descubrir la configuración activa de la cuenta, realizar cambios específicos y validar resultados sin que un humano toque el panel de control. -Esto abre un nuevo flujo de trabajo para los equipos donde los agentes pueden razonar sobre qué funciones de gamificación construir, entender cómo mapear eso a las funciones de Trophy y configurar una cuenta de Trophy que logre todo esto dentro del chat. +Esto abre un nuevo flujo de trabajo para equipos donde los agentes pueden razonar sobre qué funciones de gamificación construir, entender cómo mapear eso a las funciones de Trophy, y configurar una cuenta de Trophy que logre todo esto dentro del chat. Los flujos de trabajo típicos incluyen: -- Estructurar Métricas, atributos y sistemas de Puntos mientras se integra Trophy en una nueva aplicación +- Estructurar Métricas, atributos y sistemas de Puntos al integrar Trophy en una nueva aplicación - Inspeccionar Clasificaciones existentes o configuración de Puntos antes de cambiar código de producción -- Ejecutar tareas operativas como otorgar congelaciones o restaurar Rachas desde el chat +- Ejecutar tareas operativas como conceder congelaciones o restaurar Rachas desde el chat -## Cómo funciona {#how-it-works} +## Cómo Funciona {#how-it-works} -Trophy aloja un endpoint MCP remoto. Lo instalas una vez en tu cliente MCP, te autenticas con una clave API de administrador desde la [página de integraciones](https://app.trophy.so/integration) bajo una configuración `headers` (`x-trophy-api-key`), y el cliente expone herramientas que tu agente puede llamar. +Trophy aloja un endpoint MCP remoto. Lo instalas una vez en tu cliente MCP, te autentícas con una clave API de administrador desde la [página de integraciones](https://app.trophy.so/integration) bajo una configuración `headers` (`x-trophy-api-key`), y el cliente expone herramientas que tu agente puede llamar. -Estas herramientas corresponden a operaciones de cuenta: list/get para descubrimiento, create/update para configuración, y acciones dedicadas para congelaciones de Racha, restauraciones y lectura de analíticas. +Estas herramientas corresponden a operaciones de cuenta: list/get para descubrimiento, create/update para configuración, y acciones dedicadas para congelaciones de rachas, pausas, restauraciones, configuración y lectura de analíticas. - El servidor MCP de cuenta está diseñado para flujos de trabajo basados en chat y agentes. Para scripts, trabajos backend o integraciones de producción, utiliza la [API de administración](/es/admin-api/introduction). + El servidor MCP de cuenta está diseñado para flujos de trabajo basados en chat y agentes. Para scripts, trabajos de backend o integraciones de producción, utiliza la [API de administración](/es/admin-api/introduction). -## Primeros pasos {#get-started} +## Comenzar {#get-started} diff --git a/i18n.lock b/i18n.lock index 27be8e0..939fd63 100644 --- a/i18n.lock +++ b/i18n.lock @@ -6887,7 +6887,7 @@ checksums: content/8: 4dbd81c88de2273aaa12ab8e0294765a content/9: 839bd034255a2a23d49c972f402d243e content/10: 56bf739dd893db8de60e998aab963c1e - content/11: 643eddb9a6d5582db7a57caf0016d00e + content/11: 949a1ce6eeee49cbdf75166b63af7951 content/12: 894331d40abb73ee47109ed45fd1e3c5 content/13: 661e97346571e3f16d7b8aaf91b7be9f content/14: a1ec0d0cf898e52f83fc6592288b5f6d @@ -6947,8 +6947,8 @@ checksums: content/9: b8d375c4c3435ddefd3775788a4b2a34 content/10: bd85affdaf880752aeeb4cf3d36dba8d content/11: 60739acdab57c4dd6ebb9d59134e3f7e - content/12: c69c0d29e5d7afefa7806eab4eed179f - content/13: bd4d420741b6ed836a32509ef1f12f81 + content/12: 10606835a27785ceeefecc03cb56f6fe + content/13: 1180137ebc4a473382af6f3bf80a8c18 content/14: 6d0c5877625a7c01094632c2ca27aeb0 content/15: ffd669a767604d70d717ab006c941118 content/16: ae08379c28ebd8280befbac790370559 @@ -6960,22 +6960,29 @@ checksums: content/22: c3b7e444bfe4ba4de2a4ebb338a99783 content/23: 906326b6e07826e34997c7e74858b04b content/24: 272a90796e7e3397baab13f3ca781e5c - content/25: 6b8be67f0dd65856e874511da198d90e - content/26: b9be8baa3cdb99d3bb51596d86def07c - content/27: 30013b95bd839ef992b233407dcfef82 - content/28: df2706de4f3315b291837446b0d7c0d6 - content/29: c98b6438d30b43ed6f280cef4cb1692c - content/30: 933b2903effb251282d947f941b63f3c - content/31: 7fd9662dfb12dd16f85f0dff564dbabd - content/32: 2fd9d7f5602d2ef566dfa121145c7496 - content/33: 1afec1e392e0496d4782bc4cca2786c5 - content/34: b8568fa5375e6ed038dc2c99bb7147e2 - content/35: 419d6be21d20157b54608511f2dfe724 - content/36: 6985387a741e8e465ddc4bf3f8b338a3 - content/37: 1df98519caec0282fe7b984ffd11efb9 - content/38: a99d6101e30525bbeaecd8141f4f73d3 - content/39: 10e8e9a59847ddd720c6d06b12c7b120 - content/40: 9799b973234bf2d10d5c971b267f55a5 + content/25: ce9b52d1f0fddd252c51bae43ecc6993 + content/26: 8d162ba5232a3c7a4ac9390b3535caaf + content/27: 1347350b3967531f1b5ec06ab9f58935 + content/28: 5b207a184a7047a0bcee99a654321695 + content/29: 1b5723f7c8275a52a808cb105aa04823 + content/30: 30013b95bd839ef992b233407dcfef82 + content/31: df2706de4f3315b291837446b0d7c0d6 + content/32: c98b6438d30b43ed6f280cef4cb1692c + content/33: 933b2903effb251282d947f941b63f3c + content/34: 7fd9662dfb12dd16f85f0dff564dbabd + content/35: 2fd9d7f5602d2ef566dfa121145c7496 + content/36: 1afec1e392e0496d4782bc4cca2786c5 + content/37: b8568fa5375e6ed038dc2c99bb7147e2 + content/38: 419d6be21d20157b54608511f2dfe724 + content/39: 6985387a741e8e465ddc4bf3f8b338a3 + content/40: 7d96a55c06199ab4ae5cb368cac67a86 + content/41: 154ac84fcc2954cc8d0c296690cb9e9c + content/42: 971c4b437f7c3b6c1087bd063f86b13b + content/43: 15e604d376406bf7724bd5fb32f3e16b + content/44: 1df98519caec0282fe7b984ffd11efb9 + content/45: 29f0c3e3556fe7be2bf7419231b80f25 + content/46: 10e8e9a59847ddd720c6d06b12c7b120 + content/47: 9799b973234bf2d10d5c971b267f55a5 8526e0bfc63d38ab4ff24fc5b4332813: meta/title: 439cb79e8dfd7923d35b85cfbb6fd201 meta/description: 9a92512ff148e565070ea4b09bc7bd0f diff --git a/mcp/account-mcp-server/capabilities.mdx b/mcp/account-mcp-server/capabilities.mdx index 0a66628..767458f 100644 --- a/mcp/account-mcp-server/capabilities.mdx +++ b/mcp/account-mcp-server/capabilities.mdx @@ -36,11 +36,13 @@ Manage [Custom User Attributes](/features/users#custom-user-attributes) and [Cus ### Achievements Tools {#achievements-tools} -Read [Achievements](/features/achievements) and completion analytics for your account. +Configure [Achievements](/features/achievements) and read completion analytics for your account. | Tool | What it does | | --- | --- | -| `read_achievements` | List achievements with completion counts and rarity; optionally filter by `user_attributes` | +| `read_achievements` | List achievements, or get a single achievement by ID | +| `write_achievements` | Create or update achievements | +| `read_achievements_analytics` | List achievements with completion counts and rarity; optionally filter by `user_attributes` | ### Leaderboards Tools {#leaderboards-tools} @@ -83,13 +85,26 @@ If multi-tenancy is not enabled on your account, these tools will not function. ### Streaks Tools {#streaks-tools} -Look up and run operational [Streaks](/features/streaks) actions for users, including granting [Streak Freezes](/features/streaks#streak-freezes) or [restoring streaks](/features/streaks#restoring-a-users-streak). +Look up and run operational [Streaks](/features/streaks) actions for users, including granting [Streak Freezes](/features/streaks#streak-freezes), creating [Streak Pauses](/features/streaks#streak-pauses), [restoring streaks](/features/streaks#restoring-a-users-streak), and reading or updating organization streak settings. | Tool | What it does | | --- | --- | | `list_user_streaks` | Get streak length (and last extension timestamp) for up to 100 users, ranked longest first | | `grant_streak_freezes` | Grant streak freezes to one or more users | | `restore_streaks` | Restore a broken streak to its previous length | +| `create_streak_pauses` | Create streak pauses for users over a date range (up to 100 per request) | +| `delete_streak_pauses` | Delete streak pauses by ID (up to 100 per request) | +| `get_streak_settings` | Get organization streak configuration (frequency, evaluation mode, metrics, days off, freezes) | +| `update_streak_settings` | Update organization streak configuration | + +### Settings Tools {#settings-tools} + +Read and update organization settings, including [Branding](/account/branding), [Experimentation](/platform/experimentation), and aggregation period. + +| Tool | What it does | +| --- | --- | +| `get_settings` | Get branding, experimentation, and aggregation period settings | +| `update_settings` | Update branding, experimentation, and aggregation period settings | ## Example Prompts {#example-prompts} @@ -127,11 +142,27 @@ Grant two streak freezes to user user_123. user_123 wants their streak back, restore it to its previous length. ``` +```text +Create a streak pause for user_123 from 2026-09-15 to 2026-09-22 while they're on holiday. +``` + +```text +What is our current streak configuration, and set freezes to start with 1 and max out at 3? +``` + +```text +Create an achievement called 'First Workout' that unlocks when users complete 1 workout. +``` + +```text +Update our brand color to #0F766E and set the aggregation period to weekly. +``` + ## Scope and Safety {#scope-and-safety} - Tools will only act on the Trophy [environment](/platform/environments) tied to the API key you pass in `x-trophy-api-key`. - Write tools can change live configuration. Prefer a staging or sandbox [environment](/platform/environments) when iterating. -- Tools cannot delete resources. +- Most tools cannot delete resources. The exception is `delete_streak_pauses`, which removes streak pauses by ID. ## Get Support {#get-support} diff --git a/mcp/account-mcp-server/introduction.mdx b/mcp/account-mcp-server/introduction.mdx index b0f0d6b..59b862c 100644 --- a/mcp/account-mcp-server/introduction.mdx +++ b/mcp/account-mcp-server/introduction.mdx @@ -30,7 +30,7 @@ Typical workflows include: Trophy hosts a remote MCP endpoint. You install it once in your MCP client, authenticate with an admin API key from the [integrations page](https://app.trophy.so/integration) under a `headers` config (`x-trophy-api-key`), and the client exposes tools your agent can call. -Those tools map to account operations — list/get for discovery, create/update for configuration, and dedicated actions for streak freezes, restores and reading analytics. +Those tools map to account operations — list/get for discovery, create/update for configuration, and dedicated actions for streak freezes, pauses, restores, settings, and reading analytics. The Account MCP Server is intended for chat-based and agent workflows. For scripts, backend jobs, or production integrations, use the [Admin API](/admin-api/introduction).