Data Visualization
Create waterfall charts to visualize cumulative changes with positive/negative value distinction and subtotal display
Call this tool from your code in three languages.
curl -X POST 'https://api.elysiatools.com/en/api/tools/waterfall-chart-generator' \
-H 'Content-Type: application/json' \
-d '{"chartTitle":"Enter chart title...","dataItems":"JSON format example:\n[{"label": "Starting Value", "value": 1000, "isSubtotal": true},\n{"label": "Revenue", "value": 500},\n{"label": "Costs", "value": -200},\n{"label": "Expenses", "value": -150},\n{"label": "Net Profit", "value": 150, "isSubtotal": true}]","xAxisLabel":"Categories","yAxisLabel":"Values","positiveColor":"#2196F3","negativeColor":"#F44336","totalColor":"#4CAF50","connectingLineColor":"#666666","barWidth":"60","showValues":true,"showTotal":true,"showConnectingLines":true,"valueFormat":"integer","fontSize":"12","titleSize":"18","fontFamily":"Arial","chartWidth":"800","chartHeight":"500","backgroundColor":"#ffffff","gridColor":"#e0e0e0","animationEnabled":true,"animationDuration":"1000"}'Send a POST request with your inputs as JSON. File parameters require a separate upload first.
POST https://api.elysiatools.com/en/api/tools/waterfall-chart-generator| Name | Type | Required | Description |
|---|---|---|---|
| chartTitle | text | No | Title that will be displayed above the waterfall chart |
| dataItems | textarea | Yes | Data items as JSON array with label, value, and optional isSubtotal flag |
| xAxisLabel | text | No | Label for the X-axis |
| yAxisLabel | text | No | Label for the Y-axis |
| positiveColor | color | No | Color for positive value bars |
| negativeColor | color | No | Color for negative value bars |
| totalColor | color | No | Color for subtotal and total bars |
| connectingLineColor | color | No | Color for connecting lines between bars |
| barWidth | number | No | Width of each bar in pixels |
| showValues | checkbox | No | Display values on top of bars |
| showTotal | checkbox | No | Automatically add final total bar |
| showConnectingLines | checkbox | No | Display connecting lines between bars |
| valueFormat | select | No | — |
| fontSize | number | No | Font size for labels and values |
| titleSize | number | No | Font size for the chart title |
| fontFamily | text | No | Font family for text elements |
| chartWidth | number | No | Width of the chart in pixels |
| chartHeight | number | No | Height of the chart in pixels |
| backgroundColor | color | No | Background color of the chart |
| gridColor | color | No | Color of grid lines |
| animationEnabled | checkbox | No | Animate the chart when it loads |
| animationDuration | number | No | Animation duration in milliseconds |
HTML result
{
"result": "<div>Processed HTML content</div>",
"error": "Error message (optional)",
"message": "Notification message (optional)",
"metadata": {
"key": "value"
}
}Add this tool to your Model Context Protocol server so AI agents can list and call it.
Add this block to your MCP client configuration:
{
"mcpServers": {
"elysiatools-waterfall-chart-generator": {
"name": "waterfall-chart-generator",
"description": "Create waterfall charts to visualize cumulative changes with positive/negative value distinction and subtotal display",
"baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=waterfall-chart-generator",
"command": "",
"args": [],
"env": {},
"isActive": true,
"type": "sse"
}
}
}After connecting to the SSE endpoint, list the exposed tools:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}Invoke the tool by its id, passing arguments built from its parameters:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "waterfall-chart-generator",
"arguments": {
"chartTitle": "Enter chart title...",
"dataItems": "JSON format example:\n[{"label": "Starting Value", "value": 1000, "isSubtotal": true},\n{"label": "Revenue", "value": 500},\n{"label": "Costs", "value": -200},\n{"label": "Expenses", "value": -150},\n{"label": "Net Profit", "value": 150, "isSubtotal": true}]",
"xAxisLabel": "Categories",
"yAxisLabel": "Values",
"positiveColor": "#2196F3",
"negativeColor": "#F44336",
"totalColor": "#4CAF50",
"connectingLineColor": "#666666",
"barWidth": "60",
"showValues": true,
"showTotal": true,
"showConnectingLines": true,
"valueFormat": "integer",
"fontSize": "12",
"titleSize": "18",
"fontFamily": "Arial",
"chartWidth": "800",
"chartHeight": "500",
"backgroundColor": "#ffffff",
"gridColor": "#e0e0e0",
"animationEnabled": true,
"animationDuration": "1000"
}
}
}Questions or issues? Contact [email protected]