generate_progress_chart

Create visual progress charts for quantitative metrics normalized between 0 and 1, including linear, circular, gauge, and liquid formats. Ideal for tracking progress, completion rates, and proportional data with customizable themes, dimensions, and outputs.

Instructions

Generates a progress chart for visualizing quantitative values normalized between 0 and 1. Ideal for representing progress, completion rates, or proportional metrics. The gauge chart and liquid chart currently only supports displaying data for a single dimension.

Input Schema

Name	Required	Description	Default
`background`	No	Chart background color (hex). Optional, defaults to white.
`chartTheme`	No	Chart theme. Optional, defaults to 'light'.
`chartType`	Yes
`colorField`	No	Dimension field, Must exist in the data, required in linear_progress, circular_progress and gauge
`colors`	No	Color palette for chart elements.
`dataTable`	Yes	Data for the progress chart, e.g., [{ category: 'category 01', value: 0.5 }].
`height`	No	Chart height. Optional, defaults to 500.
`output`	No	Chart output type. Defaults to 'image'.	image
`subTitle`	No	Chart subtitle text.
`title`	No	Chart title text.
`titleOrient`	No	Title position in the chart.
`valueField`	Yes	Measure field with values in [0, 1]. Must exist in the data.
`width`	No	Chart width. Optional, defaults to 500.

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "background": {
      "description": "Chart background color (hex). Optional, defaults to white.",
      "type": "string"
    },
    "chartTheme": {
      "description": "Chart theme. Optional, defaults to 'light'.",
      "enum": [
        "light",
        "dark"
      ],
      "type": "string"
    },
    "chartType": {
      "enum": [
        "linear_progress",
        "circular_progress",
        "gauge",
        "liquid"
      ],
      "type": "string"
    },
    "colorField": {
      "description": "Dimension field, Must exist in the data, required in linear_progress, circular_progress and gauge",
      "type": "string"
    },
    "colors": {
      "anyOf": [
        {
          "items": {
            "description": "Color value",
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "description": "Color palette for chart elements."
    },
    "dataTable": {
      "description": "Data for the progress chart, e.g., [{ category: 'category 01', value: 0.5 }].",
      "minItems": 1,
      "type": "array"
    },
    "height": {
      "description": "Chart height. Optional, defaults to 500.",
      "type": "number"
    },
    "output": {
      "default": "image",
      "description": "Chart output type. Defaults to 'image'.",
      "enum": [
        "spec",
        "image",
        "html"
      ],
      "type": "string"
    },
    "subTitle": {
      "description": "Chart subtitle text.",
      "type": "string"
    },
    "title": {
      "description": "Chart title text.",
      "type": "string"
    },
    "titleOrient": {
      "description": "Title position in the chart.",
      "enum": [
        "top",
        "left",
        "right",
        "bottom"
      ],
      "type": "string"
    },
    "valueField": {
      "description": "Measure field with values in [0, 1]. Must exist in the data.",
      "minLength": 1,
      "type": "string"
    },
    "width": {
      "description": "Chart width. Optional, defaults to 500.",
      "type": "number"
    }
  },
  "required": [
    "dataTable",
    "chartType",
    "valueField"
  ],
  "type": "object"
}

vchart-mcp-server