get_project
Project metadata (name, description, default branch). Optional project_id overrides the configured project.
| Parameter | Type | Required |
|---|---|---|
project_id | string | no |
§00: TOOL REFERENCE
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.
create_elementStage creation of a new element under an owner (buffer-only).
| Parameter | Type | Required |
|---|---|---|
type | string | yes |
name | string | yes |
owner | string | yes |
modify_elementStage a modification to an existing element (buffer-only).
| Parameter | Type | Required |
|---|---|---|
element_id | string | yes |
changes | object | yes |
delete_elementStage deletion of a single element (buffer-only; refuses if it owns children).
| Parameter | Type | Required |
|---|---|---|
element_id | string | yes |
delete_subtreeStage deletion of an element and its owned subtree (buffer-only).
| Parameter | Type | Required |
|---|---|---|
element_id | string | yes |
create_relationshipStage 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.
| Parameter | Type | Required |
|---|---|---|
type | string | yes |
source | string | yes |
target | string | yes |
owner | string | no |
properties | object | no |
move_elementStage a rehome of an element to a new owner (buffer-only; modifies its OwningMembership at the commit). commit_id defaults to the branch head.
| Parameter | Type | Required |
|---|---|---|
element_id | string | yes |
new_owner | string | yes |
commit_id | string | no |
stage_batchStage 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.
| Parameter | Type | Required |
|---|---|---|
operations | array | yes |
review_changesReturn the staged ops + a confirm token (must be reviewed before commit).
No parameters.
commit_changesCommit the staged buffer; requires a fresh confirm token.
| Parameter | Type | Required |
|---|---|---|
message | string | no |
confirm | string | yes |
discard_changesDiscard the staged buffer without committing.
No parameters.
create_projectCreate a project (name, optional description). The session stays bound to its configured project.
| Parameter | Type | Required |
|---|---|---|
name | string | yes |
description | string | no |
update_projectRename or re-describe a project. project_id defaults to the configured project. Only provided fields change.
| Parameter | Type | Required |
|---|---|---|
project_id | string | no |
name | string | no |
description | string | no |
delete_projectDelete a project (destructive; requires confirm: true). The session's configured project is refused; outcome is verified via the project list.
| Parameter | Type | Required |
|---|---|---|
project_id | string | yes |
confirm | boolean | yes |
list_projectsList projects visible to this API endpoint.
No parameters.
list_branchesList branches (id, name, head commit). Optional project_id overrides the configured project.
| Parameter | Type | Required |
|---|---|---|
project_id | string | no |
create_branchCreate a branch. head_commit_id defaults to the session branch head.
| Parameter | Type | Required |
|---|---|---|
name | string | yes |
head_commit_id | string | no |
delete_branchDelete a branch (destructive; requires confirm: true). Outcome is verified via the branch list; the default branch is refused.
| Parameter | Type | Required |
|---|---|---|
branch_id | string | yes |
confirm | boolean | yes |
merge_branchSquash-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.
| Parameter | Type | Required |
|---|---|---|
source_branch_id | string | yes |
target_branch_id | string | yes |
description | string | no |
confirm | boolean | yes |
set_branchRetarget this session at a branch: staged commits and default read head follow it. Refused while staged work exists.
| Parameter | Type | Required |
|---|---|---|
branch_id | string | yes |
list_tagsList tags (name, tagged commit). Optional project_id overrides the configured project.
| Parameter | Type | Required |
|---|---|---|
project_id | string | no |
create_tagTag a commit (checkpoint). commit_id defaults to the session branch head.
| Parameter | Type | Required |
|---|---|---|
name | string | yes |
commit_id | string | no |
pingMinimal liveness probe: confirms the endpoint is reachable.
No parameters.
statsReturn a snapshot of server metrics counters.
No parameters.