generate_cartesian_chart

Create Cartesian charts—line, area, bar, waterfall, ranking bar, and funnel—to visualize trends, comparisons, or process stages. Input data, customize axes, labels, and themes, and export as spec, image, or HTML.

Instructions

Generates Cartesian charts: line (trends over time), area (cumulative totals), bar (category comparison), waterfall (incremental changes), ranking bar (ordered categories), and funnel (visualizes stages in a process or conversion rates).

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	Color grouping field. Should not duplicate the dimension field.
`colors`	No	Color palette for chart elements.
`dataTable`	Yes	Data array, e.g., [{ x: '2018', y: 99.9 }]. Cannot be empty.
`height`	No	Chart height. Optional, defaults to 500.
`output`	No	Chart output type. Defaults to 'image'.	image
`stackOrPercent`	No	Stacking mode: 'stack' for stacked data, 'percent' for percentage stacking. Requires 'color' field.
`subTitle`	No	Chart subtitle text.
`timeField`	No	Time field, such as year or month. The x field and time field must be different. this field is required in ranking_bar
`title`	No	Chart title text.
`titleOrient`	No	Title position in the chart.
`transpose`	No	Set to true only when displaying a horizontal bar chart.
`width`	No	Chart width. Optional, defaults to 500.
`xAxisHasGrid`	No	Show vertical grid lines for the X-axis.
`xAxisHasLabel`	No	Show X-axis labels.
`xAxisHasTick`	No	Show X-axis ticks.
`xAxisOrient`	No	X-axis position in the chart.
`xAxisTitle`	No	X-axis title.
`xAxisType`	No	X-axis type: categorical ('band') or continuous ('linear').
`xField`	Yes	Dimension field. Must exist in the data.
`yAxisHasGrid`	No	Show horizontal grid lines for the Y-axis.
`yAxisHasLabel`	No	Show Y-axis labels.
`yAxisHasTick`	No	Show Y-axis ticks.
`yAxisOrient`	No	Y-axis position in the chart.
`yAxisTitle`	No	Y-axis title.
`yAxisType`	No	Y-axis type: categorical ('band') or continuous ('linear').
`yField`	Yes	Measure field. Must be numeric and exist in the data.

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": [
        "area",
        "line",
        "bar",
        "waterfall",
        "ranking_bar",
        "funnel"
      ],
      "type": "string"
    },
    "colorField": {
      "description": "Color grouping field. Should not duplicate the dimension field.",
      "type": "string"
    },
    "colors": {
      "anyOf": [
        {
          "items": {
            "description": "Color value",
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "description": "Color palette for chart elements."
    },
    "dataTable": {
      "description": "Data array, e.g., [{ x: '2018', y: 99.9 }]. Cannot be empty.",
      "items": {
        "additionalProperties": {},
        "type": "object"
      },
      "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"
    },
    "stackOrPercent": {
      "description": "Stacking mode: 'stack' for stacked data, 'percent' for percentage stacking. Requires 'color' field.",
      "enum": [
        "stack",
        "percent"
      ],
      "type": "string"
    },
    "subTitle": {
      "description": "Chart subtitle text.",
      "type": "string"
    },
    "timeField": {
      "description": "Time field, such as year or month. The x field and time field must be different. this field is required in ranking_bar",
      "type": "string"
    },
    "title": {
      "description": "Chart title text.",
      "type": "string"
    },
    "titleOrient": {
      "description": "Title position in the chart.",
      "enum": [
        "top",
        "left",
        "right",
        "bottom"
      ],
      "type": "string"
    },
    "transpose": {
      "description": "Set to true only when displaying a horizontal bar chart.",
      "type": "boolean"
    },
    "width": {
      "description": "Chart width. Optional, defaults to 500.",
      "type": "number"
    },
    "xAxisHasGrid": {
      "description": "Show vertical grid lines for the X-axis.",
      "type": "boolean"
    },
    "xAxisHasLabel": {
      "description": "Show X-axis labels.",
      "type": "boolean"
    },
    "xAxisHasTick": {
      "description": "Show X-axis ticks.",
      "type": "boolean"
    },
    "xAxisOrient": {
      "description": "X-axis position in the chart.",
      "enum": [
        "bottom",
        "top"
      ],
      "type": "string"
    },
    "xAxisTitle": {
      "description": "X-axis title.",
      "type": "string"
    },
    "xAxisType": {
      "description": "X-axis type: categorical ('band') or continuous ('linear').",
      "enum": [
        "band",
        "linear"
      ],
      "type": "string"
    },
    "xField": {
      "description": "Dimension field. Must exist in the data.",
      "minLength": 1,
      "type": "string"
    },
    "yAxisHasGrid": {
      "description": "Show horizontal grid lines for the Y-axis.",
      "type": "boolean"
    },
    "yAxisHasLabel": {
      "description": "Show Y-axis labels.",
      "type": "boolean"
    },
    "yAxisHasTick": {
      "description": "Show Y-axis ticks.",
      "type": "boolean"
    },
    "yAxisOrient": {
      "description": "Y-axis position in the chart.",
      "enum": [
        "left",
        "right"
      ],
      "type": "string"
    },
    "yAxisTitle": {
      "description": "Y-axis title.",
      "type": "string"
    },
    "yAxisType": {
      "description": "Y-axis type: categorical ('band') or continuous ('linear').",
      "enum": [
        "band",
        "linear"
      ],
      "type": "string"
    },
    "yField": {
      "description": "Measure field. Must be numeric and exist in the data.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "chartType",
    "dataTable",
    "xField",
    "yField"
  ],
  "type": "object"
}

vchart-mcp-server

generate_cartesian_chart

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from vchart-mcp-server

Related Tools

MCP directory API