TIA MCP
Provides an offline VCI Git workflow for committing uploaded raw documents to independent local Git revisions, inspecting history, exporting exact revisions, and reviewing package mappings and three-way conflicts.
Integrates with Siemens TIA Portal V21 and PLCSIM Advanced V8 to inspect offline projects, query blocks, tags, hardware, technology objects, references, and call graphs, make recoverable engineering changes with checkpoints and journals, and run simulation and block-testing workflows.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
TIA MCP
A Windows MCP server that lets an MCP client inspect and make recoverable changes to offline TIA Portal V21 projects, with simulation through PLCSIM Advanced V8. A .NET 10 host connects to isolated .NET Framework 4.8 workers. Siemens assemblies are loaded from your installed products and are not redistributed.
Status and safety: pre-1.0 and under active development. Offline tooling is validated in CI; live TIA Portal and PLCSIM runtime qualification is incomplete (see Current status). Use it only with offline projects, copies, scratch projects and simulators you own, never with production PLCs or plants. Independent project, not affiliated with Siemens (trademarks).
Documentation · Wiki · Current status · Remaining work · Discussions · Contributing
What you can ask
With the server connected, ask your MCP client in plain language:
"List the open TIA Portal sessions and open the packaging-line project." →
tia_discover,project_open"Which blocks call
MotorControl, and what is affected if I change its interface?" →call_graph,change_impact"Prepare that change, show me the preview, then apply it with a checkpoint." →
change_prepare,change_apply,change_restoreif it goes wrong"Create a PLCSIM instance and test that
Motor_OnfollowsStart." →sim_create,sim_test"Give me a health report of this project." →
project_health_report
Ask feature_catalog and target_capabilities what your target supports. The server
also offers workflow prompts (safe_change, project_health, block_test,
diagnose_fault) that walk through these steps.
Related MCP server: tiacommander-mcp
Explore a project
Browse project objects, follow block relationships and inspect the evidence behind each connection in the Project Explorer.

Actual Explorer UI with synthetic sample data. This offline snapshot is not a live TIA Portal session or evidence of native runtime qualification.
Architecture · Engineering workflow · Visual assets
Prerequisites
For the full engineering build and MCP server:
Windows with TIA Portal V21 and Openness installed and configured for your user.
PLCSIM Advanced V8 installed for the simulator adapter; running simulation also requires a usable license and a supported CPU/firmware combination.
.NET 10 SDK (selected by
global.json) and .NET Framework 4.8 reference assemblies.PowerShell 7, Python 3.13 and Node.js 24 for the development checks.
Use your normal authorized Windows engineering account. See environment diagnostics and Openness registration for setup. Without Siemens software you can still use the portable workflows and run the offline checks, as described below.
Working without any Siemens installation
The Host and portable libraries can be built on their own:
dotnet build src/TiaMcp.Host/TiaMcp.Host.csproj -c Release --artifacts-path artifacts/host-onlyPoint a stdio MCP client at the resulting
artifacts/host-only/bin/TiaMcp.Host/release/TiaMcp.Host.exe, using an absolute
path. Set --artifacts to the directory where the Host should retain uploaded
documents and reports. Add --no-native-workers to refuse Siemens calls before
worker startup. A regular development Host otherwise starts workers on demand.
Every Host option, its default and range are listed under
Host options.
For a portable Windows package, run ./scripts/Package.ps1 -Offline. This builds
only the Host and portable libraries, creates a ZIP with hashes and dependency
notices, and writes an external MCP configuration beside the bundle. The portable
binary always disables native workers, including direct launches. It requires the
.NET 10 ASP.NET Core shared runtime; Git is separately installed and optional.
See portable deployment and validation
for configuration, relocation and the package test command.
Already available in this setup:
Upload and hash-check supplied documents with
artifact_upload_begin,artifact_upload_chunkandartifact_upload_commit.Import saved project reviews, resolve captured diagnostic instances/signals, export offline watch plans and analyze supplied JSON/CSV measurements through the offline diagnostic workflow.
Inspect and compare supplied OPC UA NodeSets and explicit dependencies through the offline OPC UA workflow.
Inspect supplied AutomationML/CAEX 2.15 and 3.0, compare declared structure and review conservative topology impacts through the offline CAx workflow.
Inspect and compare supplied GRAPH XML, download exact source/reports/HTML and attach reports locally in Explorer through the offline GRAPH workflow.
Review supplied translation workbooks and prepare offline candidates through the translation workflow.
Review and commit uploaded raw documents to independent local Git revisions, inspect history and export exact revisions through the offline VCI Git workflow. This additionally requires the explicit
--git-executableHost option. Supplied package mappings and three-way conflicts can also be reviewed offline.Review detached Add-In selections against saved project reviews. The native TIA companion that sends them is verified separately (
local.addin.companion.20261029).Compare supplied Project Server observations, retaining session/lock/marking differences and coverage gaps without connecting to a server. Native collaboration workflows remain open.
Compare Teamcenter item/revision/dataset metadata through the supplied-review workflow; it does not verify native cache contents or grant checkout ownership.
Use the local Windows protected credential commands with hidden console input or an explicit stdin pipe; they do not configure a PLC or server.
Run the portable development checks below against retained or synthetic fixtures, and audit which historical evidence files are unavailable.
Opening TIA projects, exporting fresh native documents, compiling PLC programs,
applying native changes and running PLC simulations still require their Siemens
products. The full solution build, --diagnose and the discovery smoke check
below belong to that engineering environment. See the TODO for
the remaining work and current status for what is qualified.
Quick start
From the repository root on an engineering workstation:
.\scripts\Probe-Environment.ps1
.\scripts\Build.ps1
.\scripts\Test.ps1 -SkipBuildConfigure your MCP client's stdio server using your actual checkout path:
{
"mcpServers": {
"tia-v21": {
"command": "C:\\path\\to\\TIA_MCP\\src\\TiaMcp.Host\\bin\\Debug\\net10.0-windows\\TiaMcp.Host.exe",
"args": ["--timeout-seconds", "300"]
}
}
}Without --toolsets the Host advertises only the base and core tools (about 70 of roughly 320) to keep
the tool list and its context cost small. Add groups such as "--toolsets", "core,simulation" to args, or
"--toolsets", "all" for every tool; see
MCP surface for the groups.
Example: discover available TIA sessions
With the server connected, ask your MCP client:
Use
tia_discoverto list the available TIA Portal sessions.
For a command-line discovery smoke check after building:
python .\scripts\smoke_mcp.pyThe default smoke check performs discovery. See engineering workflows for the prepare → preview → checkpoint → apply → verify workflow, and deployment for packaging, launch options and SSH access.
What it supports
Inspection and tracing: project inventory, blocks, types, tags, references, call graphs and change-impact queries.
Project explorer and reviews: a read-only browser, portable exports, persistent snapshots, comparisons, searches and health reports.
Recoverable engineering: supported block, tag, hardware, technology-object and library changes, with checkpoints and journals.
Simulation and block testing: owned PLCSIM Advanced instances, simulated I/O and test assertions.
Support varies by target and feature. Use feature_catalog for implementation
scope and target_capabilities for the selected target. This is an evolving
prototype; offline tests, native compilation and runtime qualification are
separate claims. Consult current status, the
tool reference,
engineering coverage, the
release matrix and the TODO.
Changes can partially fail and require recovery from their checkpoint; they are
not transactions across Siemens calls. The simulation workflow operates on
adapter-owned simulator instances. Online access to real PLCs (compare, station
upload, download) exists only behind the off-by-default --physical-plc-online
Host option, is not qualified on physical hardware and never answers logins or
passwords; force and CPU mode control are not exposed
(real PLCs). Alarms of a WinCC Unified PC
Runtime can be read, and acknowledged only on a runtime on the same PC after an
explicit acknowledgement (Unified alarms);
nothing else is written to an HMI runtime. Keep project exports and credentials private.
Development checks
On Windows with PowerShell 7, .NET 10, Python 3.13 and Node.js 24:
# Contracts, Python harnesses, explorer unit tests and managed .NET suites.
# Does not require or start Siemens software.
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r scripts/requirements-test.txt
.\scripts\Test-Offline.ps1
# Browser tests use the dependencies pinned in package-lock.json.
npm ci
npx playwright install chromium
npm run test:explorer:browserGitHub Actions reports Python, managed .NET and browser validation separately.
Siemens-dependent checks run on a configured engineering workstation; see
Contributing. Generated reports, scratch projects
and screenshots belong in ignored artifacts/ and output/ directories.
Documentation
License
TIA MCP is developed by Nico Schürmann (@Sparkz400). Copyright 2026 Nico Schürmann.
TIA MCP's original code and documentation are licensed under Apache License 2.0; redistributions must keep the attribution in NOTICE. Third-party material retains its own license; see the OPC Foundation schema attribution. Siemens products and SDK assemblies remain subject to their own license terms. Provided "as is", without warranty.
Siemens, TIA Portal, SIMATIC, STEP 7, WinCC and PLCSIM are trademarks of Siemens AG. This project is independent and not affiliated with, endorsed or supported by Siemens. OPC UA is a trademark of the OPC Foundation.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Governed data discovery, exact queries, decisions, simulations, and runtime utilities over MCP.
Global CAD/BIM, industrial engineering (FEM, CFD) and property tools via one MCP endpoint.
Public MCP digital twin with synthetic systems and an agent firewall. No customer data.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceIndustrial-grade MCP server for Siemens TIA Portal (V17–V21). 120+ tools for PLC programming: create blocks (FB/FC/OB/DB), manage tags, compile, download, and simulate with PLCSim Advanced. On-premise, sovereign-AI compatible.19MIT
- FlicenseNot gradedqualityCmaintenanceMCP server that connects AI assistants to Siemens TIA Portal via the Openness API. AI-assisted PLC programming, project management, hardware configuration, cross-reference analysis, and deployment. 19 tools, 230 actions.67-
- AlicenseNot gradedqualityDmaintenanceAn MCP server for controlling Siemens TIA Portal, enabling AI agents to connect, read PLC tags, list blocks, inspect project structure, and compile projects. This community edition provides 5 read-only tools under the MIT license.MIT
- FlicenseNot gradedqualityCmaintenanceAn MCP bridge for Siemens TIA Portal that enables AI assistants to inspect PLC projects, import/export programs, and compile with read-only defaults and opt-in writes.-