archimate-mcp

agent** — full ArchiMate 3.x authoring for AI agents, with round-trip Open Group Model Exchange File Format so models open directly in Archi.

Official documentation

This site is the canonical reference for archimate-mcp, maintained alongside every release.

Overview

archimate-mcp gives AI agents the full ArchiMate 3.x authoring surface through typed, deterministic MCP tools. Archi has no native server API, so this package ships its own dependency-light engine built on the Python standard library (xml.etree.ElementTree). It provides:

• ArchiApi — a stateful façade over a single ArchiMate model file: model lifecycle, full CRUD on elements, relationships, folders, and views (diagrams), query/traversal, and Open Exchange Format import/export.
• Six MCP tools — archi_model, archi_element, archi_relationship, archi_view, archi_folder, and archi_query, spanning the complete ArchiMate vocabulary (Strategy, Business, Application, Technology, Physical, Motivation, and Implementation layers) with structural validation.

Models authored through archimate-mcp round-trip the Open Group Model Exchange File Format, so they open directly in Archi and any conformant ArchiMate tool.

Explore the documentation

• :material-rocket-start: Installation — pip, source, extras, and the prebuilt Docker image.
• Usage — the MCP tools, the ArchiApi client, and the CLI entry points.
• Concepts — the CONCEPT:ARCHI-* registry.

Quick start

pip install "archimate-mcp[mcp]"
archimate-mcp                       # stdio MCP server (default transport)

Point it at a working model file and run an HTTP server:

export ARCHI_MODEL_PATH=./model.archimate
archimate-mcp --transport http --host 0.0.0.0 --port 8000

See Installation and Deployment for the reverse proxy, and DNS).

Spec delivery

Spec delivery dashboard. No owned specs are recorded yet. Missing requirement and code mappings remain unknown.