🚧This is an internal UI component. It is called automatically by the Platform MCP server — do not call it directly.

show-battery renders a battery-style horizontal progress bar in the chat interface. Each segment represents a named category with a numeric value and a color, displayed as a proportional slice of the bar. The MCP server invokes this tool automatically when a user asks for a progress view, status distribution, completion percentage, or monday.com-style battery visualization.

Unlike show-chart, the color field is required for every segment in show-battery — it controls each segment's color in the bar and in the legend.

Parameters

Parameter	Type	Required	Description
data	`array`	Yes	Array of segments. Each segment must include `name` (label), `y` (numeric value, minimum 0), and `color` (any valid CSS color). All three fields are required per segment.

Example

Render a battery showing sprint completion status:

{
  "data": [
    { "name": "Done", "y": 18, "color": "#00ca72" },
    { "name": "In Progress", "y": 9, "color": "#fdab3d" },
    { "name": "Stuck", "y": 3, "color": "#e2445c" },
    { "name": "Not Started", "y": 10, "color": "#c4c4c4" }
  ]
}

This displays a single horizontal bar divided into four colored segments proportional to their y values, with a legend below. The total (40 items) is used to calculate percentages for each segment.

Programmatic equivalent

There is no direct API equivalent for rendering a battery visualization — this component is specific to the MCP chat interface. To retrieve the underlying status data, use the monday.com GraphQL API to query item column values and aggregate them by status label. See the monday.com API reference for available queries.