CLASSIFICATION: PUBLIC LICENCE: PROPRIETARY DOC-ID: TOOL-REF-35 REV 1.0.0

§00: TOOL REFERENCE

All 35 tools, generated from the live registry

This page lists every MCP tool jgs-sysmlv2-api-mcp registers, with its parameters and which ones are required. It is generated directly from build_server().tool_specs() by scripts/gen_tool_reference_html.py, the same registry that produces docs/TOOL-REFERENCE.md, so this page and the server can never drift apart. Full workflow walkthroughs live in docs/usage.md; this page is the parameter-level lookup.

§02 Staged authoring writes

create_element

Stage creation of a new element under an owner (buffer-only).

ParameterTypeRequired
typestringyes
namestringyes
ownerstringyes

modify_element

Stage a modification to an existing element (buffer-only).

ParameterTypeRequired
element_idstringyes
changesobjectyes

delete_element

Stage deletion of a single element (buffer-only; refuses if it owns children).

ParameterTypeRequired
element_idstringyes

delete_subtree

Stage deletion of an element and its owned subtree (buffer-only).

ParameterTypeRequired
element_idstringyes

create_relationship

Stage a typed relationship (buffer-only). Sets explicit source/target plus the type's concrete end fields (Subclassification, Specialization, Subsetting, Redefinition, FeatureTyping, Dependency); other types take concrete ends via properties.

ParameterTypeRequired
typestringyes
sourcestringyes
targetstringyes
ownerstringno
propertiesobjectno

move_element

Stage a rehome of an element to a new owner (buffer-only; modifies its OwningMembership at the commit). commit_id defaults to the branch head.

ParameterTypeRequired
element_idstringyes
new_ownerstringyes
commit_idstringno

stage_batch

Stage many operations atomically (all-or-nothing, buffer-only). Ops: {op: create|relate|modify|delete, ...}; create ops accept a caller-minted element_id so later ops in the batch can reference it.

ParameterTypeRequired
operationsarrayyes

review_changes

Return the staged ops + a confirm token (must be reviewed before commit).

No parameters.

commit_changes

Commit the staged buffer; requires a fresh confirm token.

ParameterTypeRequired
messagestringno
confirmstringyes

discard_changes

Discard the staged buffer without committing.

No parameters.

§03 Project lifecycle

create_project

Create a project (name, optional description). The session stays bound to its configured project.

ParameterTypeRequired
namestringyes
descriptionstringno

update_project

Rename or re-describe a project. project_id defaults to the configured project. Only provided fields change.

ParameterTypeRequired
project_idstringno
namestringno
descriptionstringno

delete_project

Delete a project (destructive; requires confirm: true). The session's configured project is refused; outcome is verified via the project list.

ParameterTypeRequired
project_idstringyes
confirmbooleanyes

list_projects

List projects visible to this API endpoint.

No parameters.

§04 Branch and tag versioning

list_branches

List branches (id, name, head commit). Optional project_id overrides the configured project.

ParameterTypeRequired
project_idstringno

create_branch

Create a branch. head_commit_id defaults to the session branch head.

ParameterTypeRequired
namestringyes
head_commit_idstringno

delete_branch

Delete a branch (destructive; requires confirm: true). Outcome is verified via the branch list; the default branch is refused.

ParameterTypeRequired
branch_idstringyes
confirmbooleanyes

merge_branch

Squash-merge a source branch onto a target branch as one commit (requires confirm: true). Refuses with conflicting element ids if both branches changed the same element.

ParameterTypeRequired
source_branch_idstringyes
target_branch_idstringyes
descriptionstringno
confirmbooleanyes

set_branch

Retarget this session at a branch: staged commits and default read head follow it. Refused while staged work exists.

ParameterTypeRequired
branch_idstringyes

list_tags

List tags (name, tagged commit). Optional project_id overrides the configured project.

ParameterTypeRequired
project_idstringno

create_tag

Tag a commit (checkpoint). commit_id defaults to the session branch head.

ParameterTypeRequired
namestringyes
commit_idstringno

§05 Infrastructure

ping

Minimal liveness probe: confirms the endpoint is reachable.

No parameters.

stats

Return a snapshot of server metrics counters.

No parameters.