extract_usage_chart
Extract structured energy-usage chart data from utility-bill PDFs, returning time-series, markdown text, and annotated images.
Instructions
Extract energy-usage chart data from a utility-bill PDF.
Returns the full page text as Markdown, structured chart data as JSON, and optionally an annotated PNG of the chart region.
Provide exactly one of pdf_path, pdf_base64, or pdf_url.
The result includes a 'series' list. When the chart contains multiple utility types (e.g. electricity and gas on the same chart), each type is returned as a separate Series entry with its own 'id' ('s0', 's1', …) and 'color'. The caller is responsible for determining which series corresponds to which utility — use the bar colors, the series order, and the page Markdown context to make that determination.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "extract_usage_chart"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pdf_path | No | ||
| pdf_base64 | No | ||
| pdf_url | No | ||
| page | No | ||
| chart_type | No | auto | |
| value_unit | No | auto | |
| return_annotated_image | No | ||
| render_dpi | No |