For energy managers running Janitza GridVis

A GridVis MCP server that reads Janitza energy and power-quality data, never writes to a device

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

A first Janitza GridVis tool list, written as the manifest your IT team signs

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 response

The 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

Janitza GridVis at a glance: interfaces, access and what exists for AI

What we found
InterfacesGridVis 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
AuthenticationAny 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 serverNo 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 assistantNone found.
Other connectorsgame4automation/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

Where a Janitza GridVis connection needs engineering, not configuration

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.

02 · Addressing

Queries need the value-type catalogue

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

GridVis has its own time syntax

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

Basic auth and maintenance endpoints

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.

What the connector answers, and what it will not do

Questions it answers

  • What was the energy consumption of the compressor feeder last month, compared with the month before?
  • Which devices reported voltage dips or threshold events this week?
  • What is the current active power on main distribution board 1?

What it will not do

  • Write to a measuring device or anything in control: the only write is a proposed manual reading that the energy manager confirms.
  • Read more than the asking user may read in GridVis; each call authenticates as that person's GridVis user.
  • Call maintenance endpoints such as heapdump or threaddump; they are not on the manifest and are blocked at the gateway.

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.

Start with the Readiness Blueprint.

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.

Related

Questions Janitza GridVis teams ask before the first tool call

Does Janitza GridVis have its own MCP server?

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.

Do we need a particular GridVis edition for an AI connector?

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.

Can the assistant change settings on a measuring device?

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.

What does a GridVis connector cost?

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

Not a sales call. An architecture call.

Thirty minutes with the engineer who would build the connector, with your Janitza GridVis administrator in the room if you like.