WinCC Unified MCP XT

You set up the WinCC Unified MCP XT server to interact with a Siemens WinCC Unified GraphQL endpoint. It exposes core SCADA actions as MCP tools, enabling AI assistants and other MCP clients to authenticate, browse objects, read and write tag values, query history, and manage alarms in a streamlined, programmable way.

How to use

You connect to the MCP server using an MCP client and then call the available tools to perform common SCADA tasks. The server exposes actions for user authentication, browsing SCADA elements, reading live and historical tag values, fetching active and logged alarms, writing to tags, and managing alarms. Start by ensuring your MCP client is configured to reach the WinCC Unified GraphQL endpoint, then call the tools in your usual MCP workflow to automate monitoring, control, and analytics tasks.

How to install

Prerequisites: ensure you have Node.js version 18.x or newer and npm installed.

# 1) Navigate to your project directory
cd your-project-directory

# 2) Install dependencies
npm install

# 3) Prepare configuration as shown below (config.js)

Configuration and start

The server is configured with a simple ES module config that points to your WinCC Unified GraphQL endpoint. You can customize the credentials if you operate with a service account.

export const config = {
  URL: "https://your-wincc-server.example.com/graphql", // required
  userName: "service_account_username", // optional
  pwr: "service_account_password", // optional
};

Starting the server

Once dependencies are installed and the configuration is prepared, start the MCP server with the following command.

node start

Connecting with Claude Desktop

To connect a Claude Desktop client to this MCP server, configure the Claude client to point to the MCP endpoint. Use the following example as a guide for the Claude desktop config.

{
  "mcpServers": {
    "WinCC Unified": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:3000/mcp"]
    }
  }
}

Available tools

login-user

Logs in with a username and password to obtain an authenticated session.

browse-objects

Browses configured SCADA elements to discover available objects.

get-tag-values

Reads current live values of configured tags.

get-logged-tag-values

Queries historical or logged tag values.

get-active-alarms

Fetches currently active alarms in the system.

get-logged-alarms

Retrieves previously triggered alarms from history.

write-tag-values

Writes new values to one or more tags.

acknowledge-alarms

Acknowledges active alarms.

reset-alarms

Resets or clears alarms as permitted.