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

# Herramientas para feature flags

> Herramientas MCP para feature flags, sus reglas, variaciones y variables.

Las herramientas de feature flags controlan cómo entrega un flag una funcionalidad en cada entorno. Su asistente puede activar o desactivar un flag, añadir reglas que lo desplieguen o lo prueben, y definir las variaciones y las variables tipadas que sirve el flag.

## Herramientas

### Feature flags

| Herramienta | Descripción | Prompt de ejemplo |
| - | - | - |
| `feature_flag_list` | Busque feature flags por clave, nombre o ID. | "List all feature flags for site `d1alzzxd7k`." |
| `feature_flag_get` | Recupere la configuración completa de un flag en un entorno: variaciones, variables, objetivo principal y cadena de reglas. | "Show configuration for flag `snake_game`." |
| `feature_flag_create` | Cree un flag con las variaciones predeterminadas `on` y `off`. | "Create a flag `ui_refresh` for site `d1alzzxd7k`." |
| `feature_flag_duplicate` | Clone un flag existente (la copia empieza desactivada en todos los entornos). | "Duplicate the `new_search` flag." |
| `feature_flag_delete` | Elimine de forma permanente un flag y toda su configuración. | "Delete the flag `ui_refresh`." |
| `feature_flag_enable` | Active el interruptor principal del entorno para que el SDK evalúe las reglas. | "Turn on `new_search` in production." |
| `feature_flag_disable` | Desactive el interruptor principal del entorno (la cadena de reglas se mantiene intacta). | "Turn off `new_search` in staging." |
| `feature_flag_activity_logs_get` | Lea el registro de auditoría de cambios de los flags (quién cambió qué y cuándo). | "Show the recent change history for these feature flags." |
| `feature_flag_experiment_results_get` | Obtenga los resultados estadísticos de todos los objetivos asociados a la regla de experimentación de un flag. Acepta los mismos ajustes de `breakdown`, `filters`, de fechas, `statisticalMethod`, `conversionType` y `referenceVariationId` que `experiment_results_get`. | "Get the experiment results for the rule on `new_search`." |

### Reglas, variaciones y variables

Defina cómo entrega un flag el valor a los usuarios: añada reglas de entrega y de experimentación, y defina las variaciones y las variables tipadas que sirve.

| Herramienta | Descripción | Prompt de ejemplo |
| - | - | - |
| `feature_flag_rule_targeted_create` | Añada una regla de entrega dirigida: sirva una variación a un porcentaje del tráfico, con un inicio programado. | "Roll `new_search` out to 20% in production." |
| `feature_flag_rule_progressive_create` | Añada una regla de entrega progresiva que aumente la exposición de una variación en pasos fijos, para un despliegue gradual sin comparación estadística. | "Roll `new_search` out in production from 5% to 100%, adding 10% every day." |
| `feature_flag_rule_experimentation_create` | Añada una regla de experimentación A/B que reparta el tráfico entre variaciones con seguimiento estadístico. | "A/B test `off` vs `on` 50/50 on `new_search`." |
| `feature_flag_variation_create` | Añada una variación personalizada (un estado con nombre de la funcionalidad) a un flag. | "Add a `variant_a` variation to `new_search`." |
| `feature_flag_variable_create` | Defina una variable tipada (BOOLEAN, NUMBER, STRING, JSON, JS, CSS, ENUM) con un valor predeterminado. | "Add a STRING variable `label` defaulting to `Search`." |
| `feature_flag_variation_variable_set` | Sobrescriba el valor de una variable para una variación concreta. | "Set `label` to `Find` on `variant_a`." |

## Parámetros

Use los nombres exactos de parámetro que devuelve `tools/list`.

### Feature flags

| Herramienta | Parámetros obligatorios | Parámetros opcionales |
| - | - | - |
| `feature_flag_list` | Ninguno | `siteCode`, `filterQuery`, `page`, `perPage`, `sortField`, `sortOrder` |
| `feature_flag_get` | `featureKey`, `siteCode` | `environmentKey` (`*` para todos los entornos) |
| `feature_flag_create` | `siteCode`, `featureKey`, `name` | `description` |
| `feature_flag_duplicate` | `featureKey`, `siteCode` | Ninguno |
| `feature_flag_delete` | `featureKey`, `siteCode` | `confirm` (obligatorio para aplicar el cambio) |
| `feature_flag_enable` | `featureKey`, `siteCode`, `environmentKey` | `confirm` (obligatorio para aplicar el cambio) |
| `feature_flag_disable` | `featureKey`, `siteCode`, `environmentKey` | `confirm` (obligatorio para aplicar el cambio) |
| `feature_flag_activity_logs_get` | Ninguno | `type`, `sortKey` (`timestamp`), `sortOrder`, `page`, `perPage` |
| `feature_flag_experiment_results_get` | `featureKey`, `siteCode`, `environmentKey`, `experimentId` | `goalIds`, `audienceBasis` (`VISITORS` por defecto, o `VISITS`), `includeRawReport`, `breakdown`, `filters`, `dateFrom`, `dateTo`, `statisticalMethod`, `conversionType`, `referenceVariationId` (un ID o una clave de variación, `0` u `off` para la variación off); los valores son los mismos que en `experiment_results_get` |

### Reglas, variaciones y variables

| Herramienta | Parámetros obligatorios | Parámetros opcionales |
| - | - | - |
| `feature_flag_rule_targeted_create` | `siteCode`, `featureKey`, `environmentKey`, `variationKey`, `exposition`, `releaseDateTime`, `timeZone` | `ruleName`, `confirm` (obligatorio cuando el flag ya está activado en el entorno) |
| `feature_flag_rule_progressive_create` | `siteCode`, `featureKey`, `environmentKey`, `variationKey`, `startExposition`, `stopExposition`, `increaseBy`, `frequencyValue`, `frequencyUnit` (`MINUTES`, `HOURS` o `DAYS`), `releaseDateTime`, `timeZone` | `ruleName`, `confirm` (obligatorio cuando el flag ya está activado en el entorno) |
| `feature_flag_rule_experimentation_create` | `siteCode`, `featureKey`, `environmentKey`, `controlVariationKey`, `trafficAllocations`, `exposition`, `releaseDateTime`, `timeZone` | `ruleName`, `confirm` (obligatorio cuando el flag ya está activado en el entorno) |
| `feature_flag_variation_create` | `siteCode`, `featureKey`, `variationKey`, `variationName` | Ninguno |
| `feature_flag_variable_create` | `siteCode`, `featureKey`, `variableKey`, `variableType`, `defaultValue` | Ninguno |
| `feature_flag_variation_variable_set` | `siteCode`, `featureKey`, `variationKey`, `variableKey`, `value` | Ninguno |

**Valores aceptados:** `variableType` es `BOOLEAN`, `NUMBER`, `STRING`, `JSON`, `JS`, `CSS` o `ENUM`. `trafficAllocations` es una cadena separada por comas de `variationKey:percentage` que suma 100 (por ejemplo `off:50,on:50`). `releaseDateTime` es una fecha y hora local en formato ISO-8601 sin desfase horario (por ejemplo `2026-07-01T09:00:00`), y `timeZone` es una zona horaria IANA (por ejemplo `Europe/Paris` o `UTC`). `frequencyUnit` es `MINUTES`, `HOURS` o `DAYS`.

> [!TIP]
>
> Para consultas específicas de un entorno, pase `environmentKey = "production"` o `environmentKey = "staging"` cuando la herramienta lo admita.