Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: 10.1.5.1 wire-level extension: clarify category semantics — "Alarm Tools" gates only the dedicated alarm-query tools; reads of Alarm.* runtime-object values and alarm-state-of-tag overlays stay under UNS.

...

  • 10 tools total (9 platform tools + solution-authored custom tools), down from the 11-tool target considered mid-cycle and up from the 7 documented in v1.1 (Feb 2026).
  • Session bootstrap merged: runtime_get_info and runtime_set_target collapse into a single runtime_connect(solution?, profile?).
  • Semantic rename: runtime_browse_unsruntime_browse_object_model (the tool walks all 12 runtime roots, not just the P1-strict UNS).
  • Verb-shift rename: runtime_get_object_contextruntime_describe_object — and it absorbs the former runtime_find_by_iri via a new iri parameter.
  • runtime_list_by_typeruntime_list_instances, now bounded with max_results + name_mask wildcard filter.
  • All list / browse / history / alarm tools gain server-side max_* caps with a truncated flag on the response.
  • runtime_list_derived_types dropped — redundant with runtime_describe_object's derivedTypes context block.
  • Gate-bit category names in Solution Settings shift from historical Enable Get* labels to scope-accurate Enable *Tools labels, and the wire-level gating was extended so every tool inside a category honors its category toggle (no partial coverage).

Gate-Bit Categories (Solution Settings)

...

Checkbox label

Category

Covers

Bit

Enable MCP for Runtime

Master

Gates every RuntimeMCP tool. runtime_connect is gated only by this master so AI clients can bootstrap before any sub-category is enabled.

0x0002

Enable UNS Tools

UNS

runtime_get_value, runtime_browse_object_model, runtime_search_uns, runtime_describe_object, runtime_list_instances. All 5 tools honor this bit uniformly.

0x04

Enable Alarm Tools

Alarm

Dedicated alarm-query tools only: runtime_get_active_alarms, runtime_query_alarm_history.

0x08

Enable Historian Tools

Historian

runtime_get_tag_history.

0x10

Enable Custom Tools

Custom

Solution-authored [McpServerTool] methods on MCP Tool script classes.

0x20

Category semantics. Categories are defined by the TOOL being invoked, not by the runtime_connect itself is gated only by the master; it is always available when the master is on so AI clients can bootstrap before any category is enabled-object namespace the path happens to address:

  • Reading a value from the Alarm.* namespace (e.g., runtime_get_value("Alarm.TotalCount")) stays under Enable UNS Tools. Any runtime-object value read is UNS-category regardless of path.
  • The alarm-state-of-a-tag overlay inside runtime_describe_object (reports whether a specific tag is currently in alarm state) is describing the tag — UNS data — and gates on Enable UNS Tools, not Enable Alarm Tools.
  • Enable Alarm Tools governs only the dedicated alarm-query tools that hit the alarm subsystem's state machine and historian: runtime_get_active_alarms and runtime_query_alarm_history.

Available Tools

AI Runtime provides 9 built-in platform tools + solution-authored custom tools, organized by function.

...

Version

Date

Changes

1.2 (draft)

2026-04-24

Refreshed for 10.1.5.1. Tool catalog went to 9 platform tools + custom (was 7). Session bootstrap unified as runtime_connect. runtime_browse_unsruntime_browse_object_model. runtime_get_object_contextruntime_describe_object (absorbs runtime_find_by_iri). runtime_list_by_typeruntime_list_instances with wildcard filter. Gate-bit categories relabeled to Enable *Tools and wire-level gating extended so every tool in a category honors its toggle uniformly. Category semantics clarified: alarm-state-of-tag is UNS data; Enable Alarm Tools governs only the dedicated alarm-query tools. Operator Subset section added.

1.1

2026-02

7 built-in tools; updated architecture diagram; added runtime_ prefix best practices.

...