Skip to content

leanix-agent — Concept Overview

Category: Enterprise | Ecosystem Role: MCP Server + A2A Agent Built on agent-utilities — the unified AGI Harness.

Description

Agent package for communicating with LeanIX Enterprise Architecture Management via REST APIs and GraphQL.

Enterprise Readiness

All agents in the ecosystem inherit enterprise-grade infrastructure from agent-utilities:

Feature Status Source
JWT/OIDC Authentication ✅ Built-in agent-utilities[auth] — Authlib JWKS + API key middleware
OpenTelemetry Instrumentation ✅ Built-in agent-utilities[logfire] — OTLP export, FastAPI auto-instrumentation
HashiCorp Vault Integration ✅ Built-in agent-utilities[vault]secret://, env://, vault:// URI schemes
Audit Logging ✅ Built-in Append-only compliance trail with 30+ action types (CONCEPT:AU-OS.governance.wasm-micro-agent-sandbox)
Token Usage Analytics ✅ Built-in 4-bucket tracking with budget alerting (CONCEPT:AU-OS.governance.wasm-micro-agent-sandbox)
Prompt Injection Defense ✅ Built-in 25+ pattern scanner + jailbreak taxonomy (CONCEPT:AU-OS.config.secrets-authentication)
Guardrail Engine ✅ Built-in Input/output interception with block/redact/warn (CONCEPT:AU-OS.governance.reactive-multi-axis-budget)
Action Execution Pipeline ✅ Built-in Token, cost, duration, and node transition limits Dry-run / commit / rollback phases (CONCEPT:AU-ORCH.adapter.kg-graph-materialization)
Resource Scheduling ✅ Built-in Priority queuing + preemption limits (CONCEPT:AU-OS.state.cognitive-scheduler-preemption)
Session Concurrency ✅ Built-in Enqueue/reject/interrupt/rollback (CONCEPT:AU-OS.governance.reactive-multi-axis-budget)

Concept Registry

This project implements or inherits the following ecosystem concepts:

Concept ID Description Source
ECO-4.1 MCP & Universal Skills agent-utilities (inherited)

📖 Full Registry: See agent-utilities/docs/overview.md for the complete 5-Pillar concept index.

Architecture

This project follows the standardized agent-package pattern:

leanix-agent/
├── leanix_agent/          # Provider source
│   ├── api/                    # Per-service REST clients
│   ├── leanix_gql.py           # Bounded GraphQL transport
│   ├── metamodel.py            # Live schema/ontology compiler
│   ├── instance_sync.py        # Governed ChangeEnvelope sync
│   ├── official_mcp.py         # External hosted-MCP policy
│   ├── mcp_server.py           # FastMCP provider entry point
│   └── skills/                 # Consolidated operations workflow
├── tests/                   # Test suite
├── docs/                    # Documentation
├── docker/Dockerfile        # Agent and MCP image targets
├── pyproject.toml           # Package metadata
├── mcp_config.json          # MCP server configuration
└── main_agent.json          # Agent identity and system prompt

MCP Configuration

stdio Mode

{
  "mcpServers": {
    "leanix-agent": {
      "command": "leanix-mcp",
      "args": [],
      "env": {}
    }
  }
}

Streamable HTTP Mode

leanix-mcp --transport streamable-http --host 127.0.0.1 --port 8001