Provides a local MCP and REST API on top of the currently active Archi model.

Enables LLMs to fetch model information, modify objects and diagrams, and execute scripts via the REST API.

Provides LLMs access to the currently active Archi model:

• Search elements and relations in the model
• Create and edit elements
• Create and edit relations
• Create and edit diagrams
  • Add elements and relations to a diagram, remove from a diagram, move elements
  • Support for nested elements
  • Export diagram images to PNG and SVG
• Get the list of available element and relation types
• Run scripts (requires the jArchi plugin to be installed)
• Retrieve status and openapi.json

Most operations support batch mode to speed up workflows by processing multiple items at once.

Requirements: Archi 5.x; running scripts requires the jArchi plugin.

Download from Releases. To install, place the .zip file into the Archi dropins directory.

The plugin starts automatically with Archi.

You can change the HTTP server host and port in Archi → Preferences → MCP. Warning: changing host may be unsafe because there is no auth or encryption.

Note: the API is available without authentication. Default bind is http://127.0.0.1:8765/ (local connections only). You may override host/port via System Properties archi.mcp.host/archi.mcp.port, Env ARCHI_MCP_HOST/ARCHI_MCP_PORT, or Preferences.

Example configuration for Cursor

{
  "mcpServers": {
       "archi-mcp": {
      "url": "http://127.0.0.1:8765/mcp",
    }
  }
}

• You can change the HTTP server host and port in Archi → Preferences → MCP. Warning: changing host might be unsafe, because no auth and encryption is used!
• Precedence: System Property → Env → Preferences → Default. Keys: archi.mcp.host, ARCHI_MCP_HOST, archi.mcp.port, ARCHI_MCP_PORT. Defaults: 127.0.0.1, 8765.

The plugin adds a dedicated "MCP" toolbar with an "MCP Server" toggle. Clicking toggles the server on/off without restarting Archi.

The ru.cinimex.archimatetool.mcp folder is an Eclipse project (PDE). See detailed steps in BUILD.md.

The plugin includes comprehensive smoke tests for AI agents:

• AGENT_SMOKE_TEST.md - Complete testing guide with AI agent prompts and step-by-step instructions

Run Archi with -consoleLog to see MCP plugin logs.

Code mostly(like 99%) written by Codex and Cursor.

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Copyright 2025 Cinimex

Next steps

• [] API Key authentication, configuration in Archi settings
• [] Archi Headless mode support for the plugin
• [] Build instructions for the plugin
• [] Full build automation
• [] Prompt improvements for diagram operations