Victron Vrm Mcp — Mcp Server
Description
# Victron VRM MCP — MCP Server MCP server for Victron Energy's [VRM cloud API](https://vrmapi.victronenergy.com/v2/docs). Exposes 52 VRM tools over Streamable HTTP — ready for the [Anthropic MCP Connector API](https://platform.claude.com/docs/en/agents-and-tools/mcp-connector)…
About
# Victron VRM MCP — MCP Server MCP server for Victron Energy's [VRM cloud API](https://vrmapi.victronenergy.com/v2/docs). Exposes 52 VRM tools over Streamable HTTP — ready for the [Anthropic MCP Connector API](https://platform.claude.com/docs/en/agents-and-tools/mcp-connector) and any HTTP-capable MCP client. > 52…
Details
- Author
- lubosstrejcek
- Downloads
- 217
- Categories
- Other
Jump to
- 52 tools covering 88 VRM operations (direct + widget endpoints)
- All destructive tools are confirm-gated for safety
- Streamable HTTP transport for remote, API-backed usage
- Security-first design with per-request authentication
- 208 tests for reliability
- Compatible with Anthropic MCP Connector and any MCP-over-HTTP client
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Victron Vrm Mcp — Mcp ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install and run the server using npx victron-vrm-mcp or npm install -g victron-vrm-mcp. It listens on http://127.0.0.1:3000/mcp by default; configure with environment variables (PORT, HOST, ALLOWED_ORIGINS, etc.). For remote access, put HTTPS in front—Cloudflare Tunnel is recommended. Clients connect by providing the server URL and a VRM personal access token (or a deprecated Bearer token for testing). See the README for Anthropic Messages API, Claude Code, Cursor, and Windsurf configuration examples.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"victron vrm mcp \u2014 mcp server": [
{
"type": "url",
"url": "https://victron-vrm.example.com/mcp",
"name": "victron-vrm",
"authorization_token": "<your-vrm-personal-access-token>"
}
]
}
}Mcp_servers
[
{
"type": "url",
"url": "https://victron-vrm.example.com/mcp",
"name": "victron-vrm",
"authorization_token": "<your-vrm-personal-access-token>"
}
]Tools
[
{
"type": "mcp_toolset",
"mcp_server_name": "victron-vrm"
}
]Victron VRM MCP — MCP Server
MCP server for Victron Energy's VRM cloud API. Exposes 52 VRM tools over Streamable HTTP — ready for the Anthropic MCP Connector API and any HTTP-capable MCP client.
> 52 tools | Streamable HTTP | Security-first | 208 tests | MCP Connector compatible
---
Which package do I want?
This is the cloud / remote half of a pair. The local / LAN half is victron-tcp.
| | victron-tcp | victron-vrm-mcp (this repo) |
|---|---|---|
| Transport | stdio (local subprocess) | Streamable HTTP (remote) |
| Data source | Modbus TCP + MQTT on your LAN | VRM cloud API |
| Needs access to the GX on your LAN | Yes | No |
| Works when you're away from the boat / house | No | Yes |
| Works when the internet is down | Yes | No |
| Latency | Real-time (~50 ms) | ~15 min (VRM sampling) |
| Raw register access | Yes (900+ registers) | No |
| Write coverage | Read-only today; writes via MQTT planned | 24 destructive tools, all confirm-gated |
| MCP Connector API compatible | No (stdio) | Yes (HTTPS) |
| Clients | Claude Code, Claude Desktop, Cursor, Windsurf | Anthropic Messages API + anything that speaks MCP over HTTP |
| Auth | None locally (trusts LAN) | Per-request VRM personal access token |
Use victron-tcp when: you're on the same LAN as a GX device and want real-time access with raw register support.
Use victron-vrm-mcp when: you need remote access, you're building an API-backed app via the MCP Connector, or you don't want to expose anything on your LAN.
You can use both simultaneously — they serve different use cases.
---
Installation
Unlike victron-tcp, this package is a server you self-host, not a process your client spawns. You run it once, put HTTPS in front of it, and connect MCP clients to its URL.
Run from npm (recommended)
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
