01 · Support
REST is outside standard support
Janitza does not cover the REST API in its standard support; help with it is a paid service. Whoever builds the connector owns troubleshooting, and that belongs in the build plan.
For energy managers running Janitza GridVis
A GridVis MCP server gives Claude, ChatGPT or Copilot named tools for energy consumption, live values and power-quality events from Janitza measuring devices. GridVis publishes an OpenAPI description of its REST API with HTTP Basic auth. Janitza ships no MCP server as of 21 September 2026; one community plugin exists for desktop use.
What we build
Built on what Janitza electronics GmbH documents: projects, measuring devices, online values, historical measurement values, energy per timespan, events such as outages and threshold violations, transients, manual input values. Backends named below are documented resources; "confirmed in blueprint" means the vendor documentation sits behind a login and the resource is checked against your release first.
# janitza-gridvis-mcp-server: tool manifest, draft for blueprint week 1
# Every tool runs as the person asking. Nothing is written without a person confirming.
tools:
list_devices: # project -> measuring devices with id, name, type
backend: GET /rest/1/projects/{pname}/devices
mode: read
get_energy: # device, value type, start and end -> energy consumption
backend: GET /rest/1/projects/{pname}/devices/{devid}/hist/energy/{value}/{type}
mode: read
get_live_values: # project, devices, value types -> current online values
backend: GET /rest/1/projects/{pname}/onlinevalues
mode: read
get_historical_values: # device, value, type, timebase, range -> time series
backend: GET /rest/1/projects/{pname}/devices/{devid}/hist/values/{value}/{type}/{timebase}
mode: read
get_events: # device, range -> events such as outages and limit violations
backend: GET /rest/1/projects/{pname}/devices/{devid}/hist/events
mode: read
propose_manual_reading: # manual-input device, value, timestamp -> draft entry the energy manager confirms
backend: POST /rest/1/projects/{pname}/devices/{devid}/manualinput/{value}/{type}/{timebase}
mode: propose
audit: every call logged with user, tool, arguments and the Janitza GridVis responseThe manifest is the contract. A question that needs an operation not on it gets a new line and a review, not a wider permission.
Checked 21 September 2026
| What we found | |
|---|---|
| Interfaces | GridVis REST API v1 (SERVICE/WEB) (REST/JSON, docs public): Swagger and OpenAPI at <server>/rest/doc/, base /rest/1/, 35 paths for projects, devices, online and historical values, energy, events and manual input; starts with the GridVis service on Windows or the official Docker image; listed from the Standard edition · OPC UA (OPC UA, docs public): named as a connectivity option; the Online Recorder records third-party devices with an OPC UA connection · CSV and MSCONS import and export (file/EDI, docs public): data imports from CSV or MSCONS files |
| Authentication | Any authentication that works against SERVICE/WEB also works against the REST API; the preferred method is HTTP Basic over SSL, and the OpenAPI file declares basicAuth. |
| Vendor MCP server | No vendor server. No MCP server from Janitza; one community plugin, game4automation/janitza, exposes GridVis to an AI desktop assistant through the REST API. |
| Vendor AI assistant | None found. |
| Other connectors | game4automation/janitza is a community MIT plugin described as an MCP server for GridVis, using the REST API with user name and password; ioBroker.janitza-gridvis is a building automation adapter for energy values. |
Janitza electronics GmbH (DE). Energy managers and electrical and facility teams in manufacturing plants, data centres, buildings and utilities that use Janitza UMG power analysers and GridVis for energy monitoring, power quality and ISO 50001 energy management.
Why Janitza GridVis is hard for agents
01 · Support
Janitza does not cover the REST API in its standard support; help with it is a paid service. Whoever builds the connector owns troubleshooting, and that belongs in the build plan.
02 · Addressing
Data is addressed by project name and device id plus value, type and timebase path segments. The connector reads the value-type catalogue at /1/valuetypes first, or the assistant builds queries that return nothing.
03 · Time
Time ranges use a custom syntax such as NAMED_Today or RELATIVE_-3MONTH, and responses carry nanosecond UTC timestamps. The tools translate plain dates both ways so the assistant never guesses the format.
04 · Network
The API runs with HTTP Basic auth on an on-premises Windows or Docker service. A cloud assistant needs a gateway, and the maintenance endpoints such as heapdump and threaddump are blocked at that gateway.
Janitza GridVis holds the records. An assistant without a governed way in answers from whatever someone pasted into the chat. The connector is the governed way in: named operations, the person's own permissions, every call logged.
When this is the wrong page
If one energy manager wants to ask about their own GridVis data on a desktop, the community plugin may be enough. For ISO 50001 reports over years, a data warehouse fed from the REST API is the better home; a connector is right when many people ask in Claude, ChatGPT or Copilot and every call has to be logged.
Two weeks, €4,900 fixed price. Week one agrees the tool list with your Janitza GridVis owners and checks every backend against your release and licence. Week two tests whether a person's own Janitza GridVis permissions reach through the connector. You keep the manifest and a costed build plan, whoever builds it. All prices are net and exclude VAT.
What we need from you: a named Janitza GridVis administrator, a test or sandbox system we may call, and one business owner who can say which questions the assistant should answer first. The first production connector is usually a use-case pilot from €15,000; it runs in your environment, and the code is yours.
Not from Janitza as of 21 September 2026. A community plugin, game4automation/janitza, connects GridVis to a desktop AI assistant through the REST API. It suits one energy manager on one machine; a connector for many users adds per-person login, a gateway and an audit log.
The REST API is listed from the Standard edition and runs with the GridVis service on Windows or in the official Docker image. Janitza does not cover the REST API in its standard support, so troubleshooting sits with whoever builds and runs the connector. Check your edition with Janitza before the blueprint.
No. Every tool reads, and the one write on the manifest is a proposed manual reading that the energy manager confirms in GridVis. Maintenance endpoints such as heapdump and threaddump are not on the manifest and are blocked at the gateway.
The two-week Readiness Blueprint is fixed at €4,900: agreed tool list, backends checked against your release, identity tested end to end, costed build plan. The production connector is usually a use-case pilot from €15,000. Prices are net, excluding VAT.
Next step
Thirty minutes with the engineer who would build the connector, with your Janitza GridVis administrator in the room if you like.