Essential Complexity - Interoperable solution architecture

Init Workspace

Create a new LinkML editing workspace backed by a bare git repository. Returns workspace_id and initial_commit. If files are omitted, creates a minimal schema.yaml.

Read Schema

Read a LinkML YAML schema file from a specific workspace commit. Use path to read schema.yaml or another local imported YAML file.

List Files

List files present in a LinkML workspace at a specific commit. Use this before targeting imported local schema files.

Get Entity

Fetch one LinkML entity from a schema file at a specific commit. entity_type must be class, slot, enum, prefix, or import.

Validate Schema

Validate a LinkML YAML schema at a specific workspace commit. This performs schema validation only and does not create a commit.

Apply Changeset

Apply an atomic ordered semantic changeset to a LinkML workspace. Requires base_commit; validates before and after edits; returns a new commit id. Supported operations include create/delete/rename class, slot, enum, prefix, import, file, plus set_field, unset_field, list_append, list_remove, list_replace, map_set, and map_remove.

List Generators

List the LinkML generators supported by this MCP server. Milestone generators are shacl, owl, and doc.

Describe Generator

Describe one supported LinkML generator and the option format accepted by run_generator. Generator options are passed as CLI-style option names without leading dashes.

Run Generator

Run a supported LinkML generator against a schema file at a specific commit. Does not validate automatically and does not commit generated artifacts. Returns inline content for small outputs or a temporary path for large/multi-file outputs.