Qualified installer only. High-voltage, grid-tied and battery systems can kill. Do not open energised DC/AC equipment. Read the safety model.

For agents — the page is the front door, the row is the API

Every page has a matching JSON row and a markdown twin. The free API returns the same row plus provenance.

Endpoints

EndpointReturns
GET /healthservice status
GET /api/v1/codes/{brand}/{code}one normalised row + sources
POST /api/v1/diagnosenormalised row + sources for a brand/code/symptom
/mcpMCP tool diagnose_inverter_fault
/openapi.jsonOpenAPI 3.1

Example row

{
  "brand": "Victron",
  "code": "Err 1",
  "title": "Battery temperature too high",
  "meaning": "The charger has stopped charging because the battery temperature is above the safe limit, to prevent battery damage. The temperature comes from an external sensor (Smart Battery Sense or BMV) or from the charger's own measurement.",
  "likely_causes": [
    "Battery operating above its safe temperature range",
    "Faulty or misplaced temperature sensor"
  ],
  "checks": [
    "Confirm the battery temperature reading in VictronConnect and let the battery cool",
    "Check that the temperature sensor is correctly placed and connected"
  ],
  "parts": [
    "temperature sensor",
    "battery"
  ],
  "safety_notes": "Qualified installer only. High-voltage, grid-tied and battery systems can kill. Do not open energised DC/AC equipment. This page is a diagnostic reference, not step-by-step work instructions. Isolate and verify de-energised before any physical check, and escalate to a qualified installer/electrician for anything beyond reading the display or checking a connector on isolated equipment.",
  "source_url": "https://www.victronenergy.com/live/mppt-error-codes",
  "source_type": "vendor_kb",
  "last_checked": "2026-11-21",
  "confidence": "verified",
  "requires_qualified_installer": true
}

MCP tool definition

{
  "name": "diagnose_inverter_fault",
  "description": "Look up a solar/ESS/EV inverter or charge-controller fault code and return the normalised meaning, likely causes, checks, parts, safety notes, and source.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "brand": {
        "type": "string"
      },
      "code": {
        "type": "string"
      },
      "model": {
        "type": "string",
        "description": "Optional model or series"
      },
      "symptom": {
        "type": "string",
        "description": "Optional free-text symptom"
      }
    },
    "required": [
      "brand",
      "code"
    ]
  }
}

Provenance on every response

Each row carries source_url, source_type, last_checked, confidence, and requires_qualified_installer. An agent should cite the source and hard-stop on safety-critical faults.