Skip to content

TIA Portal Integration Overview

The TIA Portal Integration lets the AI Agent work directly with an open TIA Portal V21 project on the same machine — browsing blocks, reading SCL and Ladder, inspecting hardware configuration, creating and changing blocks, data types, tags, and technology objects, and compiling the result.

Capability Description
List blocks See all FBs, FCs, OBs, and DBs in the project
Read block interface View inputs, outputs, instance data, and local variables
Read block source Get the full SCL source of a block, or the interface and a per-network summary of a Ladder or FBD block
Read and write native Ladder Read the full logic of a LAD block, write new LAD blocks, change networks (see Native Ladder Blocks)
Inspect hardware Read the devices, the network topology, and search the hardware catalog
Create blocks AI can generate and import new SCL and LAD blocks, global and instance data blocks, and block folders
Data types, tags, constants List, create, import, and delete PLC data types, tag tables, tags, and user constants
Technology objects Create, configure, list, and delete motion axes and PID_Compact objects
Cross references Who calls a block, and what a block calls
Compile Compile the software or the hardware of a PLC and read the messages
Rename and move AI can rename blocks and move them between program folders
  • TIA Portal V21 must be installed on the same machine as S7 PLC Buddy.
  • A TIA Portal project must be open in TIA Portal before you connect.
  • No special TIA Portal licence add-ons are needed — the standard Openness API (included with TIA Portal) is used.

The TIA Portal integration works through a bundled MCP server — a small C# process that bridges S7 PLC Buddy to the TIA Portal Openness API via a local JSON-RPC channel.

  • In the installed app, the MCP server starts automatically when you connect.
  • The server communicates only on the local machine (no network traffic).
  • TIA Portal must stay open for the duration of the session.
  1. Open TIA Portal V21 and load your project.
  2. In S7 PLC Buddy, go to Settings → Connections → TIA Portal MCP.
  3. Click Connect. The status indicator turns green when the server attaches to the running TIA Portal instance.

If TIA Portal is not open, the connection will fail with a “portal not found” message. Open TIA Portal first, then retry.

Click Disconnect in Settings → Connections → TIA Portal MCP. TIA Portal continues running normally — disconnecting does not close the project.

Once connected, the AI Agent gains a full set of TIA Portal tools (see the Tools Reference for all of them). See Block Browser for reading code, Native Ladder Blocks for working with Ladder, and Ladder Migration for bringing programs from other systems into TIA Portal.

Example questions:

  • “List all blocks in this project.”
  • “Read the source of FC_SafetyLogic and explain it.”
  • “What I/O modules are on rack 0?”
  • “Create a new Function Block called FB_NewControl with these inputs…”
  • “Read FC_ConveyorStart and explain each network.”
  • “Which blocks call FB_MotorControl?”
  • “Compile PLC_1 and tell me what the errors mean.”