Chart
Create charts including pie, bar, line, area, scatter, bubble, and radar charts.
Send "type": "chart".
Create charts including pie, bar, line, area, scatter, bubble, and radar charts. Only for plotting VALUES: a "chart" that plots nothing and instead shows how people or parts relate (org chart, reporting structure, hierarchy tree) is a diagram — use render_flowchart.
Also available as the MCP tool render_chart. The same payload works through either surface.
Fields
componentTypeenum<string>requiredChart type. One of MF_PieChart2, MF_HorizontalLineChart, MF_VerticalBarChart, MF_HorizontalBarChart, MF_AreaChart, MF_ScatterChart, MF_BubbleChart or MF_RadarChart.
chartDatastringrequiredCSV-formatted chart data. For pie: "Label1,Label2\n20,30". For line/bar: "Legends,Series\nJan,100\nFeb,120"
titlestringrequiredChart title
chartColorsobject[]ONLY when the user names a color scheme/theme/brand: one entry per data series/slice matching that theme. Omit entirely otherwise (component defaults apply).
Child attributes
legendstringSeries/slice name exactly as it appears in chartData
backgroundColorstringHex color like #1B4F72
Example
{
"type": "chart",
"data": {
"componentType": "MF_PieChart2",
"chartData": "string",
"title": "Q4 Launch Planning",
"chartColors": [
{
"legend": "string",
"backgroundColor": "string"
}
]
}
}
Add one record
POST /boards/{boardId}/items/{itemId}/records adds one of these to an item already on a board and leaves the rest of it as it is. Send the same key again to update that record instead of adding another.
Record fields
labelstringrequiredvaluenumberrequiredchartTypeenum<string>What a new chart is drawn as. A chart already on the board keeps its own type. One of bar, horizontal bar, line, area, pie, scatter, bubble or radar.
seriesstringWhich series the value is for, on a chart with more than one; made when there is none by that name. The first series when left out.
keystringYour own id for this record, like an issue key. Sending the same key again updates and moves that record instead of adding another.
{
"record": {
"label": "string",
"value": 0,
"chartType": "bar",
"series": "string",
"key": "string"
}
}