load_model_from_file
Load an ArchiMate model from a local file, replacing the active model, and optionally inspect its structure, types, and validation status.
Instructions
Load an ArchiMate model from a local file (replaces active model).
The preferred entry point when the user gives a local `.archimate`
or XML file path. Expects a filesystem path readable by the MCP
server process; for raw XML text use `load_model_from_content`.
By default the response includes a compact inspection (summary,
type counts, validation status, recommended next calls) so a
separate `inspect_active_model` round trip is unnecessary.
Args:
path: Local filesystem path readable by the MCP server process.
`~` is expanded; relative paths resolve against the server CWD.
content_format: One of `archi` (default, Archi native
`.archimate`), `archimate` (Open Group exchange XML), or
`xml`.
inspect_after_load: When true (default), include a compact model
summary, type counts, validation status, and recommended next
calls in the response.
include_semantic_validation: When true (default), include a
compact semantic validation summary when inspecting.
sample_limit: Maximum number of issue/orphan examples to include
in compact summaries. Clamped to 0-50.
Returns:
Success envelope with `data.model_info`, `data.loaded_from`, and
optionally `data.inspection`.
Errors:
`INVALID_PATH`, `FILE_NOT_FOUND`, `FILE_READ_ERROR`,
`UnsupportedFormatError`, or `ModelOperationError`.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| sample_limit | No | ||
| content_format | No | archi | |
| inspect_after_load | No | ||
| include_semantic_validation | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||