set_variable_value

Set ONE variant's value on a grouped variable, preserving every other variant.

Set ONE variant's value on a grouped variable, preserving every other variant.

Writes data · Idempotent · Calls external systems.

Parameters

FieldTypeRequiredDescription
acknowledgebooleanNoReset edit budget after user approval
valuestringYesNew value for this variant
variable_idnumberYesVariable id (must be group-scoped)
variantstringYesVariant id (number) or name (string)

Example arguments

Illustrative arguments an agent supplies when calling this tool:

{
  "variable_id": 0,
  "variant": "string",
  "value": "string"
}

Description

variant accepts the variant id (number) or name (string); name resolution loads the parent group's variants. Errors when called on a global variable — globals have no variants; use update_variable default_value instead. Errors when the variant is not present on the variable.

This sets ONE variable in ONE variant. To bulk-copy ALL variables' values from one variant into another across the whole group, use copy_variant_values instead.

What's next?

All MCP tools

Browse the full tool reference by category.

Connect a client

Point Claude, Cursor, or Claude Code at the server.

Last updated on