WinCC V8 MCP Server

A Model Context Protocol (MCP) server that provides access to Siemens WinCC V8 SCADA systems through their REST API. Created by Andreas Vogler in 2025.

Features

🔐 Authentication

• User login with username/password credentials
• Support for Basic Authentication and Bearer Token authentication
• Automatic credential management for subsequent requests
• HTTPS support with optional certificate validation bypass

�️ Tag Management

• Connections: Read configuration data of connections and specific connection details
• Tag Groups: List all tag groups and get specific group configurations
• Structure Types: Access structure type definitions and their instances
• Tag Values: Read single or multiple tag runtime values
• Tag Writing: Write values to individual tags or batch write to multiple tags
• Tag Configuration: Access tag configuration data and list all tags with pagination

📊 Archive System

• Archives: List all process value archives and get specific archive details
• Archive Variables: Access archive variable configurations and data
• Archive Values: Read current and historical archive values with filtering
• Timers: Manage archive system timers and their configurations
• Archive Tags: Access archive system tag configurations

🚨 Alarm Logging

• Message Classes/Types/Groups/Blocks: Discover message classes, types, groups, and blocks
• Messages: List all messages and read specific message details
• Limit Values: Read configured limit values and per-tag limits
• Runtime Lists: Query message lists, short/long-term archives, hit/lock/hide/hidden lists via REST filters

🌐 HTTP Transport

• Express.js server with HTTP endpoints
• Streamable HTTP server transport for MCP communication
• JSON-based request/response handling
• Error handling and proper HTTP status codes

Available Tools

Authentication

• login-user - Log in to WinCC with username and password

Tag Management

• wincc-get-connections - Read all connection configurations
• wincc-get-connection - Read specific connection configuration
• wincc-get-groups - Read all tag group configurations
• wincc-get-group - Read specific tag group configuration
• wincc-get-structure-types - Read all structure type configurations
• wincc-get-structure-type - Read specific structure type configuration
• wincc-get-structure-variables - Read structure type instances
• wincc-get-tag-value - Read runtime value of a specific tag
• wincc-get-tag-values - Read runtime values of multiple tags
• wincc-write-tag-value - Write value to a specific tag
• wincc-write-tag-values - Write values to multiple tags
• wincc-get-tag-config - Read configuration of a specific tag
• wincc-get-tags-config - Read configuration of all tags

Archive System

• wincc-get-archives - Read all process value archive configurations