Liveness probe. Calls the SysML v1 bridge plugin and returns its build metadata.

Return the current safety tier (READ, WRITE, or DANGEROUS) plus dev mode status.

Return the current licence status: tier, customer, expiry, validity.

Save the current Cameo project. Pass an optional comment for audit log.

Return recent edit history (undo stack) from the open project.

Undo the last model edit.

Redo the last undone model edit.

Retrieve a single SysML v1 element by its local ID. Returns type, name, and owner ID.

Find all elements whose name contains the given string. Returns list of matches.

Find all elements matching a SysML v1 type name (e.g. Block, Requirement, FlowPort).

Find an element by its fully-qualified name (e.g. 'Model::Package::Block').

Return the fully-qualified name of an element.

Return the root model package of the open project.

List direct children of an element. Returns list with id, name, type.

Walk the containment tree from root_id. Returns nested tree structure.

Full-text search across element names.

Return rich description of an element including stereotypes and tagged values.

Return the structural hierarchy under an element (parts, ports, properties).

Return all relationships involving an element.

Return all ports owned by an element.

List all Allocate relationships from and to an element.

List all stereotypes applied to an element.

Search the model for SysML Unit-stereotyped elements by name substring.

Search the model for SysML QuantityKind-stereotyped elements by name substring.

Create a SysML v1 element of the given type under parent_id. Valid types: Block, Package, Requirement, ConstraintBlock, ValueType, InterfaceBlock, FlowPort, ProxyPort, FullPort, PartProperty, ValueProperty, ReferenceProperty, UseCase, Activity, StateMachine, State, Action, Actor, Signal, Class, DataType, Enumeration, Interface.

Set or rename the root model element. Returns the root model id and name.

Create an Enumeration with the given literal names under parent_id.

Create a UML Connector between two ConnectableElements (ports, properties).

Create an ItemFlow on an existing Connector. The item_element_id must be a Classifier.

Create a BindingConnector (SysML equal-value constraint) between two properties/ports.

Create an Allocate relationship from source to target (SysML Allocation).

Create a UML Generalization from a specific to a general classifier.

Create a SysML diagram. kind: BDD, IBD, Parametric, Requirement, Activity, StateMachine, UseCase, Package, Sequence.

Create a UML Package under parent_id.

Create a UML Transition between two Vertex elements (States/Pseudostates) in a StateMachine.

Create a UML StateMachine (with a default Region) owned by parent_id.

Create a State inside a Region. Set is_initial='true' for an initial Pseudostate, is_final='true' for a FinalState.

Create an additional Region inside a StateMachine or composite State (for concurrent/orthogonal regions).

Set an entry, do, or exit action body on a State. action_kind must be 'entry', 'do', or 'exit'.

Add a named Trigger to a Transition.

Set an OpaqueExpression guard constraint on a Transition.

Set an OpaqueBehavior effect on a Transition.

Create a UML Activity owned by parent_id.

Create an Action inside an Activity. action_type: OpaqueAction (default), CallBehaviorAction, SendSignalAction.

Create a ControlFlow edge between two ActivityNodes within an Activity.

Create an ObjectFlow edge between two ActivityNodes within an Activity.

Create a SysML Requirement element under parent_id.

Create a SysML ProxyPort on a Block.

Create a SysML FullPort on a Block.

Create a SysML FlowPort on a Block.

Create a SysML Refine dependency from source to target.

Create a SysML Copy dependency from source to target.

Create a UML Trace dependency from source to target (StandardProfile).

List available auto-layout styles for a diagram.

Compare how each auto-layout style would affect a diagram.

Create a UML Association between two classifiers.

Create a SysML Association Block (AssociationClass + Block stereotype).

Create a SysML FlowSpecification (Interface + FlowSpecification stereotype).

Create a SysML FlowProperty. direction: in | out | inout.

Create a ConstraintProperty typed by a ConstraintBlock.

Set the isEncapsulated tagged value on a Block. value: 'true' or 'false'.

Set the conveyed Classifier on a SysML ItemFlow.

Create a UML Interaction (container for sequence diagram content).

Create a Lifeline inside a UML Interaction.

Create a Message between two Lifelines in an Interaction. Creates send/receive occurrence specs automatically.

Create a CombinedFragment in an Interaction. operator: alt | opt | loop | break | par | seq | strict | neg.

Return the available standard library DataTypes from the open project.

Rename a SysML v1 element.

Set the documentation (owned Comment body) of an element.

Permanently delete an element from the model.

Move an element to a new parent (re-owner).

Set the type of a TypedElement (Property, Parameter, Port, etc.).

Set multiplicity bounds on a MultiplicityElement (Property, etc.). Use -1 for upper=*.

Set the default value of a Property as a LiteralString.

Create a Constraint with an OpaqueExpression body on parent_id.

Set a tagged value (stereotype property) on an element via TagsHelper.

Apply a stereotype to an element by its qualified name.

Remove a stereotype from an element by its qualified name.

Set the SysML requirement ID tagged value on a Requirement element.

Set the normative requirement text on a Requirement element.

Set the unit of a SysML ValueType element.

Set the direction of a Parameter. Valid values: IN, OUT, INOUT, RETURN.

Set a Property's UML aggregation: composite (part), shared, or none (reference).

Create a Satisfy relationship from a satisfying element to a requirement.

Create a Verify relationship from a verifying element to a requirement.

Create a DeriveReqt relationship between two requirements.

Set source and target ConnectorEnd roles on a Connector.

Create a UML Dependency between a client and supplier element.

Create a SysML v1 Block under parent_id.

Create a PartProperty (typed composite part) under a Block.

Create a ValueProperty (scalar attribute) under a Block.

Create a ReferenceProperty under a Block.

Create a SysML InterfaceBlock under parent_id.

Create a SysML ValueType under parent_id.

Create a SysML ConstraintBlock under parent_id.

Create a UseCase element under parent_id.

Create an Actor element under parent_id.

List diagrams owned by a package or element.

Return supported diagram kinds for SysML v1.

Add an element symbol to a diagram. Phase B stub.

Remove an element symbol from a diagram. Phase B stub.

Add multiple element symbols to a diagram. Phase B stub.

Apply Cameo's automatic layout to a diagram.

List all symbols currently in a diagram. Phase B stub.

Export a diagram as a JPEG image (base64 encoded, max 1024px).

Returns MCP ImageContent containing the resized diagram image. The image is re-encoded as JPEG for compatibility with the Claude API.

Apply a named layout style to a diagram.

Move a symbol to specific coordinates. Phase B stub.

Resize a symbol in a diagram. Phase B stub.

Set visual style properties on a diagram symbol. Phase B stub.

Show or hide a compartment on a symbol. Phase B stub.

Add a relationship path to a diagram. Phase B stub.

Set routing style for a relationship path. Phase B stub.

Add a text note to a diagram. Phase B stub.

Return elements that use or are used by the given element.

Run built-in model validation and return structural violations.

Spelling suite violations (Cameo spell-checker noise) are separated into a spelling array and excluded from the violations count so that the 0-errors gate only reflects structural/semantic issues.

Return coverage statistics for requirements.

scope controls which requirements are counted:

• "authored" (default) — only user-model requirements, excluding SysML library and profile elements that inflate the denominator.

• "all" — every requirement in the model (legacy behaviour).

New fields: tracedCoverage (Satisfy + Refine + DeriveReqt + Verify), orphans (requirements with zero traceability links). Legacy fields total, satisfied, unsatisfied, satisfyCoverage are preserved.

Return the fraction of named elements that have documentation set.

scope controls the denominator:

• "authored" (default) — only user-model elements; avoids the ~25% ceiling caused by ~1840 undocumentable SysML library elements.

• "all" — every named element (legacy behaviour).

coverage reflects the scoped fraction; coverageModelWide is always reported for reference.

Return elements that violate UML naming conventions.

scope controls which elements are checked:

• "authored" (default) — user-model only; suppresses ~85 library internals (base_*, extension_*, A_*).

• "all" — every element.

allowed_patterns is an optional comma-separated list of regex patterns that exempt names from the default rules. Use this to allow requirement-ID schemes such as ^[A-Z]{2,}-\d+$ or Magic Grid label patterns like ^.+ Scenario$.

Return classifiers that are not used as a type anywhere in the model.

Return elements that share the same type+name combination.

Return a full requirements traceability matrix with satisfy/verify links.

Return full traceability chain for one requirement (derive, satisfy, verify).

Return a high-level summary of model element counts and coverage.

Return raw element counts broken down by UML/SysML type.

Enable write operations. Requires the write secret.

Disable write operations. Requires the write secret.

Enable dangerous write operations (delete, structural changes). Requires the write secret.

Enable developer mode. Requires the write secret.

Disable developer mode. Requires the write secret.

Open a batch session. All write operations within the batch are committed atomically when commit_batch fires.

Commit all queued operations in the given batch session.

Roll back all queued operations in the given batch session.

Execute Groovy script inside CATIA Magic's JVM with full SysML v1 API access. Requires dev mode active on the plugin side (see enable_dev_mode). Dev mode is a plugin-lifetime capability: it can only be enabled if JGS_V2_DEV_SECRET was set in the CATIA Magic process environment at startup, and the client must supply the matching secret value to enable_dev_mode. Dev mode is independent of licence tier: a FREE-tier client whose plugin was launched with JGS_V2_DEV_SECRET set can still enable dev mode and call execute_groovy. The env var is the security control.

A 'helpers' object is pre-loaded with convenience methods for the v1 (UML/MagicDraw-profile) API. All stereotype names are SysML profile names (e.g. "Block", "Requirement", "Satisfy") — strings, NOT classes:

helpers.findByQN('Model::Pkg::Element') — find by qualified name; returns the Element or null.

helpers.createElement(parent, 'name', factoryFn, stereotypeName=null) — create element under parent. factoryFn is a 0-arg closure returning a fresh element from project.elementsFactory, e.g. { project.elementsFactory.createClassInstance() } (for Block / Requirement) { project.elementsFactory.createPackageInstance() } (for Package) Optionally applies a SysML stereotype by name.

helpers.applyStereotype(element, 'Block') — apply a SysML stereotype by name (uses StereotypesHelper internally).

helpers.setTaggedValue(element, 'Requirement', 'id', 'REQ-001') — set a stereotype-tagged property value.

helpers.getTaggedValue(element, 'Requirement', 'id') — read a stereotype-tagged property value; returns a List (may be empty) or null.

The 'project' binding is pre-loaded with the currently-open Project instance.

Returns a pretty-printed JSON string (str, not dict — intentional: LLM consumers parse the indented JSON for readability, matching v2's macro_tools convention; other v1 tools return dict because FastMCP auto-serialises them, which is fine for non-LLM-facing payloads).

JSON shape (matches v2's executeGroovyStatic exactly): success (bool): true on successful eval, false on exception result (str): script return value via String.valueOf, "null" if script returned null. Only present when success. output (str): captured stdout/stderr from the script error (str): exception message. Only present when not success.