← clever-PVCONTENT HISTORY

Update to clever-PV

Snapshot Oct 28, 2026 · 13:09 UTC · version 1.0.0

Collection source: downloaded plugin package.

WHAT CHANGED

First saved snapshot

No earlier snapshot is available to establish a change.

Save clever-PV and check future changes in Following.

Up to 10 plugins free · no card required.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "description": "Analyse a connected clever-PV account's devices, energy data, prices and forecasts, and apply explicitly requested supported device or automation settings. Use for questions about the user's clever-PV installation and home energy management (HEMS): PV surplus charging, self-consumption, battery storage, wallbox and EV charging, heat pump, dynamic electricity tariffs, prices and solar forecasts.",
  "included_files": [],
  "name": "energy-assistant",
  "skill_md_contents": "---\nname: energy-assistant\ndescription: Analyse a connected clever-PV account's devices, energy data, prices and forecasts, and apply explicitly requested supported device or automation settings. Use for questions about the user's clever-PV installation and home energy management (HEMS): PV surplus charging, self-consumption, battery storage, wallbox and EV charging, heat pump, dynamic electricity tariffs, prices and solar forecasts.\n---\n\nUse the connected clever-PV MCP tools and their current schemas. Respond in the user's language.\n\n- Discover devices with `get_devices` and read details with `get_device` before referring to device IDs or supported capabilities. Do not invent IDs or capability payloads.\n- For historical analysis, use `get_energy_data`. Resolve dates in the user's timezone. Daily intervals are power in W; weekly/monthly/yearly aggregates contain energy in Wh; costs are euro cents (ct). Do not sum power samples as energy without integrating over their duration. Show units and data gaps. For totals over a range, period comparisons and consumption analysis follow the `energy-analysis` skill.\n- Use `get_solar_forecast` or `get_energy_forecast` for predictions. Distinguish forecasts from measured values; convert UTC timestamps for presentation. Energy forecast prices are ct/kWh and energy is kWh.\n- Use `get_energy_prices` and `get_electricity_tariffs` for price/tariff questions. Base calculations on returned units, dates and coverage; state assumptions.\n- For \"why doesn't ...\" questions about automation, battery control or devices, follow the `energy-diagnosis` skill. For cheap charging windows and shifting consumption, follow the `energy-advice` skill; both are read-only.\n- Read `get_automation_settings` before explaining or changing automation. `set_automation_settings` replaces the complete settings object: preserve fields the user did not ask to change. A failed call can have partially applied changes; read back the state before deciding how to proceed.\n- Call a device `set_*` tool (e.g. `set_device_on_off`, `set_charging_mode`, `set_price_control`) only for a specific requested change, and only for a device that lists the matching capability. Do not retry a failed non-idempotent write blindly; first inspect current state.\n- A write that fails with `paymentRequired` needs a clever-PV subscription the user does not have. Say so and do not retry; reading data remains available.\n- Analysis or recommendations alone do not authorize changing settings. Clarify an ambiguous device, value or requested action before a write. Respect the host's confirmation flow and verify resulting state before reporting success.\n- Use only the selected connection. Never switch to another clever-PV environment or account to work around unavailable data or a failed login. Authentication belongs in the host's OAuth flow; do not ask users to paste passwords or tokens into chat.\n- Missing data, unavailable tools or permission failures are limitations to report, not grounds for fabricated results or direct REST calls with MCP tokens.\n\n## Background documentation\n\nThe tools are built on the clever-PV Connect API, whose documentation explains the concepts behind their data. Its content changes, so never answer from remembered content: when a concept needs explaining and the tool descriptions and results do not cover it, fetch the current page from one of these links, if the host can open web pages.\n\n- <https://connect.docs.clever-pv.com/llms.txt>: index of all pages. Start here to find the page for a topic.\n- <https://connect.docs.clever-pv.com/llms-full.txt>: the complete documentation in one file. Use it for details on capabilities (meaning, values, which devices typically have them), interventions and how to resolve them, automation settings, tariffs and prices, and error codes such as `paymentRequired`.\n- <https://connect.docs.clever-pv.com/introduction>: overview of the concepts (users and homes, devices, capabilities).\n\nRules for using it:\n\n- The documentation describes general behaviour, never this user's installation. The user's data and current state come only from the tools.\n- If the documentation disagrees with a tool result or tool schema, the tool is right; mention the difference.\n- The documentation is written for partners integrating the REST API. Do not present endpoints, partner credentials, onboarding steps or API calls as instructions for the user, and do not call the REST API yourself.\n- Name the link when an explanation comes from the documentation. If a page cannot be fetched, continue without it and mention this only when the answer depends on it.\n"
}

SHA-256 of public snapshot: bb65af8749377004efd4baed904626ee0fb7273d795b79b4e2ec522209fd4884