All tools of TIA MCP
The AI agent calls every tool by itself. Read tools never change the project; every write is backed up first, logged in the audit trail and can be undone. The list is generated directly from the current product version.
- tools in total
- 433
- areas
- 52
- write tools – each with a backup
- 191
- tools in a Copilot profile
- ≤ 128
Tool list
Service diagnostics – why the machine stopped
The PLC program traced back from the symptom, live values (OPC UA, Web API, S7, PLCSIM), device and terminal from the EPLAN PDF, the manual chapter, fault recording and a service report. Writes nothing to the PLC.
tia_diag_index_docsreadIndexes the EPLAN schematic PDF (devices, terminals, PLC addresses, pages) and the operating manual PDF (chapters) for the diagnostics.
tia_diag_recordreadFault recorder for intermittent stops: samples signals, waits for a trigger and reports which signal dropped first (pre-trigger window, CSV).
tia_diag_reportreadSaves a diagnostic result as an HTML/PDF service report with the Benešl Automation logo.
tia_diag_sourcesreadService diagnostics: which live-value sources work for this PLC (OPC UA, Web API, S7 PUT/GET, PLCSIM) and why the others do not.
tia_diag_trace_importreadEvaluates an exported TIA Trace measurement (CSV): order of the last changes before the stop.
tia_diag_valuesreadAdds values from the watch table _MCP_Diag (copied rows or 'name = value' lines) to a diagnostic session and re-evaluates the cause.
tia_diag_whyreadWHY IS THE MACHINE STOPPED – service diagnostics: walks the PLC logic back from the symptom, reads live values (OPC UA → Web API → S7 PUT/GET → PLCSIM) and names the blocking condition with device, terminal, cabinet and page from the…
Guided workflows
Project handover, finishing the Unified migration, HMI test, project from a specification, virtual FAT, pre-download check and service. Tools run one after another on their own; writes wait for approval.
tia_workflow_continuereadControls a running guide: action = status (state only) | approve (approve a writing step – only after the user agreed) | done (the manual step is finished) | skip (skip the step) | retry (repeat the step after an error) | cancel.
tia_workflow_startreadStarts a guide (list and inputs: tia_workflows).
tia_workflowsreadGuides – prepared procedures that run TIA-MCP tools in the right order, pass results between them and stop where a human decides: predani (project handover: compile, review, audit, Safety fingerprint, I/O checklist, alarm table, handover…
PLC – programming
SCL, LAD, FBD, DBs and UDTs, block interfaces, tags, libraries, compile and download.
tia_add_modbus_librarywriteInserts the universal Benešl Automation Modbus blocks into a PLC (SCL, S7-1500 and S7-1200/G2): typBaMbJob (job: unit ID, function 1/2/3/4/5/6/15/16, 0-based address, length, data index, period, status, counters), fbBaMbTcpClient…
tia_compare_blocksreadUnified diff of two blocks (even across PLCs) after normalizing the XML.
tia_compile_blockreadCompiles a single block (faster than compiling the whole PLC).
tia_compile_devicereadCompiles a device (PLC/HMI). structured=True: messages as {path:[device, Screens, screen, object], state, description} + a summary by error type (summary); only_errors omits warnings; path_filter restricts to a part of the tree (e.g.
tia_copy_block_between_projectswriteCopies blocks (and optionally the UDTs they need) from a PLC in one running TIA instance to a PLC in another (export → import Override).
tia_create_block_from_xmlwriteCreates/overwrites a block from an XML string.
tia_create_db_from_structwriteCreates a global DB or UDT from JSON: {name, kind: DB|UDT, members: [{name, datatype, start_value?, comment?, members?: [...] (nested STRUCT)}]} (via an SCL external source).
tia_create_lad_fbd_blockwriteCreates (or overwrites) an FB/FC/OB in LAD/FBD (including F_LAD/F_FBD – safety untested) from a JSON specification: {name, type: FB|FC|OB, language: LAD|FBD, number?, comment?, interface: {Input:[{name,datatype,comment?,start_value?}],…
tia_create_plc_tagswriteCreates PLC tags: tags=[{name, datatype, address ('%I0.0', '%MW10'), comment?, update?: true (overwrites existing)}].
tia_create_scl_blockwriteCreates block(s)/UDT/DB directly from SCL source text (FUNCTION_BLOCK, FUNCTION, DATA_BLOCK, TYPE).
tia_delete_blockwriteDeletes a block (a snapshot is taken before deletion – can be restored with tia_restore_snapshot).
tia_delete_plc_tagswriteDeletes PLC tags by name.
tia_export_blockreadExports a block to an XML file.
tia_export_data_typereadExports a UDT to XML.
tia_export_tag_tablereadExports a tag table to XML.
tia_get_start_valuesreadStartValues (factory parameters) from a DB – for parameter tables in operating manuals.
tia_global_library_infosreadKnown global libraries (without opening them): name, path.
tia_import_blockwriteImports a block from an XML file (Override).
tia_import_data_typewriteImports a UDT from XML. ignore = ['missing_references'] (UDT refers to a missing type – imported inconsistent), 'structural_changes', 'unit_attributes'; cultures = 'activate' | 'skip' (TIA V20+).
tia_import_scl_sourcewriteImports an SCL file as an external source + generates blocks.
tia_import_tag_tablewriteImports a tag table from XML. cultures = 'activate' | 'skip' (comments in languages that are not active in the project).
tia_instantiate_library_elementwriteInstantiates a MasterCopy from the library into a PLC/HMI.
tia_io_list_importwriteCreate PLC tags from an I/O list (after the preview).
tia_io_list_previewreadPreview of an I/O list import (XLSX/CSV from EPLAN/Excel): header detection, address normalisation (E/A and %I/%Q), data type, DI/DO/AI/AO, names by convention, duplicates and conflicts.
tia_library_check_versionsreadFor each library type, finds instances in the PLC/HMI and flags those that are not using the latest version (outdated).
tia_library_typesreadTypes and master copies in the library: library=None → project library, otherwise the name of an open global library.
tia_library_update_projectwriteUpdates instances of types in the project to the latest version from the library (LibraryType.UpdateProject) – a write!
tia_lint_and_correct_blockwriteChecks and fixes variable naming in a block according to the conventions (writes!).
tia_lint_blockreadChecks a block without writing: prefixes against conventions (or prefixes={section: prefix}), missing comments on parameters, unused Static/Temp.
tia_list_librariesreadOpen global libraries + summary of the project library.
tia_list_project_libraryreadTypes in the project library (Unified faceplates = LibraryType, HMI UDT, blocks) with versions and state, plus master copies.
tia_migrate_blockswriteRun the migration: rename, import into the target PLC (UDTs first) and compile.
tia_migrate_blocks_previewreadPreview of migrating blocks from old projects/libraries (XML exports of any TIA version or SCL sources): convention-based renames, collisions, code review.
tia_open_global_librarywriteOpens a global library (.al21/.al20…) in the running TIA instance (read-only by default).
tia_protect_blockwriteKnow-how protection of a block with a password.
tia_read_blockreadOpenness XML of a block (the name can also be a path 'Folder/Sub/Block').
tia_read_tag_tablereadTag table XML.
tia_rename_block_variablewriteRenames a block interface variable including all usages in the code (both SCL and LAD/FBD).
tia_rename_plc_tagwriteRenames a PLC tag (updates usages in TIA blocks symbolically).
tia_set_start_valueswriteSets the StartValue of DB/FB members by path: {"Pamet.MaxVal": "6.0", "Enable": "TRUE"}.
tia_update_block_interfacewriteModifies the interface of an existing block (export → XML → import): add=[{section, name, datatype, comment?, start_value?}] or {section: [...]}, remove=[names], change={name: {datatype?, comment?, start_value?}}.
tia_write_block_sourcewriteOverwrites an existing block's XML content (a snapshot of the original state is saved automatically).
Project from a specification
An Excel specification, a check and a plan for approval: PLC tags, data types, function blocks, DBs and translation.
tia_spec_planreadPrepares a PLAN of the project skeleton from a specification (Excel) – nothing is written to TIA until the user approves it: tags from the IO sheet → device data types → FBs for motor/valve/analog → station DBs → station FBs + instance…
tia_spec_previewreadPreview of the project skeleton from a specification (read only, nothing is written): checks the Excel (unknown types, duplicates, missing links), lists the data types, blocks and PLC tags that will be created from the IO sheet, the input…
tia_spec_templatereadSpecification template (XLSX) for the project skeleton: sheets Projekt, Zařízení (tag, type motor/valve/analog/pid, station, I/O links, ranges, time limits), IO (I/O list) and Návod; example=True adds a filled-in example.
PLC – reading and analysis
Reading blocks and DBs, cross references, call hierarchy, comparison.
tia_block_diagramreadDraws LAD/FBD networks and GRAPH sequences of a block as SVG, like in TIA.
tia_block_interfacereadBlock/DB/UDT interface as a tree {section: [members]} (flat=True: a flat list with path, type, start value).
tia_block_networksreadLAD/FBD networks of the block → [{index, title, comment, language, logic[]}]; full=True adds parts (operands, instance) and wires for precise analysis.
tia_check_scl_instructionsreadSCL check without writing: finds calls that are neither a system instruction, a project block nor a <TYPE>_TO_<TYPE> conversion (typically invented functions), with 'did_you_mean' suggestions; with device_name it also knows project…
tia_get_cross_referencesreadCross references of a block or PLC tag (Openness CrossReferenceService).
tia_list_blocksreadPLC block list (name, type, folder path).
tia_list_data_typesreadList of UDTs.
tia_list_tag_tablesreadList of PLC tag tables.
tia_lookup_instructionreadReference of S7-1200/1500 system instructions (timers, counters, conversions, strings, OUC/S7/Modbus communication, PID, Motion, diagnostics, data logging…): name, kind (FB with instance / function), parameters, availability per CPU.
tia_plc_tagsreadPLC tags (name, type, address, comment) from all or one table; pattern = regex on name/address.
tia_read_block_sclreadReadable content of a block without XML: for SCL blocks the reconstructed SCL text, for LAD/FBD networks with pseudologic ('#oRun := (RISING(#iStart) OR #oRun) AND NOT #iStop'), + interface and metadata.
tia_read_data_typereadUDT XML.
tia_read_db_structurereadStructure of a DB/instance DB/UDT: flat list of members (path, datatype, start_value, comment) + tree.
HMI – WinCC Unified and Comfort
Screens, items, faceplates, scripts, tags, Comfort → Unified migration, screenshots.
tia_describe_hmi_screenreadTextual description of a screen (buttons, texts) – for the 'Operation' chapter of the operating manual.
tia_export_hmi_screenreadExports an HMI screen to XML.
tia_export_hmi_tag_tablereadExports an HMI tag table to XML (Comfort/Advanced).
tia_get_alarmsreadHMI / ProDiag alarms – a basis for a fault table.
tia_hmi_comfort_export_allreadComplete export of classic WinCC (Comfort/Advanced) to out_dir plus manifest.json for re-import (tia_hmi_comfort_import_all): screens, tag tables and kinds = text_lists, graphic_lists, connections, cycles, templates, popups, slideins,…
tia_hmi_comfort_screen_itemsreadParsed overview of a Comfort screen (instead of XML): faceplate instances with their interface (tags/texts), objects with position, text, events (function+parameters) and dynamizations.
tia_hmi_migrate_faceplateswriteCompletes faceplates after a Comfort→Unified migration: for each Comfort instance, finds an empty container at the same position (or creates a new one), sets its type to '<type><suffix>' (latest version), names it after the Comfort one…
tia_hmi_migrate_udt_tagswriteFixes HMI UDT tags broken by the migration: for tags that were of type UDT_X in Comfort, sets them in Unified to 'UDT_X<suffix> V <version>' (HMI UDT from the project library) and restores their address from Comfort.
tia_hmi_unified_add_color_dynamizationwriteBit-based color dynamization (indicator light): tag bit==1 → on_color, otherwise off_color.
tia_hmi_unified_add_tag_dynamizationwriteDirect dynamization of a property by a tag (ProcessValue, Visible, …) without a mapping table.
tia_hmi_unified_create_itemwriteCreates an object (Circle, Rectangle, TextBox, Button, Line, Polyline, IOField, FaceplateContainer, …) and sets its properties.
tia_hmi_unified_delete_itemswriteDeletes objects by a list of names / regex / type (at least one filter is required).
tia_hmi_unified_drawwriteDraw WinCC Unified screen objects from JSON (rectangles, texts, circles, IO fields, buttons…) incl.
tia_hmi_unified_dumpreadJSON snapshot of Unified screens (objects, properties, dynamizations, scripts) – backup/diff; Unified screens cannot be exported to XML.
tia_hmi_unified_export_alarms_csvreadExports both discrete and analog Unified alarms to CSV (kind;Name;AlarmClass;EventText;Tag;TriggerBit;Limit…).
tia_hmi_unified_export_tags_csvreadExports Unified HMI tags to CSV (';', UTF-8 BOM – opens in Excel): name;DataType;Connection;PlcTag;Address;…
tia_hmi_unified_faceplate_instancesreadAll faceplate containers: screen, type+version, position, interface values, flags (no_type = empty container after migration, empty:<properties> = unbound).
tia_hmi_unified_faceplate_typesreadFaceplate types in the project library with versions, native size and interface property names (determined using a temporary container on the helper screen '__mcp_probe', which is then deleted).
tia_hmi_unified_find_itemsreadFinds objects across screens by name / type / text regex.
tia_hmi_unified_fix_migrationwriteAutomatic fixes after a Comfort→Unified migration: screen names with '\' (+ scripts), nonexistent tags with commas/dots.
tia_hmi_unified_import_tags_csvwriteBulk creation/update of HMI tags from CSV (header as in the export; name is required, other columns are set via set_tag – DataType, Connection, PlcTag, Address, AcquisitionCycle, InitialValue…).
tia_hmi_unified_lintreadChecks Unified HMI without compiling: containers without a type / unbound, nonexistent tags (with a suggested fix), scripts with migration artifacts, screens with '\' in the name, objects outside the screen.
tia_hmi_unified_place_faceplatewritePlaces a faceplate container of a type from the project library (default latest version) and maps the interface {"Ventil": "DB_Ventily\SO_1_S_011", "Jmeno": "SO1S04"}.
tia_hmi_unified_probereadDebugging screenshot of the runtime + visible texts (visible_texts – Unified draws screens as SVG) for building 'click' in tia_hmi_unified_screenshots; runtime_down = the web client reports that the runtime is not running.
tia_hmi_unified_rename_screenwriteRenames a screen and fixes ChangeScreen("…") in scripts.
tia_hmi_unified_render_svgreadSchematic SVG preview of a screen (rectangles/circles/lines/texts, faceplates as dashed frames with their type) – a quick visual check of the layout without runtime.
tia_hmi_unified_replace_in_scriptswriteBulk replacement in all scripts (regex or plain text).
tia_hmi_unified_replace_tag_refswriteRedirects tag references in dynamizations and faceplate interfaces: mapping {old: new}; auto_fix fixes nonexistent tags according to migration rules ('DB_x,y,z' → 'DB_x_y_z', '"DB_x.y"' → 'DB_x_y').
tia_hmi_unified_restorewriteRestores screens from a dump (tia_hmi_unified_dump): properties (geometry, colors, texts, ContainedType, faceplate interfaces), creates missing objects, delete_extra deletes objects not in the dump, re-creates tag dynamizations and event…
tia_hmi_unified_screen_itemsreadObjects of a Unified screen: type, position/size, text, style, faceplate interface, dynamization (tag, mapping table), optionally event scripts.
tia_hmi_unified_screensreadList of WinCC Unified HMI screens (objects, not XML).
tia_hmi_unified_screens_overviewreadOverview of Unified screens: size, background color, number of objects by type.
tia_hmi_unified_screenshotsreadScreenshots of WinCC Unified Runtime screens via the web client (Playwright).
tia_hmi_unified_scriptsreadScripts of event handlers and script dynamizations (screen, object, event, code) + known issues (not-found tag, octal escape, '\' in screen name).
tia_hmi_unified_set_all_screenswriteSame properties for all screens (e.g. white background: {"BackColor": "#FFFFFF"}).
tia_hmi_unified_set_faceplate_interfacewriteSets the interface properties of an existing faceplate container (tag or static value).
tia_hmi_unified_set_propertieswriteSets properties of a screen object: {"Left": 10, "BackColor": "#FF0000", "Visible": false, "HorizontalTextAlignment": "Center", "Font.Size": 30, "Text": "Nový text", "Name": "NovyNazev"}.
tia_hmi_unified_set_properties_bulkwriteSame properties for all objects of a screen matching a filter (name regex / type).
tia_hmi_unified_set_screenwriteScreen properties: {"BackColor": "#FFFFFF", "Name": "nova", "Width": 1920, ...}.
tia_hmi_unified_set_scriptwriteSets the JS script of an object's event handler (e.g.
tia_hmi_unified_set_tagwriteSets/creates an HMI tag: {"Connection": "Connection_2", "Address": "%DB1.DBX32.0", "DataType": "UDT_Ventily_UP V 0.0.1", "AcquisitionCycle": "T1s", "InitialValue": "0"}.
tia_hmi_unified_stretch_headerwriteStretches the header (rectangle with Top<=max_top + the title text field) across the full width and centers the text.
tia_hmi_unified_tagsreadWinCC Unified HMI tags (name, type, PLC tag, connection).
tia_hmi_unified_tags_exreadUnified HMI tags with type, address, connection, TagType (Simple/UDT/Array), optionally UDT members.
tia_hmi_unified_transformwriteBulk movement of objects: mode 'shift' (by dx,dy) | 'center_h' | 'center_v' | 'center' (center the content's bounding box on the screen).
tia_hmi_unified_update_faceplate_versionswriteSwitches containers of a given type (or all) to version to_version (default latest); the interface is preserved.
tia_import_hmi_screenwriteImports an HMI screen from XML.
tia_import_hmi_tag_tablewriteImports an HMI tag table from XML.
tia_list_hmi_screensreadList of HMI screens.
tia_list_hmi_tag_tablesreadList of HMI tag tables.
tia_read_hmi_screenreadHMI screen XML.
Unified faceplates
Faceplate templates for a motor, valve, analog value and PID, mapping UDTs and DBs to signals and screen generation.
tia_hmi_unified_faceplate_templatesreadLists the faceplate/object templates for WinCC Unified (motor, valve, analog, PID) with their signal interface, a draw-spec preview and the manual conversion procedure.
tia_hmi_unified_generate_faceplatewriteMaps PLC UDT/DB members to a faceplate template (tolerant to naming) and creates a template screen, a tag-bound screen, or places instances of an existing library type.
Hardware and networks
Devices, modules, addresses, IP, PROFINET, subnets, topology.
create_devicewriteCreates a device from a TypeIdentifier (e.g.
get_hardware_detailsreadHW tree of the device including MLFB (TypeIdentifier).
get_networksreadSubnets and nodes in the project.
list_devicesreadList of devices (PLC, HMI, …) in the project including groups.
list_technology_objectsreadPLC technology objects.
tia_compare_devicesreadCompares two PLCs: blocks present in only one, differing, matching (offline, via XML hash).
tia_connect_axis_drivewriteAxis TO → SINAMICS drive: connects actuator and encoder to the PROFIdrive telegram of the drive object (main telegram or a given number, e.g.
tia_connect_portswriteConnects two Ethernet/PROFINET ports (topology).
tia_connect_profinetwriteConnects an IO device (ET 200SP IM, drive, HMI...) to the controller CPU's PROFINET IO system.
tia_connect_subnetwriteConnects a device's network interface (HMI, PLC, switch...) to an Ethernet subnet without an IO system; the subnet is created if it does not exist.
tia_disconnect_portwriteRemoves all connections of the given port (topology).
tia_export_caxreadExports AutomationML (CAx) for EPLAN.
tia_find_typesreadOpenness API diagnostics: lists .NET types (including enum values) whose name contains the pattern.
tia_get_all_profinet_inforeadTable of Profinet names, IPs and devices across the project.
tia_get_device_ip_addressesreadIP addresses of a device's interfaces.
tia_get_object_propertiesreadIntrospection: properties of an object in the Openness tree (path e.g.
tia_hw_inventoryreadHardware bill of materials: all order numbers with firmware and quantities, device types, IP addresses and PROFINET names; export to Excel.
tia_import_caxwriteImports AutomationML (CAx) from EPLAN.
tia_invoke_object_methodwriteCalls a method of an object in the Openness tree (generic – use with caution).
tia_plc_protectionwriteCPU protection (V20/V21): without parameters only reads the state.
tia_plug_modulewritePlugs a module into the device's rack (ET 200SP / S7-1500) at the given slot.
tia_read_hw_addressesreadI/O addresses of the device's modules (incl.
tia_set_device_ip_addresswriteSets the IP address (and mask) of an interface.
tia_set_hw_addresswriteSets the module's starting I/O address.
tia_set_object_propertywriteSets a property of an object (generic write – use with caution).
Commissioning
Watch and force tables, user constants, instruction reference.
tia_accessible_devicesreadDevices reachable on the network via a PC interface (name, IP, series, MAC), like 'Accessible devices' in TIA.
tia_compare_onlinereadCompares the offline program with the PLC online (real PLC or PLCSIM) without writing: what differs, what is missing in the PLC and what is missing in the project.
tia_create_user_constantswriteCreates user constants: name, data type, value, comment; update=True overwrites existing ones.
tia_delete_user_constantswriteDeletes user constants by name (optionally only from one tag table).
tia_delete_watch_tablewriteDeletes a watch table (a snapshot is saved – tia_restore_snapshot brings it back).
tia_download_to_plcwriteDownload to a REAL PLC – disabled for the agent until the user turns on the switch "Agent may download to a real PLC" in the web GUI (Dashboard; the default without the switch comes from TIA_MCP_ALLOW_PLC_DOWNLOAD=1 in .env).
tia_export_watch_tablereadExports a watch or force table to XML (SimaticML).
tia_import_watch_tablewriteImports a watch or force table from XML (override).
tia_list_constantsreadPLC user constants (name, type, value, comment); include_system=True adds system constants (HW identifiers, OB numbers – useful for LADDR, DeviceStates etc.).
tia_list_watch_tablesreadWatch tables (including groups) and the PLC force table with the number of entries.
tia_online_fingerprintreadFingerprints of the program in the online PLC – a quick check whether the PLC has changed (address defaults to the PLC IP from the project).
tia_online_statusreadOnline state of the CPU, configured connection and available PC interfaces; optionally a short probe connection.
tia_prodiagreadProDiag: supervision blocks and their supervisions (type, text, alarm class) from the export.
tia_read_watch_tablereadEntries of a watch or force table: symbol/address, display format, modify/force value, triggers, comment.
tia_upload_stationwriteUploads a station from a PLC (IP address) into the project as a new device – hardware and program.
tia_write_force_tablewriteWrites entries of the PLC force table (offline table content only – forcing itself is activated online in TIA).
tia_write_watch_tablewriteCreates or extends a watch table: entries with symbol or address, display format, modify value, triggers and comment, or comment rows; groups; append or replace mode.
Simulation and virtual FAT
PLCSIM Advanced: instance control, tag read/write, trace, test scenarios.
tia_download_to_plcsimwriteCompiles the PLC and downloads it from the open project into the SIMULATOR (S7-PLCSIM / PLCSIM Advanced) via Openness.
tia_plcsim_controlwriteControl a PLCSIM Advanced instance: action = register | power_on | power_off | run | stop | memory_reset | step (N cycles in single-step mode) | free_run | unregister.
tia_plcsim_readreadReads current tag values from the simulated PLC.
tia_plcsim_scenario_templatereadXLSX test scenario template (Step | Set | Wait | Cycles | Expect | Within [ms] | Tolerance | Note) with logo and examples; if a PLCSIM Advanced instance is running, adds a sheet with all tags.
tia_plcsim_statusreadS7-PLCSIM Advanced: is the API installed (api_version), is the Runtime Manager running, network mode, which instances exist (state, CPU, IP) and whether the PLCSIM version matches the TIA version (tia_compat).
tia_plcsim_tagsreadTags of the simulated PLC (I/Q/M/DB from the instance tag list) with type and area; contains = name filter.
tia_plcsim_testwriteVirtual FAT: runs a test scenario (set / wait or cycles / expect with timeout and tolerance) on the simulated PLC and optionally saves an XLSX protocol with the company logo.
tia_plcsim_tracereadRecords tag values from the simulated PLC (control loops, ramps, sequences): periodic reads every interval_ms for duration_ms; returns min/max/last value and number of changes, optionally a CSV (';' separator).
tia_plcsim_writewriteWrites tag values to the simulated PLC (type from the tag list).
Virtual FAT – scenarios
Test scenarios from DBs, alarms, an I/O list and a state machine, executed in PLCSIM Advanced with tag recording to CSV.
tia_vfat_planreadVirtual FAT, step 1 – test plan from the project (read only): recognizes motors, valves, analog measurements and PIDs in the global DBs (as TIA → BAVIS), assigns roles (command, PLC output, feedback, fault, reset) and generates test…
tia_vfat_runwriteVirtual FAT, step 2 – executes the plan (from tia_vfat_plan, optionally edited) against a SIMULATED PLC: process models (motor, valve, analog, PID) in a closed loop read the PLC outputs and write the responses, test cases issue commands…
Documentation, review and reports
Code review, safety report, change report, I/O checklist, operator manuals, translations.
tia_block_doc_contextreadEverything needed to document a block in one call: interface, code (SCL / LAD-FBD pseudo logic), existing titles and comments, what is missing, callers, suggested language.
tia_change_reportreadReadable change report between project versions (git repo from tia_export_project_to_text): blocks (interface, network diffs), safety blocks, UDTs, tags, hardware – as Markdown.
tia_dump_allreadExport the whole project (JSON + XML) to a folder; git_commit=True commits the result.
tia_export_io_checklistreadFAT/SAT I/O checklist as XLSX (address, tag, type, comment, table + OK/NOK, date, tester, note columns).
tia_export_project_textsreadExports project texts to XLSX (translations): source language (default reference language) and target language (must be active).
tia_export_project_to_textreadDeterministic text export of the project (blocks, UDT, tags, HW) for git diff/commit.
tia_generate_call_hierarchyreadMermaid graph of the block call hierarchy.
tia_generate_io_checklistreadList of physical I/O (%I/%Q) with comments – a basis for an FAT/SAT checklist.
tia_generate_network_topologyreadMermaid graph of network topology based on IP addresses.
tia_generate_scl_from_csvreadGenerates an SCL DATA_BLOCK from a CSV 'Name,Type' (without writing to the project).
tia_generate_state_machinereadStructure of a sequential block (CASE) for a Mermaid state diagram.
tia_get_project_languagesreadProject languages.
tia_git_commitwriteExports the project to repo_dir and commits it (git init on first use).
tia_git_diffreadWhat has changed in the project since the last commit (after a fresh export).
tia_import_project_textswriteImports project texts.
tia_list_vci_workspacesreadVCI workspaces of the project (listing only).
tia_manual_collectreadGathers material for the operating manual into JSON: BOM (MLFB), network, blocks + call hierarchy + comments/interface, StartValues of the specified DBs, physical I/O, HMI screens (Comfort XML / Unified), alarms (Unified), F-signature.
tia_manual_renderreadFills the Benešl Automation LaTeX template with data (data.json from tia_manual_collect) and texts (content.json from the agent), matches screenshots (<screen name>.png in screenshots_dir) and compiles the PDF (pdflatex).
tia_manual_schemareadSchema of content.json for the manual generator – what the agent should write and in what format.
tia_project_add_languagewriteAdd a language to the project's active languages (e.g.
tia_read_text_filereadReads a text file (JSON/XML/SCL/log) from disk – for the manual's data.json, exports, snapshots.
tia_review_blockreadCode review of a block (deterministic checks, no changes): double coils/writes, unused variables, unwritten outputs, temp read before write, CASE without ELSE, division by variable, conditionally called timers/edges, unchecked…
tia_review_cross_plcreadCross-PLC and network check: duplicate IP addresses / PROFINET names, communication instances per PLC (PUT/GET, TSEND_C, MB_CLIENT…), same-named global DBs and UDTs with different structure (communication DBs that drifted apart) and DBs…
tia_review_programreadCode review of all FB/FC/OB in a PLC (or folder): totals by severity, worst blocks, findings and global operands written from several blocks.
tia_set_block_documentationwriteWrite documentation into a block without changing code: block title/comment, network titles/comments, variable comments.
tia_texts_apply_translationsreadWrite translations into the XLSX (file only): fills all rows with the same source text, applies the glossary, rejects translations with broken placeholders.
tia_texts_statsreadStatistics of a project text export: source/target languages, missing translations, categories.
tia_texts_translation_batchreadBatch of UNIQUE texts to translate from the export with matching glossary terms.
Project audit
Review of all PLCs, a check across PLCs and the network, unused blocks, UDTs and tags; one verdict and a report.
tia_find_unusedreadUnused blocks / DBs, UDTs and PLC tags (project clean-up): a reference is a name appearing in the text of another block (SCL, LAD/FBD operands, interface) from the index; OBs are entry points, an FB is paired with its instance DB, blocks…
tia_project_auditreadOne-shot read-only AUDIT of the project: code review of all PLCs (errors/warnings/recommendations, worst blocks), cross-PLC and network checks (duplicate IPs / PROFINET names, connection IDs, communication, drifted shared DBs/UDTs) and…
Manual update
Comparing the source data with the previous manual version, mapping changes to chapters and applying edits with a document revision.
tia_manual_updatereadUpdates a finished operating manual after project changes.
Alarms
PLC alarm export and import, alarm tables, alarms from a list.
tia_alarm_tablereadFault table XLSX: WinCC Unified alarms + Program_Alarm/ProDiag (source, name, text, class, trigger, info) with empty cause / remedy columns for the operator manual.
tia_alarms_from_listwriteBit alarms from a list: PLC DB with a Word array (bit = alarm), HMI tags and WinCC Unified discrete alarms (trigger tag + bit, class, text).
tia_plc_alarms_exportreadExport PLC alarms to XLSX: Program_Alarm instance texts, alarm text lists, ProDiag supervisions (S7-1500), alarm classes.
tia_plc_alarms_importwriteImport PLC alarms from XLSX (texts | textlists | supervisions | classes).
Alarm review
Static review of WinCC Unified alarms and PLC messages per ISA-18.2 and EEMUA 191 with a score and a report.
tia_alarm_reviewreadReview of the alarm database against ISA-18.2 / EEMUA 191 (read only): priority distribution against the recommended one (5 % high / 15 % medium / 80 % low), missing or duplicate texts, alarms without a class, medium/high priority without…
SIMATIC SD documents
Export/import of blocks as readable text (.s7dcl) and import preview with diff.
tia_export_documentsreadExports blocks (SCL, LAD, FBD, DB, OB…) and UDTs as SIMATIC SD documents (.s7dcl, texts in .s7res) – readable text ideal for git diff and code review.
tia_import_documentswriteImports SIMATIC SD documents (.s7dcl/.s7res) from a folder (recursively) – UDTs first.
tia_preview_importreadImport preview without writing: what will be created, overwritten or stay unchanged, with a unified diff against the current project.
Safety
F-signature and safety report.
tia_get_f_signaturereadOffline F-signatures of all F-blocks plus the safety program signatures.
tia_safety_reportreadSafety program overview of an F-CPU: F-runtime groups (F-OB, cycle, max.
F-program review
Extended review of an S7-1500F F-program: F-I/O, signatures and baseline, cycles and watchdog, structure. An aid, not a validation.
tia_safety_reviewreadExtended review of the S7-1500F safety program (helper, not a replacement for certified validation per IEC 61508 / ISO 13849).
Migration from other platforms
Beckhoff, B&R, CODESYS/WAGO and Schneider → Siemens: SCL, LAD, data types, I/O, Unified HMI, axes, report; STL → SCL, GRAPH reading.
tia_convert_stl_to_sclreadSTL (AWL) → SCL migration without writing: bit logic (AND before OR, brackets, S/R, edges), accumulator and arithmetic, comparisons, jumps, CALL.
tia_create_graph_blockwriteCreates an S7-GRAPH block from a specification (steps, actions, transitions, supervisions); branches and jumps are derived automatically.
tia_migrate_applywriteMigration to Siemens – imports the converted result into the open TIA project: constants, tags, technology objects, SCL/LAD blocks, OB1, HMI tags and screens, alarms and compile.
tia_migrate_convertreadMigration to Siemens – converts the source project into TIA sources: ST → SCL, LD → LAD, SFC → SCL, UDTs, DBs, PLC tags, constants, axes → technology objects, alarms, WinCC Unified screens and an HTML report with effort estimate.
tia_migrate_scanreadMigration to Siemens – survey of a source project (Beckhoff TwinCAT 3, B&R Automation Studio, PLCopen XML from CODESYS/WAGO/Schneider Machine Expert, Schneider Control Expert): POUs, data types, I/O, tasks, HMI screens, libraries.
tia_read_graphreadGRAPH blocks: steps (number, name, initial, actions with qualifiers), transitions with operands, branches and links – a readable overview of the sequence without XML.
Technology objects
Axes, cams, measuring inputs and PID: creation, parameters, leading axes; users and roles (UMAC).
tia_axis_configurewriteAxis (technology object) setup with readable keys: max velocity, dynamics, software limits, modulo, gear and units.
tia_create_technology_objectwriteCreates a technology object: to_type 'TO_PositioningAxis' | 'TO_SpeedAxis' | 'TO_SynchronousAxis' | 'TO_ExternalEncoder' | 'TO_Cam' | 'PID_Compact' …; the version must match the CPU firmware.
tia_set_to_masterswriteSynchronous axis (TO_SynchronousAxis) or kinematics (TO_Kinematics – conveyor tracking): adds leading axes/encoders – setpoint or actual value coupling.
tia_set_to_parameterswriteSets technology object parameters; also returns the previous values – calling again with them undoes the change.
tia_to_parametersreadParameters of a technology object (axis, PID…) with values; pattern = regex on the parameter name.
Software Units
Units, namespaces, relations, published blocks, moving blocks into units and checks.
tia_unit_checkreadChecks Software Units: empty units, relations to missing units or DBs, published objects without a namespace.
tia_unit_createwriteCreates (or updates) a Software Unit with a namespace preset and author.
tia_unit_create_sclwriteCreates blocks, UDTs and DBs from SCL source directly inside a Software Unit.
tia_unit_move_blockswriteCopies or moves blocks from the main program into a Software Unit (import first, original deleted only afterwards).
tia_unit_relationwriteSoftware Unit relation to another unit, a global DB outside units or a technology object; can also remove it.
tia_unit_set_accesswriteSets Published/Unpublished access and/or namespace of blocks and types in a unit; returns previous values.
tia_unitsreadPLC Software Units (V18+): units, namespace preset, relations, blocks and types with namespace and Published/Unpublished access.
SINAMICS drives
Startdrive: drive creation, parameters, telegrams, drive comparison and Excel export.
tia_drive_comparereadCompares the parameters of two drives (series machines, drive replacement).
tia_drive_createwriteCreates a SINAMICS drive by order number; the firmware version comes from the hardware catalog.
tia_drive_export_paramsreadExports drive parameters to Excel or CSV.
tia_drive_paramsreadReads SINAMICS drive parameters by number, range or text search, optionally with enumeration values.
tia_drive_set_paramswriteWrites drive parameters offline in the project and returns the previous values for rollback.
tia_drive_telegramwriteSets the PROFIdrive telegram of a drive object (main, supplementary, safety, torque).
tia_drivesreadSINAMICS drives in the project (Startdrive): drive objects, telegrams and key data.
OPC UA
PLC server interfaces: generation from DBs, UANodeSet import and export.
tia_opcua_access_controlreadOPC UA server access control of a PLC (TIA V21, CPU FW 3.1+): roles (with the mapped project role and Browse/Read/Write/Call/ReceiveEvents/ReadRolePermissions per namespace) and namespace access restrictions (signing, encryption, session).
tia_opcua_exportreadExports an OPC UA server interface as UANodeSet XML (for MES/SCADA or editing and re-import); also reference namespaces (companion specifications) and SIMATIC interfaces.
tia_opcua_export_serverreadExports the complete OPC UA server address space of a CPU as UANodeSet XML (like 'Export OPC UA XML' in the CPU properties) – for offline configuration of OPC UA clients / SCADA.
tia_opcua_generatewriteGenerates an OPC UA server interface from global DBs (objects, structures, variables mapped to DB members).
tia_opcua_importwriteImports an OPC UA server interface from UANodeSet XML with variable mappings to DB members.
tia_opcua_interface_setwriteSettings of a PLC OPC UA server interface: Enabled / Author (writability checked), for reference namespaces GenerateNodes and UseStringNodeIds (V21), for SIMATIC interfaces UseStringNodeIds.
tia_opcua_interfacesreadLists the PLC's OPC UA server interfaces, reference namespaces and SIMATIC interfaces.
tia_opcua_namespace_restrictionwriteAccess restriction of an OPC UA server namespace (TIA V21): values = {"SigningRequired": true, "EncryptionRequired": true, "SessionRequired": true, "ApplyRestrictionsToBrowse": false}.
tia_opcua_rolewriteOPC UA server role of a PLC (TIA V21, CPU FW 3.1+, OpcUaAccessControl on): standard=True adds a standard role (Anonymous, AuthenticatedUser, Observer, Operator, Engineer, Supervisor, ConfigureAdmin, SecurityAdmin), permissions = {"Read":…
tia_opcua_server_settingswriteOPC UA server/client settings of a CPU (attributes of the OPC UA item): without values reads everything (OpcUaServer, OpcUaPort, OpcUaAccessControl, OpcUaGuestAuthentication, OpcUaPasswordAuthentication, OpcUaMaxSessions, …) and lists the…
tia_opcua_userswriteOPC UA server users of a CPU without UMAC (FW < 3.1; user name + password): list without parameters; create / set_password with the password only from password_file or password_env – never returned or logged; delete removes.
IP plan and PROFINET
IP addresses and PROFINET names via Excel: export, check, apply, topology comparison.
tia_connection_createwriteCreates a communication connection PLC↔PLC or PLC↔third-party device (TIA Portal V21+).
tia_connection_deletewriteDeletes a communication connection (TIA Portal V21+).
tia_connection_setwriteChanges connection properties (TIA Portal V21+) – ID (hex text), ports, TSAP, active connection establishment, names, the address of an unspecified partner, AccessPoint/Online for HMI connections.
tia_connectionsreadCommunication connections of the project (TIA Portal V21+): S7, TCP, ISO-on-TCP, UDP, ISO, FDL and HMI connections.
tia_gsd_exportreadExports the GSDML file of an I-device (TIA Portal V21+) – for a higher-level controller in another project or system.
tia_idevice_configurewriteI-device: enables/disables I-device mode on the CPU's PROFINET interface (the IO controller remains), assigns it to the higher-level IO system (higher_level = name of the IO system or of the higher-level controller's device) and creates /…
tia_ip_plan_applywriteApplies IP addresses and PROFINET names from the Excel IP plan to the project (only if the plan has no errors).
tia_ip_plan_checkreadCompares an edited IP plan with the project: changes, unknown interfaces, plan errors, topology differences.
tia_ip_plan_exportreadExports the project's IP plan and PROFINET names (and port topology) to Excel with checks.
tia_mrp_configurewriteMRP (PROFINET ring redundancy): creates an MRP domain in the subnet (or uses an existing one), assigns the members' interfaces to it and sets the role.
tia_network_topologyreadNetwork topology with subnets, IO systems and port interconnections; export to CSV, Excel, SVG and draw.io.
tia_profinet_overviewreadPROFINET configuration (read only): subnets with MRP domains and sync domains (participants, send clock), IO systems with IO devices (RT class, sync role, update time, watchdog), I-device interfaces of CPUs with transfer areas (direction,…
tia_sync_domain_configurewriteSync domain (IRT / isochronous PROFINET): creates a domain in the subnet, assigns the members' interfaces and sets the synchronization role and RT class.
Multiuser Engineering
Project servers, local sessions, object marking and check-in.
tia_mu_commitwriteMultiuser check-in: commits the marked changes of the local session to the server with a comment.
tia_mu_create_sessionwriteMultiuser: creates a local session for a server project.
tia_mu_markwriteMultiuser: marks or unmarks PLC blocks in the local session before editing.
tia_mu_markingsreadMultiuser: objects marked in the local session, conflicts and up-to-date state.
tia_mu_open_sessionreadMultiuser: opens a local session file.
tia_mu_serversreadMultiuser Engineering: configured project servers, server projects and open local sessions.
Engineering tools
HW catalog, EPLAN ↔ TIA (AML), library upgrade, safety from C&E matrix, unit tests, Test Suite.
tia_cax_comparereadCompares AutomationML from EPLAN with the project: hardware, network addresses and tags.
tia_hw_catalogreadSearches the TIA hardware catalog by order number or text and returns type identifiers and versions.
tia_library_upgradewriteUpgrades a global library from an older TIA version (.al1x or archive) to the current version; the original stays unchanged.
tia_safety_ce_generatewriteGenerates an F-LAD/F-FBD block from a cause & effect matrix (Excel); preview by default, to be validated by a responsible person.
tia_testsuitewriteTIA Test Suite via Openness: status (rule sets, test cases with scope, test sets, system tests), export rule sets / test cases / system tests to a file, run style guide, load and run application tests.
tia_testsuite_managewriteTest Suite changes and runs: load rule sets / test cases / test sets / system tests, create from library master copies, copy rule set scope, set the OPC UA scope of a system test, run test sets and system tests, delete.
tia_unit_test_generatewriteGenerates a unit test FB for an FB/FC from test cases (inputs, expected outputs, cycles) and an OB that runs it.
tia_unit_test_runwriteRuns the unit tests of a block in PLCSIM Advanced and reads the results.
Tracing and comparison
Signal path from the PLC to the HMI screens (tags, blocks, screens, scripts).
tia_trace_signalreadTraces a signal across the project: PLC tag → usage in the program (cross references) → WinCC Unified HMI tags pointing to it → screens and items with a dynamization or script → alarms.
Security and users
UMAC users and roles, project and PLC protection, password policy, certificates.
tia_certificatesreadCertificates in a device's certificate store (Id, CN, validity, private key yes/no) – never the private keys; without device_name for all PLCs of the project.
tia_plc_access_controlwritePLC access control via users (CPU FW 3.1+): sets the mode and returns the previous one.
tia_protect_projectwriteEnables project protection and user management (UMAC) with an administrator account; password only from a file or environment variable, requires confirm=True.
tia_security_certificatewriteCertificates in a device's store (device_name = CPU / HMI): action=create (usage OpcUaServer | OpcUaClient | OpcUaClientServer | WebServer | Tls, common_name, validity, subject alternative names, signature), action=import (.cer/.crt/.der,…
tia_security_certificate_exportreadExports the public part of a certificate (Id or CN) from a device's store to a file (.cer/.crt/.der) – without the private key.
tia_security_master_secretwriteProtection of confidential PLC configuration data (Master Secret): action = protect | protect_all (V21 – also all other downloadable configuration data) | unprotect_all (V21) | change_password | unprotect | reset.
tia_security_overviewreadProject and PLC security in one place: users, roles, password policy and, per PLC, access level, access control, confidential data protection, certificates, Syslog and web server users.
tia_security_syslogwriteSyslog. With device_name the CPU settings (S7-1500 FW 3.1+): EnableSystemLogging, TransportProtocol (UDP / TLS), target servers address + port (add / delete).
tia_security_webserver_userswriteWeb server users of a CPU (without UMAC): list without parameters; create with permissions (ReadTag, ModifyTag, DoDiagnosis, …) and a password via password_file / password_env; permissions without create change the permissions; delete…
tia_umac_device_rightsreadDevice function rights (PLC/HMI) that can be assigned to a custom role.
tia_umac_password_policywriteProject password policy: read or set (length, digits, special characters, ageing, reuse).
tia_umac_rolewriteCustom UMAC role: create, comment, engineering rights, device rights, delete.
tia_umac_umcwriteUMC (central user management) in a protected project: action = list | create_user (offline UMC user without a UMC server) | create_group (offline group) | update (roles, activation) | delete | check / sync (consistency / synchronisation…
tia_umac_userwriteProject user (UMAC): create (password only from a file or environment variable), roles, comment, alias, activation, password change, delete.
tia_umac_usersreadProject users, roles and rights (UMAC, TIA V17+) – read only.
Safety validation and F-parameters
Safety Validation Assistant (V21), activation tests, F-parameters of fail-safe modules.
tia_f_io_parametersreadF-parameters (Failsafe_*) of fail-safe modules of a device or the whole project – consistency check with the F-CPU.
tia_safety_activation_testwritePrepares a Safety Validation Assistant activation test (V21) from a specification; never confirms test results.
tia_safety_validationreadSafety Validation Assistant (V21): activation tests, safety functions with conditions, test states, validity check.
tia_safety_validation_printoutreadPrintout of a Safety Validation activation test to a PDF file.
tia_set_f_io_parameterswriteSets F-parameters (Failsafe_* only) of a fail-safe module; returns previous values.
HMI – connections, alarms and logging
WinCC Unified: HMI connections to PLCs, alarms, classes, logs, logging tags, runtime settings.
tia_hmi_unified_configreadWinCC Unified beyond screens: HMI connections (incl.
tia_hmi_unified_config_setwriteCreates, changes or deletes a WinCC Unified object (connection, alarm, alarm class, log, logging tag, alarm audit class, OPC UA alarm type) with dotted property paths (connection driver properties as 'DriverProperties.<name>'); returns…
tia_hmi_unified_connect_plcwriteCreates an HMI connection to a PLC in the project.
tia_hmi_unified_logging_tagsreadWinCC Unified logging tags (HMI tag → data log, mode, cycle, limits, smoothing).
tia_hmi_unified_runtime_settingswriteWinCC Unified runtime settings: read, or set with dotted paths; returns previous values.
Fingerprints and version control
Content fingerprints of blocks, VCI workspaces, export and synchronisation with files for Git.
tia_fingerprintsreadContent fingerprints of blocks, UDTs and tag tables (V19+) per aspect; save a baseline and compare: code change vs.
tia_vci_exportwriteMaps PLC objects into a VCI workspace and writes them as files (SCL/DB/UDT, otherwise SIMATIC ML).
tia_vci_statusreadState of mapped objects of a VCI workspace: equal / unequal / file missing and where the change is.
tia_vci_syncwriteVCI synchronisation: project → files or files → project (changes the project).
tia_vci_workspacewriteVCI workspace in the project: create (root folder e.g.
Git
Status, history, branches, merge, tags and push with a preview; never force, reset or rebase.
tia_gitwriteSafe git operations on the project text-export repo: status, log, branches, checkout, merge (no auto conflict resolution – aborted and reported), push (preview first, sent only with confirm=True), fast-forward pull, tags.
Block help
User-defined help for your own blocks (Shift+F1 in TIA) generated from code and an AI description.
tia_block_helpreadUser-defined help for blocks (Shift+F1 in TIA): an HTML page per block in UserFiles/UserDocumentation with interface, networks, call example and AI-written description; regenerates only changed blocks.
TIA → BAVIS (web SCADA)
Generates a ready BAVIS web SCADA project from TIA data blocks, UDTs and alarms: connections, addressed tags, objects, alarms and screens.
tia_bavis_exportreadTIA → BAVIS (web based SCADA): generates a BAVIS project (JSON for Configuration → Project → Import) from the PLC: S7 connection for non-optimized DBs and I/Q/M tags with addresses computed from the DB layout, OPC UA for optimized DBs,…
Handover documentation
Handover PDF: architecture, blocks, I/O, alarms, review, fingerprints and changes since the last issue, protocol.
tia_handover_docreadSoftware handover documentation (PDF/LaTeX with the Benešl Automation logo): project overview, hardware and IP addresses, call hierarchy, block descriptions (title, comment, interface, networks + AI texts), DBs and UDTs, I/O, HMI alarms,…
Diagnostics via CPU web server
Read-only S7-1500 Web API: operating mode, diagnostic buffer, alarms and values; trusted or pinned certificate.
tia_plc_web_diagreadOnline diagnostics of an S7-1500 via the CPU web server (Web API, read only): operating mode, diagnostic buffer, active alarms (FW V3.0+), variable values.
Live PLC values
Reading values, trends and writing to a running S7-1500 through the Web API; writing is off by default, with a preview and a token.
tia_plc_live_readreadCurrent variable values from a REAL S7-1500 PLC via the CPU web server (Web API, read only): variables=['"DB_Process".LT1.rPV', ...] and/or db_name + device_name (all scalar members of the DB from the project, max 200).
tia_plc_live_trendreadRecords the course of variables from a REAL PLC (Web API, read only): periodic reading every interval_s (min 0.2 s so the CPU is not loaded) for duration_s (max 3600 s).
tia_plc_live_writewriteWrites values to a RUNNING REAL PLC (Web API) – disabled for the agent until the user turns on the switch "Agent may write values to a running PLC" in the web GUI (Dashboard; the default without the switch comes from…
Hardware – modules
Free slots, moving and copying modules, swapping for another type while keeping the configuration, module description.
tia_change_module_typewriteReplaces a module / CPU with a compatible type or another firmware version while keeping the configuration (DeviceItem.ChangeType) – e.g.
tia_move_modulewriteMoves (or with copy=True copies) a module to another rack position – also into another device (target_device); parameters and addresses go with it.
tia_plug_locationsreadRack slots of a device (read only): occupied positions (module, TypeIdentifier, path) and free positions (GetPlugLocations) – basis for tia_plug_module / tia_move_module.
tia_update_module_descriptionwriteUpdates module descriptions (ModuleDescriptionUpdater – a newer HSP/GSD revision in the catalog).
HMI – Unified lists, scripts and tags
Text and graphic lists, global script modules, native tag export and import, limits, screen groups, rescaling to another resolution, validation, dynamizations and plant views.
tia_hmi_unified_add_dynamizationwriteDynamization of an item property of any kind: script (with trigger: cycle, tags, custom cycle; SyntaxCheck in the result), expression (formula), flashing (colors, rate, condition – color properties only), resource_list (text/graphic list…
tia_hmi_unified_attribute_inforeadWhich attributes of a WinCC Unified object can be written (GetAttributeInfos → AccessMode), current values, compositions and actions.
tia_hmi_unified_export_tagsreadNative YAML export of WinCC Unified HMI tags per tag table (out_dir/<table>/…).
tia_hmi_unified_import_listswriteImports text / graphic lists from YAML (files from tia_hmi_unified_lists out_dir or edited by hand); a list with the same name is overwritten.
tia_hmi_unified_import_script_moduleswriteImports global script modules from a folder (export of tia_hmi_unified_script_modules) or one module from text (module + code).
tia_hmi_unified_import_tagswriteImports HMI tags from YAML (format of tia_hmi_unified_export_tags) – each file into `table`, otherwise into the table named like the file; existing tags are overwritten, new ones created.
tia_hmi_unified_listsreadWinCC Unified text, graphic (V21) and system text lists: kind = text | graphic | system | all.
tia_hmi_unified_plant_viewsreadPlant views (WinCC Unified V21, Cpm.PlantViewsProvider): views, assigned HMI and the node tree with plant objects.
tia_hmi_unified_replace_in_script_moduleswriteFind and replace in the code of global script modules (export → replace → import of the changed modules only, backup of the original export, check of remaining matches).
tia_hmi_unified_resize_screenswriteRescales Unified screens to the panel resolution (HmiScreen.ResizeScreen): resolution ('1280x800') first changes the device resolution (runtime settings), then screens and items are scaled by the ratio of old and new resolution (without a…
tia_hmi_unified_screen_groupsreadWinCC Unified screen groups (tree) with their screens and the root screens.
tia_hmi_unified_script_modulesreadGlobal script modules of WinCC Unified (HmiSoftware.Scripts): names and functions; include_code=True returns the JavaScript; out_dir stores the native export (<module>.hmi.yml + .js, git-friendly).
tia_hmi_unified_set_listwriteCreates or overwrites a WinCC Unified text (kind=text) or graphic (kind=graphic, V21) list – Openness has no Create, so YAML is generated and imported – or deletes it (delete=True).
tia_hmi_unified_set_plant_viewwritePlant views (V21): create_view | rename_view | delete_view | assign_hmi | create_node (path 'Area/Unit', creates intermediate nodes) | rename_node | delete_node.
tia_hmi_unified_set_screen_groupswriteUnified screen groups: create_group (path 'A/B') | rename_group | delete_group (only empty) | create_screen (new screen in a group).
tia_hmi_unified_set_tag_tableswriteGroups and tables of Unified HMI tags: create_group (path 'A/B') | rename_group | delete_group | create_table (optionally in a group) | rename_table | delete_table (only empty).
tia_hmi_unified_set_thresholdswriteEdits the thresholds of a numeric Unified HMI tag: the two fixed thresholds (Upper / Lower Threshold) are selected by index, name or mode and get a value (value type Constant / Tag is set automatically).
tia_hmi_unified_tag_detailsreadDetails of a Unified HMI tag: all properties incl.
tia_hmi_unified_tag_tablesreadWinCC Unified tag tables including tables in tag table groups, with tag counts and the group tree; optionally the system tags.
tia_hmi_unified_validatereadValidation of WinCC Unified without compiling: Validate() of screens, items, tags, connections, alarms and runtime settings plus SyntaxCheck() of scripts (dynamizations and events).
HMI – fixes after Comfort → Unified migration
Symbol library objects to dynamic SVG widgets, truncated texts and characters in alarm texts.
tia_hmi_migrate_symbol_librarywriteConverts Comfort/Advanced "Symbol library" objects (after the TIA migration empty GraphicViews without a foreground color) into WinCC Unified dynamic SVG widgets.
tia_hmi_unified_fit_textswriteTexts that do not fit after a Comfort→Unified migration and end with "…" (buttons, text fields, labels): measures the text in the runtime language (runtime_language, e.g.
tia_hmi_unified_fix_alarm_textswriteFixes double-escaped characters in WinCC Unified alarm texts after a migration (runtime shows "-->" instead of "-->"): '&gt;' → '>', also &lt; &amp; &quot; &#NNN; – discrete and analog alarms, all languages,…
HMI – Comfort and migration
Complete export and import of Comfort panels (screens, lists, connections, cycles, VB scripts) for migration and versioning.
tia_hmi_comfort_exportreadExports one classic WinCC object as SimaticML: kind = screens | templates | popups | slideins (name = Top/Bottom/Left/Right) | tag_tables | text_lists | graphic_lists | connections | cycles | vbscripts | global_elements | overview |…
tia_hmi_comfort_importwriteImports one SimaticML object into classic WinCC (override): the kind is detected from the XML; an existing object is replaced in its folder, a new one goes to folder ('A/B', created).
tia_hmi_comfort_import_allwriteRe-imports an export from tia_hmi_comfort_export_all (manifest.json, otherwise by subfolders) in the right order: graphics → lists → cycles → tags → VB scripts → templates → global elements → screens → pop-ups → slide-ins → overview.
tia_hmi_comfort_objectsreadInventory of classic WinCC (Comfort/Advanced): screens, templates, pop-ups, slide-ins, tag tables, text and graphic lists, connections, cycles, VB scripts, global elements, screen overview, project graphics – names and folders.
tia_hmi_comfort_text_listwriteText list of classic WinCC (Comfort) – creates or replaces it via SimaticML: entries = {"0": "Stop", "1": "Run", "2-5": "Range"} or a list with value / from-to / default and texts per language; list_range = Decimal | Bit | Binary; culture…
tia_hmi_comfort_vbscriptwriteVB script of classic WinCC (Comfort/Advanced) – creates or replaces it via SimaticML: code, script_type = Sub | Function, precode, user folder.
HMI – simulation and screenshots
What the PC offers for runtime and simulation, preparing the HMI for simulation and a screenshot plan built from the navigation.
tia_hmi_runtime_preparereadPrepares an HMI for simulation/runtime: compiles the HMI device (Unified panel/PC and Comfort; ICompilable on the device), returns errors plus 'blockers' Openness cannot fix (empty password in Runtime settings of a new Unified device in…
tia_hmi_runtime_statusreadWhat this PC offers for HMI runtime/simulation: WinCC Unified PC runtime (version, install type – e.g.
tia_hmi_unified_screenshot_planreadScreenshot plan for WinCC Unified built from the project: start screen (Runtime settings), navigation buttons (ChangeScreen in event scripts + button text in language lang) and screens shown in screen windows → click order through all…
HMI – automated test in simulation
A test plan from the WinCC Unified project and its run against the simulation and PLCSIM Advanced: navigation, buttons, I/O fields and alarms, a report with screenshots of failures.
tia_hmi_test_planreadPlan of an automatic WinCC Unified HMI test built from the project (read-only): nav = navigation buttons (after the click the texts of the target screen are visible), button = buttons whose event writes a constant to a PLC tag…
tia_hmi_test_runwriteAutomatic WinCC Unified HMI test against a SIMULATION: a browser (Playwright) drives the Unified runtime web client on this PC (url, default https://localhost/WebRH; login user + password_file / password_env) and checks and sets values in…
HMI runtime & screenshots
Starting and stopping the WinCC Unified simulation with confirmation, and screenshots of the screens for the manual straight from the running simulation.
tia_hmi_runtime_controlwriteStarts / stops / reports the state of a WinCC Unified PC runtime SIMULATION via the SIMATIC Runtime Manager CLI (no window): action = state (read-only) | start | stop.
tia_manual_screenshotsreadHMI screen screenshots for the operating manual (data.json from tia_manual_collect) – also afterwards, when the simulation is started only after data collection.
Commissioning – extended
Transactions with rollback on error, download to a folder or card, .psc files, DB value snapshots, online connection and R/H status.
tia_db_load_valueswriteWrites ACTUAL values of data blocks into the running PLC (TIA V21 ValueService): source = snapshot (snapshot from the project) | start_values.
tia_db_snapshotwriteSnapshot of the ACTUAL values of data blocks (TIA V21 ValueService): create=True connects to the PLC, stores the actual values as a snapshot in the project and returns them (the members' 'Snapshot' attribute; out_dir also saves a JSON).
tia_download_to_folderreadDownloads the PLC (HW + SW) into a FOLDER instead of a device – image for a SIMATIC Memory Card (S7_JOB.S7S, SIMATIC.S7S).
tia_export_pscreadExports the PC station configuration to a .psc file for the SIMATIC card reader (PC systems: Software Controller, Open Controller, IPC with applications).
tia_online_connectreadOnline connection to a CPU answering the login dialogs: address = CPU IP address (TIA V21 GoOnline(ConfigurationAddress)), access-level password / user login only via password_file / password_env, the PLC TLS certificate is reported…
tia_rh_statusreadState of an S7-1500R/H redundant system (RHOnlineProvider): primary and backup CPU state and PC interfaces; probe=True briefly connects to both CPUs (optionally to given IPs) and disconnects.
tia_transaction_runwriteAtomic batch: runs steps [{tool, args}] inside ONE TIA transaction (TIA V16+, ExclusiveAccess + Transaction).
Drives – commissioning
Startdrive: motor data and motor codes, function modules, security, the safety acceptance test report, online actions and DCC charts.
tia_drive_commissioning_inforeadWhat Startdrive offers on a drive via Openness (DFI): third-party motor/encoder configuration incl.
tia_drive_dccreadDCC (Drive Control Chart) of a drive: charts, DCB libraries and block types, chart content (blocks, pins, values) and export to a file.
tia_drive_dcc_editwriteEdit DCC: create a chart, add a DCB block, connect pins, set a pin value, import a chart exported by tia_drive_dcc, delete a chart.
tia_drive_functionswriteDrive object functions: activate/deactivate function modules (basic positioner EPOS, technology controller PID) and Safety axis type on 3rd-generation drives, drive object activation (S120), drive object type, Safety checksum update and…
tia_drive_motorwriteOffline motor setup of a SINAMICS drive: motor type, rated data (p304–p311 – the only Openness path to these parameters), Siemens motor code, SIMOGEAR MLFB and third-party encoder; returns before/after values with read-back verification.
tia_drive_onlinereadOnline drive (Startdrive online): status and parameters read directly from the drive; an offline drive returns NotOnline.
tia_drive_online_actionwriteOnline actions on a drive: copy RAM to ROM for all drive objects, or factory reset (only with confirm=True on explicit user request).
tia_drive_safety_acceptancewriteSafety Integrated acceptance test of a drive (TIA V21): select/deselect test functions (STO, SS1, SLS…), reset the selection and write the test protocol to a file.
tia_drive_securitywriteSecurity of 3rd-generation SINAMICS drives (S200, S210 6SL5, G220): switch user management (UMAC) and drive data encryption (DDE, needs a password that is never stored or logged).
Motion
Cams, interpreter programs and their mappings, connecting technology objects to hardware.
tia_cam_exportreadExports a TO_Cam (S7-1500T) as MCD segment table (with points), Scout, point list or binary file.
tia_cam_importwriteImports cam data into a TO_Cam from points [[x, y], …] or a file (x/y point table, MCD, Scout, binary); verified by re-export.
tia_interpreter_exportreadSource text of an interpreter program (TO_InterpreterProgram, S7-1500T), optionally saved to a file.
tia_interpreter_importwriteLoads an interpreter program (TO_InterpreterProgram) from text or a file and verifies it by re-export.
tia_interpreter_mappingswriteInterpreter mappings (TO_InterpreterMapping, TIA V21): alias → technology object, alias → DB member; add, remove and list.
tia_motion_objectsreadPLC technology objects including measuring inputs, output cams and cam tracks below axes: type, version, axis and available Openness services (cam data, HW connection, interpreter, couplings).
tia_to_hw_connectwriteHardware connection of a measuring input, an output cam / cam track or a TO_Ident: output PLC tag (cam on a standard DQ), bit address (%I0.3 / %Q1.2) or module and channel only on suitable hardware (TM Timer DIDQ …; plain DI/DQ are…
Safety – administration
The official collective F-signature from TIA V21, the F-program password and the F-I/O status block.
tia_safety_adminwriteSafety Administration of an F-CPU (write).
Libraries – maintenance
Version comparison, a check for outdated instances, harmonization, clean-up, master copies and archiving of the global library.
tia_global_library_managewriteUser global library as a file: create, save, save_as (copy into folder target_dir – the library takes the folder name and the open library switches to the copy), archive (compressed / none / discard restorable data), close (with unsaved…
tia_library_comparereadLibrary comparison (TIA V21, CompareToLibrary): library (None = project library, otherwise an open global library) against target_library ('project' / global library name).
tia_library_create_master_copywriteCreates a master copy from a project object (MasterCopyComposition.Create): block, data_type, tag_table, watch_table, device, hmi_screen, hmi_tag_table (Comfort).
tia_library_maintainwriteLibrary maintenance (project or open global library; selection type_names / folders, none = whole library).
tia_library_update_checkreadUpdate check (UpdateCheck): which type instances in the project are not on the current version of the library (None = project library, otherwise an open global library).
PLC – checksums and extras
Checksums, a software comparison of two PLCs, linked tags, the process image, write protection, instance DBs and alarm texts.
tia_block_write_protectionwriteWrite protection of a block (TIA V21 PlcBlockWriteProtectionProvider; the block can still be read but not changed).
tia_compare_plc_softwarereadOffline comparison of a PLC program with another PLC (PlcSoftware.CompareTo, like TIA Compare offline/offline): blocks, UDTs, tags… only left / only right / different.
tia_create_instance_dbwriteCreates an instance DB for an FB (PlcBlockComposition.CreateInstanceDB).
tia_linked_tagsreadWhich PLC tags sit on the I/O channels of the modules (TIA V21 PlcTagProvider.GetLinkedTags): channel → tags (name, address, table).
tia_plc_alarm_textlistsreadPLC alarm text lists (user and system: name, ID, range, comment).
tia_plc_checksumsreadOffline PLC checksums (PlcChecksumProvider: Software and TextLists – the CPU shows the same values online; equal = this program is in the PLC) and block metrics (TIA V21: load/work memory size, download, compile and code change date).
tia_process_imagewriteProcess image of a module (TIA V21): without parameters only reads the addresses and their partition.
tia_prodiag_block_inforeadExports the ProDiag information of a compiled ProDiag FB to a folder (CodeBlock.ExportProDIAGInfo – basis for HMI/documentation of supervisions).
tia_project_text_categoriesreadCategories of project texts (TIA V21 Project.TextCategories: block comment, alarm text…) for the filtered export tia_export_project_texts(categories=…, devices=…).
tia_virtual_plc_compilewriteProject setting 'support virtual PLC during block compilation' (TIA V21 VirtualPlcSettingsProvider).
Project – identity and settings
Object IDs, project history and archiving, TIA Portal information, diagnostic settings, the PLC web server and display logo, telecontrol.
tia_custom_identitywriteCustom key–value pair stored in the project on a device or module (CustomIdentityProvider) – e.g.
tia_diag_settings_exportreadExports the project's diagnostics settings to .dat: 'prodiag' (ProDiag supervision settings) and 'sysdiag' (system diagnostics – classes and texts of messages).
tia_diag_settings_importwriteImports diagnostics settings into the project: kind = 'prodiag' | 'sysdiag', path = .dat from tia_diag_settings_export.
tia_module_inforeadHW catalog (ModuleInformationProvider): all versions of an article number ('OrderNumber:6ES7 521-1BH00-0AB0'), and with a version ('…/V2.2') also the racks / devices the module fits into (e.g.
tia_object_idreadStable ID of a project object (ObjectIdentifierProvider) – survives renaming and moving; useful for links from external tools (EPLAN, tickets, Git).
tia_plc_display_logowriteCustom logo on the display of an S7-1500 CPU (FrontPanelDisplay): without parameters only reads the settings.
tia_plc_webserverwriteCPU web server: without parameters only reads (Webserver* attributes, web server access to watch/force tables, V21 web applications and system pages).
tia_portal_inforeadThe TIA Portal installation the server is connected to: products and optional packages with versions (Startdrive, Safety, Test Suite…), attached Openness sessions, Multiuser servers and TIA settings (read-only).
tia_project_archivereadArchives the project (.zap21…) into a folder – backup before bigger changes or for hand-over.
tia_project_historyreadProject history (creation, migration, upgrade, mass imports… with time), products used by the project and which of them are missing on this PC (compared with the installed TIA).
tia_telecontrol_datapointsreadTeleControl data points of a CP in the station (CP 1243-1 TeleControl Basic…, TelecontrolManagement): TeleControl communication state, protocol, data points (name, type, index, cycle).
tia_telecontrol_importwriteTeleControl CP data points: csv_path = import CSV (format of the tia_telecontrol_datapoints export), tags = new data points from PLC tags (names), activate = switch on TeleControl communication of the CP, replace=True deletes the existing…
Offline help
Search in the bundled TIA-MCP documentation without internet – for local models and offline operation.
tia_docs_searchreadSearches the bundled TIA-MCP documentation (README, docs/*.md) – works without internet and without TIA.
Long-running background jobs
Importing dozens of sources, compiling large PLCs and HMIs and saving in a separate process that survives a server restart; job status and cancellation.
tia_worker_runwriteLong-running operation in a separate process (worker) – survives an MCP server restart and the server does not hang meanwhile: tools calling Openness immediately return TiaBusy with the job id, tia_job_status / tia_job_cancel /…
Core, safeguards and project
TIA connection, status, snapshots and restore, plans with approval, write mode, search, diagnostics.
close_projectwriteClose the project. With unsaved changes it refuses unless save=True or discard_changes=True (only on explicit user request).
connect_to_tiareadConnects to a running TIA Portal instance: by PID, or by (part of) the project name (project_name, case-insensitive); with neither, connects to the first one found.
create_projectwriteCreates a new empty project in the connected TIA Portal instance (Projects.Create) and leaves it open.
get_project_inforeadInformation about the open project.
get_running_tia_instancesreadList of running TIA Portal instances (PID, mode, project).
open_projectreadOpens a project (.ap20 etc.) in the connected instance.
save_projectwriteSave the project (persists all changes – save only after the user agrees).
tia_activate_licensereadActivates a TIA-MCP license: license key BA-LIC-… (offline) or order code BA-ORD-… (online via the Benešl Automation license portal – issues a license for this PC's Hardware ID).
tia_build_indexreadBuilds/updates the project's full-text index (blocks: SCL/pseudologic/interface, PLC tags, UDT, Unified screens).
tia_call_toolreadCalls any TIA-MCP tool by name, also one hidden by the active profile, with the same safeguards (write lock, snapshots, read-only mode).
tia_check_namesreadChecks variable names against the naming convention.
tia_doctorreadEnvironment diagnostics without touching the project: Python and pythonnet, TIA and Openness installation, the “Siemens TIA Openness” group, privilege level, running TIA and connection, licence, write mode, disk space, writable logs and…
tia_find_toolsreadSearches all TIA-MCP tools (also those hidden by the active profile) by keywords; hidden ones are called via tia_call_tool.
tia_get_conventionsreadReturns the project conventions (naming, languages, libraries, write safety) from docs/CONVENTIONS.md.
tia_get_license_inforeadReturns Benešl Automation license information, Hardware ID (HWID), activation status and remaining trial quota.
tia_get_statusreadServer status: connection to TIA, open project, Openness version, write mode, number of snapshots, license.
tia_job_cancelreadRequests cancellation of a running job (it will finish the current step).
tia_job_statusreadStatus of a background job (without job_id, a list of all).
tia_list_snapshotsreadList of automatic snapshots (backups taken before a write), newest first.
tia_list_toolsetsreadActive tool profile and hidden tools. Profiles (full|plc|hmi|hmi_config|docs|readonly|sim|commissioning|security|migration|drives|local|local_write|copilot) are set in .env (TIA_MCP_PROFILE / TIA_MCP_TOOLSETS, "+tia_xxx" adds and…
tia_plan_approvereadApproves the plan. Call ONLY after the user has explicitly approved the plan in the chat.
tia_plan_createreadCreates a plan for a multi-step change. steps = [{"tool": "<MCP tool name>", "args": {...}, "note": "..."}].
tia_plan_discardreadDiscards the plan.
tia_plan_executereadExecutes an approved plan step by step (every write step goes through a snapshot and an audit).
tia_plan_listreadList of plans (optional filter: draft|approved|running|done|failed|discarded).
tia_plan_showreadReadable overview of the plan – show it to the user for approval.
tia_project_overviewreadCompact summary of the open project: PLCs (block counts by type/language, F-CPU, inconsistent blocks, folders, tag tables, UDTs), HMIs (Unified/Comfort, screens), other device types.
tia_prune_snapshotswriteClean up old snapshots: deletes those older than max_age_days but keeps keep_min newest per project.
tia_read_snapshotreadReturns the XML content of a snapshot (the object's state before the write).
tia_restore_snapshotwriteRestores an object from a snapshot (undoes a write).
tia_searchreadFull-text search via the index (tia_build_index): FTS5 syntax ('ventil*', '"FB_AI" AND limit', 'name:FB_*'), falls back to LIKE on a syntax error.
tia_set_write_modereadSwitch write mode: 'read_only' (no tool may change the project) or 'write'.
tia_ui_dialogsreadDialogs open in TIA Portal that block Openness; can close informational ones (Export/Import Completed).
tia_where_usedreadWhere a symbol (tag, DB, block, #variable) is used – via the index (fast, offline).
Error reports to the vendor
Recorded unexpected errors and a report with a preview before sending – anonymised, without the project or PLC data.
tia_error_reportsreadUnexpected TIA-MCP errors recorded on this PC (logs/errors.jsonl, anonymised): when, tool, type, message, traceback and a summary per tool.
tia_openness_quarantinereadPlaces where TIA Portal crashed while reading via Openness (device, screen, object and step: properties, text, dynamizations, events).
tia_report_problemreadReport a problem or error in TIA-MCP to the vendor (Benešl Automation).
Licence and updates
Licence activation, checking and installing signed updates, rollback.
tia_license_deactivatewriteReleases the license of this PC on the license portal (moving to another computer) and removes it here.
tia_update_checkreadChecks for a new TIA-MCP version (vendor-signed manifest; at most once a day, force=True now): current/latest version, changelog, whether license maintenance covers it.
tia_update_installwriteDownloads and installs the new TIA-MCP version (vendor signature check, backup, license/settings preserved).
tia_update_rollbackwriteRestores TIA-MCP to the version before the last update (from the backup in backups/).
Tool names are technical identifiers seen by the AI agent. Clients with a tool limit (e.g. Copilot in VS Code – 128) use profiles: plc, hmi, docs, commissioning, readonly or sim.