Return the month and year of the most recently published consumption report.

messdienst24.de is a German utility-consumption portal that provides the legally mandated monthly heating and hot-water consumption report (Verbrauchsinformation) for residential properties. The portal publishes one report per calendar month (always a previous month, never the current one). This tool returns which month that currently published report covers.

Call this tool when you only need to know the current reporting month without fetching the full report. The full report (get_consumption_report) and the PDF (save_pdf) both include this information as well.

Returns: year: Four-digit year of the current reporting month (e.g. 2025). month: Month number 1–12 of the current reporting month (e.g. 4 for April).

Return the heating and hot-water consumption report from messdienst24.de.

messdienst24.de is a German utility-consumption portal. This tool retrieves the full structured consumption data for your residential property. The report covers the most recently published month (returned as year/month at the top level) and also includes a history of several previous months so that trends can be analysed.

The response includes: year, month: The current reporting period (e.g. year=2025, month=4 for April 2025). object_info: Property address and object number assigned by the service provider. heating: Heating consumption data (see below). hot_water: Hot-water consumption data (same structure as heating).

Each meter section (heating / hot_water) contains: your_kwh: Your consumption for the current reporting month in kWh equivalent. average_kwh: Average consumption of comparable households in kWh equivalent. vs_average: How your usage compares to similar households this month. "less" = you used less, "more" = you used more, "equal" = same. null if the comparison is unavailable. vs_previous_month: How your usage compares to the previous month (same values). null if unavailable. vs_previous_year: How your usage compares to the same month last year (same values). null if unavailable. history: List of monthly readings for several past months, newest first. Each entry has year, month, your_kwh, average_kwh. history[0] always corresponds to the current reporting month.

Download the monthly consumption PDF and save it to disk.

This is the legally mandated unterjährige Verbrauchsinformation (UVI) document — a German statutory heating-cost information notice that property owners are required to provide to tenants under §6a HeizkostenV. The document is generated by the messdienst24.de portal and covers the same month returned by get_last_available_month.

Use this tool when the user wants to save, view, or forward the actual PDF document rather than just reading the structured consumption figures.

Args: directory: Directory where the PDF will be saved. Defaults to ~/Downloads. The filename is set automatically to e.g. "verbrauch-2025-04.pdf".

Returns: saved_to: Full path of the saved file. filename: The filename used, e.g. "verbrauch-2025-04.pdf". year, month: The period the document covers. size_bytes: Size of the saved PDF in bytes.