Release Notes

In addition to the items listed below, each release resolved minor issues and improved error messages.

Hint: The 'tools' in these release notes refer to the MCP tools (features) provided by the MCP Server for Enterprise Architect, not the MCP client tool such as Claude App or VSCode.

Currently, the MCP server add-in is incompatible with version 17.2 of Enterprise Architect due to compatibility issues. Almost all features work correcty, but some features return an error 'This operation cannot be executed on the version 17.2.'.

Version 3.0.2 (8 September, 2026)

  • Updated: The layout_connectors tool has moved from automatic to manual routing, enabling the AI to define the path for each connector
  • Fix: Resolved an issue where connector directions were occasionally not applied correctly
  • Fix: Resolved an issue where connector directions were occasionally changed unexpectedly when the direction was not specified

Version 3.0.1 (4 September, 2026)

  • Updated: Supports initial value and multiplicity for attributes
  • Fix: Resolved an issue where clone_elements and create_or_update_connectors were quitting when some parameters were invalid

Installer: x64 : x86

Version 3.0.0 (2 September, 2026)

  • Changed: Now requires .NET Desktop Runtime 10.0 because Runtime 9.0 support by Microsoft will be discontinued in October 2026
  • Changed: Update the internal MCP library to the latest version - supported new MCP specifications
  • Changed: The result for update and delete tools will return only basic information (name, type and ID) to avoid misunderstaings by LLMs
  • Changed: Now returns the detail error messages for the update tools, and continues the update process when one of the target fails to update
  • Changed: When classifierID is specified for the create_element tool, the classifier name parameter is ignored and the actual classifier name is retrieved
  • Updated: Supports to create and update multiple packages or diagrams in a single call
  • Updated: Supports to set/unset the child diagram for elements
  • Fix: Resolved an issue where the MCP server returns an error related to the SQL 'POS' alias in certain queries
  • Fix: Resolved issues where types of Ports, Parts and ActivityParameters were not applied correctly
  • Fix: Fixed some typos in the tool descriptions and the UML/SysML/BPMN prompts

Installer: x64 : x86

The MCP version 2.8.11 and older versions require .NET 9.0 runtime to be installed on the machine where the MCP server add-in is running. The .NET 9.0 runtime can be downloaded from the official Microsoft website.

Version 2.8.11 (13 August, 2026)

  • Changed: Added the End User License Agreement (EULA) to the installation process
  • Changed: Allowed the layout_connectors tool for Activity diagrams (experimental)
  • Updated: Now order of attributes and operations are updated when inserting or moving new attributes and operations
  • Fix: Resolved an issue where creation of sequence messages was not working correctly in some cases
  • Fix: Resolved an issue where meaningless creation date and modification date for diagrams were returned in some cases

Installer: x64 : x86

Version 2.8.10 (7 August, 2026)

  • Changed: Updated to reorder Sequence messages after adding/deleting messages to ensure correct ordering
  • Fix: Resolved an issue where Fork/Join and Merge could not be created correctly
  • Fix: Resolved an issue where the color of a connector was reset when specifying only width
  • Fix: Supported the case where the creation date of a Package is empty on MySQL repositories
  • Fix: Resolved an issue where styles (color and width) for Sequence messages were not applied correctly
  • Fix: Resolved an issue where deleting a Sequence message and the add a new Message would cause the deleted message to appear again

Version 2.8.9 (31 July, 2026)

  • Update: Added information about the SysML Value properties to the prompts
  • Change: Returned the same elements' type name as the prompts for better AI understanding
  • Change: Returned an error for tools not supported in version 17.2
  • Fix: The parameter order property was duplicated by deleting and then adding new parameters
  • Fix: Resolved an issue where some properties of attributes and operations were reset when they were not set
  • Fix: Resolved an issue where the connector routeStyle was not applied
  • Fix: Resolved an issue where a width value of 1 was ignored
  • Fix: Resolved an issue where some properties (such as isReference for Parts) were not applied correctly

Version 2.8.8 (23 July, 2026)

  • Update: Added support to add the end (bottom) for new attributes and operations
  • Change: Removed the order for new sequence messages to avoid confusion - the order might not be actual value
  • Fix: Resolved an issue where operation parameters were not visible after adding them, before reloading a diagram
  • Fix: Resolved an issue where new operation parameters' order were always 0 (or other incorrect values)
  • Fix: Resolved an issue not to apply type for ActionPins and ActivityParameters

Version 2.8.7 (21 July, 2026)

  • Update: Reduced the size of the JSON data returned from the MCP server to optimize communication with LLMs and improve processing speed
  • Change: Support 'SysML1.5::' prefix for SysML stereotypes in prompts to improve compatibility with certain LLMs (automatically convert into 'SysML1.4::')
  • Change: Better handling of messages' name where the messages are bound to an operation
  • Fix: Sequence messages were not ordered correctly in some cases
  • Fix: Primitive types for ActionPins and ActivityPartitions were not shown correctly
  • Fix: Resolved an issue where element's type was UML base name for profiled elements

Version 2.8.6 (17 July, 2026)

  • Update: Added support for primitive types, such as Boolean and Integer, for Ports, Parts, etc.
  • Update: Added support for multiplicity of elements
  • Change: Added support for updating Custom properties for elements, aligned with tagged values
  • Change: Modified the method for resetting colours to default to prevent misunderstandings by certain LLMs
  • Change: Added additional element type names to the UML and SysML prompts
  • Change: Allowed position and size to be omitted in place_elements_on_diagram to retain current values
  • Fix: Resolved an issue where a new element could not be created without a name
  • Fix: Resolved an issue where UseCase Include and Extend relationships were not created correctly
  • Fix: Resolved an issue where ActivityPartition could not be set to horizontal

Version 2.8.5 (13 July, 2026)

  • Change: Added recommended element sizes on diagrams to the UML and SysML prompts
  • Change: Added support for creating new CallBehaviorAction and CallOperationAction elements without related elements
  • Fix: Resolved an issue where a diagram was not visible in the Browser after being created under an element
  • Fix: Resolved an issue where the border colour of elements on the current diagram always returned empty
  • Fix: Resolved an issue where sequence diagram message information did not contain the connectorID value, which is used to delete messages
  • Fix: Fixed a typo in the delete_taggedvalue_from_model tool

Version 2.8.4 (8 July, 2026)

  • Change: Added support for Sequence diagrams which are extended by MDG profile
  • Fix: Resolved an issue which stereotypes information of elements and connectors are not included in the output
  • Fix: Resolved an issue which caused SysML1.5 stereotypes (internally SysML 1.4:: stereotypes) to be handled incorrectly

Version 2.8.3 (7 July, 2026)

  • New feature: Added feature to log the create/update/delete operations (need to enable by the arguments)
  • New feature: Added deletion of tagged values for packages, attributes and operations
  • Change: Added automatic Z-order management for elements after using the place_elements_on_diagram tool
  • Fix: Resolved an issue where sequence messages were included in the diagram connectors information

Version 2.8.2 (3 July, 2026)

  • New feature: Added support for tagged values in operations and attributes
  • Change: Added information about subjects in Use Case diagrams to the prompts
  • Change: Added support for updating and deleting stereotypes for elements, connectors, attributes, and operations
  • Change: Modified the connection management between MCP Server and Enterprise Architect to improve stability
  • Fix: Resolved an issue where newly created sequence messages were rendered improperly in some cases

Version 2.8.1 (1 July, 2026)

  • Fix: Resolved an issue where the apply_baseline tool did not work correctly with certain LLMs
  • Fix: Resolved errors occurring with specific tools in certain environments
  • Fix: Excluded the SysML frame from the get_diagram_information tool

Version 2.8.0 (30 June, 2026)

  • New feature: Added support for deleting elements, diagrams, and other items (Requires adding -enableDelete to the arguments when launching MCP3.exe)
  • Change: Added entry/do/exit action information for States to prompts
  • Change: Simplified tool parameter descriptions to reduce context window usage
  • Fix: Corrected connector information retrieval for diagrams when no data is present in the t_diagramlinks table.
  • Fix: Resolved an issue where the direction was ignored during connector updates or creation
  • Fix: Corrected diagram information retrieval for Text, Navigation cells, and Hyperlinks
  • Fix: Resolved an exception raised when calling the get_packages_information tool with older project files

Version 2.7.3 (19 June, 2026)

  • New feature: Added support for RefGUID and RefGUIDList types in Tagged Values, enabling the reading and writing of objects stored as GUIDs
  • Change: Improved newline handling in Notes and Tagged Values for certain LLMs
  • Change: Improved connector layout results for the layout_connectors tool

Installer: x64 : x86

Version 2.7.2

(Internal build for a specific customer - not publicly released)

Version 2.7.1 (2 June, 2026)

  • Fix: Resolved an issue where scenario information contained raw GUID strings
  • Fix: Optimized the information returned for CallBehaviorAction and CallOperationAction
  • Fix: Resolved an issue where classifier information was set incorrectly in some cases
  • Change: Updated get_current_package behavior to ensure the correct package is returned

Version 2.7.0 (1 June, 2026)

  • New feature: Added support for customizing element and connector colors
  • New feature: Added the ability to specify the type element ID for Operation return values, Attribute types, and Parameter types
  • Change: Reduced the JSON data size returned from the MCP server to optimize communication with LLMs and improve processing speed
  • Fix: Corrected parameter addition when creating an Operation with parameters
  • Fix: Ensured linked diagram information is returned for Hyperlinks and Navigation cells
  • Fix: Improved newline character handling when saving to Notes or Tagged Values

Version 2.6.3 (20 May, 2026)

  • New feature: Added a tool to change connector visibility in diagrams
  • Change: Updated returned message information to include the operationID if the message is bound to an operation

Installer: x64 : x86

Version 2.6.2 (19 May, 2026)

  • New feature: Added support for CallOperationAction
  • Fix: Resolved an issue where Sequence messages were not updated after applying an operation ID
  • Change: Improved element type reporting (e.g., returning "CallBehaviorAction" instead of "Action" with a CallBehavior kind) for better clarity

Version 2.6.1 (15 May, 2026)

  • Fix: Resolved DAO errors caused by certain tools when using EAP/EAPX files

Version 2.6.0 (13 May, 2026)

  • New feature: Added a tool to delete connectors or messages
  • Fix: Resolved an issue where SysML Requirement text values were occasionally not saved correctly

Version 2.5.4 (21 April, 2026)

  • New feature: Added an advanced debug log mode (for diagnostic purposes only; not publicly documented)
  • Fix: Renamed certain tools to ensure naming consistency
  • Fix: Resolved an issue where arguments for MCP3.exe were not recognized correctly in some cases

Installer: x64 : x86

Version 2.5.3 (15 April, 2026)

  • Change: Enabled reading and writing of order information for attributes and operations

Version 2.5.2 (14 April, 2026)

  • New feature: Added tools to create and apply baselines for backing up and restoring model changes
  • Change: Updated the reload_diagram tool to support multiple diagrams simultaneously

Version 2.5.1 (1 April, 2026)

  • Fix: Resolved an issue where certain tools returned an error when the related element lacked a use case scenario

Version 2.5.0 (31 March, 2026)

  • New feature: Added support for structured use case scenarios (currently read-only)
  • Change: Updated the internal MCP library to the latest version

Version 2.4.6 (27 March, 2026)

  • Fix: Resolved an issue where the layout_connectors tool returned an error for certain diagrams
  • Fix: Corrected newline character handling for specific LLMs
  • Fix: Improved handling of backslash characters in linked document paths

Version 2.4.5

(Internal build for a specific customer - not publicly released)

Version 2.4.4 (10 March, 2026)

  • New feature: Updated the place_elements_on_diagram tool to support updating existing elements
  • Change: Renamed several tools to improve consistency

Version 2.4.3 (9 March, 2026)

  • New feature: Added support for modifying the timeout duration
  • Change: Updated the internal MCP library to the latest version

Version 2.4.2 (6 March, 2026)

  • Fix: Resolved an issue where SysML Requirements were not created correctly
  • Change: Added support for handling unexpected JSON formats sent by certain LLMs, such as escaped Unicode characters
  • Change: Refined the SysML prompt to improve clarity and understanding for LLMs
  • Change: Updated the internal MCP library to the latest version

Version 2.4.1 (5 February, 2026)

  • Change: Updated the internal MCP library to the latest version

Version 2.4.0 (30 January, 2026)

  • New feature: Added support for sequence diagram generation
  • New feature: Added the layout_connectors tool
  • Change: Included the creation and last-modified dates in the data returned for elements, diagrams, and packages
  • Fix: Resolved an issue where stereotypes defined in profiles were not applied when creating new connectors

Version 2.3.12 (23 January, 2026)

  • Change: Added support for creating a CallBehaviorAction by applying an Activity as a Classifier to an Action
  • Change: Added support for connector styles.
  • Change: Added support for ActivityPartition directions

Version 2.3.11 (19 January, 2026)

  • Change: Added 'linked document' information to the get_element_information tool
  • Change: Added support for updating stereotypes of existing elements and connectors
  • Fix: Resolved an issue where initially specified stereotypes for new connectors were not applied correctly

Version 2.3.10 (16 January, 2026)

  • New feature: Added MCP Prompts for ArchiMate 3.1. (Currently supports limited elements and connector types; more will be added on request)
  • Change: Updated the internal MCP library to the latest version
  • Change: Updated connector styles for BPMN SequenceFlow and MessageFlow
  • Change: Updated the prompt for BPMN diagrams
  • Fix: Resolved an issue where the x86 installer attempted to use the x64 .NET runtime in certain environments

Version 2.3.9 (13 January, 2026)

  • Change: Updated the prompt for BPMN diagrams
  • New feature: Enabled reuse of existing elements when creating new elements with the same name for specific types to support traceability

Version 2.3.8 (8 January, 2026)

  • Change: Improved newline character handling in Notes by replacing '\r\n', '\r', and '\n' with standard newlines

Version 2.3.7 (7 January, 2026)

  • New feature: Added tools to import and export linked documents to or from a specified path as RTF files

Version 2.3.6 (5 January, 2026)

  • Change: Updated the prompt for BPMN diagrams
  • Change: Renamed the reset_diagram tool to reset_diagram_layout
  • Change: Updated the Y-coordinate to a positive value when placing elements on a diagram
  • Fix: Ensured newly created diagrams under elements are displayed correctly in the Model Browser

Version 2.3.5 (26 December, 2025)

  • Change: Updated internal SQL queries containing reserved words for certain DBMSs to prevent execution errors

Version 2.3.4 (19 December, 2025)

  • Change: Added element position support to the place_element_on_diagram tool
  • Change: Renamed the layout_diagram tool to reset_diagram to prevent LLMs from disrupting layouts applied by the place_element_on_diagram tool
  • Change: Updated the get_current_diagram tool to return detailed information equivalent to the get_diagram_information tool
  • Fix: Resolved an error returned by the get_diagram_information tool

Version 2.3.3.1 (12 December, 2025)

  • Change: Updated the installer to use the latest Microsoft checking tool for the .NET runtime library (No changes were made to the MCP add-in itself)

Version 2.3.3 (10 December, 2025)

  • Change: Allowed almost all properties to accept 'null' values to prevent certain LLMs from overwriting existing data with empty strings for unchanged properties

Version 2.3.2 (5 December, 2025)

  • Change: Added support for multiple creation and modification actions in certain tools
  • Fix: Reverted the MCP library update due to compatibility issues with the MCP add-in in certain environments

Version 2.3.1 (3 December, 2025)

  • New feature: Added the prompt for BPMN 2.0 diagrams
  • Change: Added support for specifying multiple IDs in certain tools to enable fetching data for multiple elements in a single call
  • Change: Updated the generated JSON format for Tagged Values to reduce text size

Version 2.3.0 (19 November, 2025)

  • New feature: Expanded supported properties and tagged values for packages, elements, diagrams, and connectors (e.g., creating or moving diagrams under elements)
  • New feature: Added cloning capabilities for packages and elements

Version 2.2.0 (12 November, 2025)

  • New feature: Added tools to create and modify operations and attributes

Version 2.1.0 (7 November, 2025)

  • New feature: Added tools to retrieve and modify connectors
  • New feature: Configured the create_element tool to reference elements within the Template Package when enabled
  • Change: Updated to the latest MCP library
  • Fix: Resolved an error returned by the get_element_information tool for specific element types
  • Fix: Resolved minor errors in the SysML prompt

Version 2.0.3 (4 November, 2025)

  • Change: Added a workaround for an issue where BPMN 2.0 events could not be created
  • Change: Added a workaround for an issue where tagged values defined by profiles could not be updated
  • Change: Updated the prompt for SysML diagrams

Version 2.0.2 (16 October, 2025)

  • Change: Added detailed logging information to the MCP add-in log file
  • Fix: Resolved an issue where multiple tools failed to function on PostgreSQL-based repositories

Version 2.0.1 (29 September, 2025)

  • Fix: Resolved an error in the get_diagram_information tool related to MCP_EA.Message or MCP_EA.Fragment in certain environments
  • Fix: Resolved an issue where the get_element_information tool failed to display messages in sequence diagrams

Version 2.0.0 (10 September, 2025 - Initial official worldwide release)

  • New feature: Added support for all types of elements, connectors, and diagrams
  • New feature: Added MCP Prompts for UML and SysML to facilitate model generation with correct type names