SSyncDev

Victron Tcp MCP Server

MCP server for Victron Energy GX devices via Modbus TCP or MQTT

Local serverstdioGo

What is the Victron Tcp MCP Server?

MCP server for Victron Energy GX devices via Modbus TCP or MQTT

What you get

Connect AI assistants to Victron Energy systems. Read real-time solar, battery, grid, and inverter data from your local network — no cloud required.

Configuration and credentials

  • Victron GX device on your local network (Ekrano, Cerbo, Venus GX, etc.) - MQTT (enabled by default on Venus OS) or Modbus TCP (Settings → Services → Modbus TCP) - Node.js 18+ ---

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
victron_system_overviewBattery SOC, PV power, grid power, AC consumption, ESS status
victron_battery_statusSOC, voltage, current, power, temperature, cell data, time-to-go
victron_solar_statusPV power, yield today/yesterday/total, charger state, tracker data
victron_grid_statusGrid power per phase (L1/L2/L3), voltage, current, frequency
victron_vebus_statusMulti/Quattro: AC in/out, current limit, mode, state, alarms
victron_tank_levelsTank level, capacity, remaining, fluid type
victron_temperatureTemperature, sensor type, humidity, pressure
victron_inverter_statusStandalone inverter: AC output, state, alarms
victron_evcs_statusEV Charging Station: power, status, session energy
victron_multi_statusMulti RS inverter/charger
victron_pvinverter_statusAC-coupled PV inverters (Fronius, SolarEdge, ABB)
victron_genset_statusAC genset controllers
victron_dcgenset_statusDC generators
victron_alternator_statusNMEA 2000 alternators
victron_charger_statusAC chargers (Skylla, Blue Smart)
victron_dcdc_statusOrion XS DC-DC converter
victron_acload_statusAC load / current sensors
victron_dcenergy_statusDC energy meters (SmartShunts in DC meter mode)
victron_gx_infoGX device identity, relay states
victron_digital_inputsDigital input state and type
victron_gps_statusGPS position, altitude, speed
victron_meteo_statusSolar irradiance, wind speed, temperatures
victron_generator_statusGenerator auto start/stop, runtime, alarms
victron_network_scanScan local network to find GX devices
victron_setupFull setup: test transports, discover devices, generate config
victron_mqtt_discoverAuto-discover MQTT portal ID, services, device instances
victron_discoverScan Modbus unit IDs to find connected devices
victron_read_categoryRead all registers for any device category
victron_read_registerRead raw register(s) by address (Modbus only)
victron_list_registersList available registers for a device category
victron_search_docsSearch offline docs (registers + VRM API)
victron_check_onlineGet URLs for latest Victron docs
URIContent

How to install the Victron Tcp MCP Server

{
  "mcpServers": {
    "victron-tcp": {
      "command": "npx",
      "args": [
        "-y",
        "victron-tcp"
      ],
      "env": {
        "VICTRON_HOST": "192.168.1.50",
        "VICTRON_TRANSPORT": "mqtt",
        "VICTRON_PORTAL_ID": "your-portal-id"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Victron GX device on your local network (Ekrano, Cerbo, Venus GX, etc.) - MQTT (enabled by default on Venus OS) or Modbus TCP (Settings → Services → Modbus TCP) - Node.js 18+ ---
VariableDescriptionRequired
VICTRON_HOSTDeclared in the maintainer’s client configuration.Check documentation
VICTRON_TRANSPORTDeclared in the maintainer’s client configuration.Check documentation
VICTRON_PORTAL_IDDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Victron Tcp to victron system overview.”
  • “Use Victron Tcp to victron battery status.”
  • “Use Victron Tcp to victron solar status.”

Frequently asked questions

MCP server for Victron Energy GX devices via Modbus TCP or MQTT Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.