list_variables

List variables for a product.

Read-only · Calls external systems. Safe to call: this tool does not modify data.

Parameters

Field	Type	Required	Description
`detail`	boolean	No	Return full JSON instead of compact one-liners (default: false)
`group`	number	No	Optional: variable group id — restrict to that group
`product`	string	Yes	Product slug (operator~product)
`scope`	string (global \| grouped \| all)	No	global \| grouped \| all (default: all)
`type`	string (single \| secret \| choice)	No	single \| secret \| choice
`used`	string (true \| false)	No	true \| false — filter by usage state (omit for all)
`variant`	string	No	Variant name or id — restrict to variables carrying this variant

Example arguments

Illustrative arguments an agent supplies when calling this tool:

{
  "product": "string"
}

Description

Default scope returns ALL variables (global + grouped).

Filter set:
  - scope:   "global" | "grouped" | "all" (default: "all")
  - group:   numeric variable group id — restrict to one group
  - type:    "single" | "secret" | "choice" — filter by type
  - used:    "true" | "false" — filter by usage state (omits unused tests)
  - variant: variant name or id — restrict to variables that carry the variant

By default returns compact one-liners; pass detail=true for the full JSON shape including per-variant values. Secrets are returned masked by the platform.

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.