leanix-agent¶

LeanIX Enterprise Architecture Management MCP Server + A2A Agent for the agent-utilities ecosystem — typed REST and GraphQL access to FactSheets, metrics, discovery, and integrations, with confidence-gated graph routing.

Official documentation

This site is the canonical reference for leanix-agent, maintained alongside every release.

Overview¶

leanix-agent wraps the SAP LeanIX (Enterprise Architecture Management) REST and Pathfinder GraphQL surface with typed, deterministic MCP tools, and ships an optional Pydantic-AI agent server for agent-to-agent (A2A) orchestration. It provides:

LeanixApi — a REST facade over the Pathfinder API for FactSheet operations, with GraphQL for flexible Pathfinder queries and get_client() to build a client straight from the environment.
30+ LeanIX service domains exposed as action-routed MCP tools (Pathfinder, Metrics, MTM, Discovery, Integrations, Webhooks, and more), filtered dynamically to keep the agent context lean.
Dynamic meta-model introspection for zero-hallucination GraphQL schema discovery, plus interactive OAuth, OIDC delegation, and technical-user authentication.

Explore the documentation¶

Installation — pip, source, extras, and the prebuilt Docker image.
Deployment — run the MCP and agent servers, Docker Compose, Caddy + Technitium.
Usage — the MCP tools, the LeanixApi client, and the CLI.
Architecture — the standardized agent-package pattern and concept registry.
Introspection & Filtering — authentication modes and dynamic toolset filtering.
Concepts — the CONCEPT:LIX-* registry.

Quick start¶

pip install leanix-agent
leanix-mcp                       # stdio MCP server (default transport)

Connect it to a LeanIX workspace:

export LEANIX_WORKSPACE=https://your-workspace.leanix.net
export LEANIX_API_TOKEN=your_leanix_api_token
leanix-mcp --transport streamable-http --host 0.0.0.0 --port 8000

See Installation and Deployment for the full matrix (PyPI extras, Docker image, all transports, the agent server, reverse proxy, and DNS).