Skip to main content

Leanix Agent

CLI or API | MCP | Agent

PyPI - Version MCP Server PyPI - Downloads GitHub Repo stars GitHub forks GitHub contributors PyPI - License GitHub GitHub last commit (by committer) GitHub pull requests GitHub closed pull requests GitHub issues GitHub top language GitHub language count GitHub repo size GitHub repo file count (file type) PyPI - Wheel PyPI - Implementation

Documentation — Installation, deployment, usage across the API, CLI, and MCP interfaces, and the authentication and dynamic-filtering guides are maintained in the official documentation.


Table of Contents


Overview

LeanIX Agent is a production-grade Agent and Model Context Protocol (MCP) provider for SAP LeanIX Enterprise Architecture Management REST and GraphQL APIs.


Key Features

  • Consolidated Action-Routed MCP Tools: Minimizes token overhead and eliminates tool bloat in LLM contexts by grouping methods into optimized, togglable tool modules.
  • Enterprise-Grade Security: Complete support for Eunomia policies, OIDC token delegation, and granular execution context tracking.
  • Integrated Graph Agent: Built-in Pydantic AI agent supporting the Agent Control Protocol (ACP) and standard Web interfaces (AG-UI).
  • Optional Telemetry: OTLP and Logfire instrumentation enable only when their runtime configuration is present.
  • Live Instance Ontology: Compiles the configured workspace data model into deterministic OWL, SHACL, and SKOS without checking in tenant schemas.
  • Governed Graph Sync: Streams privacy-sanitized FactSheets through atomic ChangeEnvelope commits under the caller's checked graph session.

CLI or API

The package exposes workspace-scoped LeanIX REST and GraphQL capabilities through its Python API, MCP provider, and optional A2A agent entry point.

Detailed instructions on how to use the underlying API wrappers, extended schema bindings, and developer SDK references are maintained in docs/index.md.


MCP

This server use dynamic Action-Routed tools to optimize token overhead and maximize IDE compatibility.

The complete surface includes bounded universal REST, GraphQL schema fingerprinting and multipart upload, live metamodel compilation, and full, delta, or reconcile graph synchronization. Every REST or GraphQL mutation requires explicit consent on that individual tool call.

Federating LeanIX's hosted MCP service as a child server is an Arbora concern; this package ships no child-runtime policy.

Available MCP Tools

Auto-generated — do not edit between the markers below.

One typed tool per API operation

Every LeanIX API operation is its own tool, named leanix_leanix_<service>_<operation> after the service client method it calls. 746 operation tools cover 31 services:

MCP Tool family Operations Service
leanix_leanix_ai_inventory_builder_<operation> 10 ai inventory builder
leanix_leanix_apptio_connector_<operation> 10 apptio connector
leanix_leanix_automations_<operation> 13 automations
leanix_leanix_discovery_ai_agents_<operation> 8 discovery ai agents
leanix_leanix_discovery_linking_v1_<operation> 11 discovery linking v1
leanix_leanix_discovery_linking_v2_<operation> 19 discovery linking v2
leanix_leanix_discovery_saas_<operation> 11 discovery saas
leanix_leanix_discovery_sap_<operation> 9 discovery sap
leanix_leanix_discovery_sap_extension_<operation> 20 discovery sap extension
leanix_leanix_documents_<operation> 17 documents
leanix_leanix_impacts_<operation> 5 impacts
leanix_leanix_integration_api_<operation> 24 integration api
leanix_leanix_integration_collibra_<operation> 29 integration collibra
leanix_leanix_integration_servicenow_<operation> 33 integration servicenow
leanix_leanix_integration_signavio_<operation> 20 integration signavio
leanix_leanix_inventory_data_quality_<operation> 9 inventory data quality
leanix_leanix_managed_code_execution_<operation> 15 managed code execution
leanix_leanix_metrics_<operation> 29 metrics
leanix_leanix_mtm_<operation> 152 mtm
leanix_leanix_navigation_<operation> 33 navigation
leanix_leanix_pathfinder_<operation> 68 pathfinder
leanix_leanix_poll_<operation> 32 poll
leanix_leanix_reference_data_<operation> 53 reference data
leanix_leanix_reference_data_catalog_<operation> 8 reference data catalog
leanix_leanix_storage_<operation> 13 storage
leanix_leanix_survey_<operation> 29 survey
leanix_leanix_synclog_<operation> 11 synclog
leanix_leanix_technology_discovery_<operation> 16 technology discovery
leanix_leanix_todo_<operation> 11 todo
leanix_leanix_transformations_<operation> 11 transformations
leanix_leanix_webhooks_<operation> 17 webhooks

Workspace-level tools

MCP Tool Description
leanix_get_factsheets Get a list of FactSheets.
leanix_get_factsheet Get a specific FactSheet by ID.
leanix_request_api Call a workspace API without permitting cross-host requests.
leanix_rest_api Invoke a workspace-scoped LeanIX operation with mutation consent.
leanix_discover_meta_model Discover the custom LeanIX meta-model/data-model schema including custom attributes and fields in real-time.
leanix_graphql Execute a bounded GraphQL document with mutation consent.
leanix_graphql_schema Introspect and fingerprint the current workspace schema.
leanix_graphql_upload Execute a bounded GraphQL multipart upload through configured TLS.
leanix_generate_instance_ontology Compile the current live data model to deterministic OWL, SHACL, and SKOS.
leanix_sync_instance_to_graph Load the generated ontology and stream records through ChangeEnvelope.
leanix_source_factsheets Return FactSheets for governed ChangeEnvelope materialization.
leanix_ingest_factsheets Natively ingest LeanIX FactSheets into medulla as typed nodes.

758 tools in all. The intent default surface is the six verb-tools, with the granular set loaded on demand.

Detailed tool schemas, parameter shapes, and validation constraints are documented in Usage.

Dynamic Tool Selection & Visibility

This MCP server supports dynamic toolset selection and visibility filtering at runtime. This allows the operator to restrict the set of exposed tools to prevent blowing up the LLM's context window.

The operator can configure tool filtering via multiple input channels:

  • CLI Arguments: Pass --tools or --toolsets (or their disabled counterparts --disabled-tools and --disabled-toolsets) during startup.
  • Environment Variables: Define standard environment variables:
    • MCP_ENABLED_TOOLS / MCP_DISABLED_TOOLS
    • MCP_ENABLED_TAGS / MCP_DISABLED_TAGS
  • HTTP SSE Request Headers: Pass custom headers during transport initialization:
    • x-mcp-enabled-tools / x-mcp-disabled-tools
    • x-mcp-enabled-tags / x-mcp-disabled-tags
  • HTTP SSE Request Query Parameters: Append query parameters directly to the operator's transport connection URL:
    • ?tools=tool1,tool2
    • ?tags=tag1

When query strings or parameters are supplied, an LLM-free Knowledge Graph resolution layer (using DynamicToolOrchestrator) matches query intents against known tool tags, names, or descriptions, with safe fallback and automated 24-hour background cache refreshing.


MCP Configuration Examples

Install the connector-focused [mcp] extra. Examples use leanix-agent[mcp] to add FastMCP / FastAPI through scion-sdk; the required Scion SDK core still carries medulla. The [agent-runtime] extra additionally enables model orchestration.

stdio Transport (local IDEs — Cursor, Claude Desktop, VS Code)

{
  "mcpServers": {
    "leanix-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "leanix-agent[mcp]",
        "leanix-mcp"
      ],
      "env": {
        "MCP_TOOL_MODE": "intent",
        "AUDIENCE": "https://app.leanix.net",
        "DELEGATED_SCOPES": "api",
        "GRAPHQLTOOL": "True",
        "INSTANCE_GRAPHTOOL": "True",
        "LEANIX_AI_INVENTORY_BUILDERTOOL": "True",
        "LEANIX_APPTIO_CONNECTORTOOL": "True",
        "LEANIX_AUTH_METHOD": "technical",
        "LEANIX_AUTOMATIONSTOOL": "True",
        "LEANIX_BROWSER_LOGIN": "False",
        "LEANIX_DISCOVERY_AI_AGENTSTOOL": "True",
        "LEANIX_DISCOVERY_LINKING_V1TOOL": "True",
        "LEANIX_DISCOVERY_LINKING_V2TOOL": "True",
        "LEANIX_DISCOVERY_SAASTOOL": "True",
        "LEANIX_DISCOVERY_SAPTOOL": "True",
        "LEANIX_DISCOVERY_SAP_EXTENSIONTOOL": "True",
        "LEANIX_DOCUMENTSTOOL": "True",
        "LEANIX_IMPACTSTOOL": "True",
        "LEANIX_INTEGRATION_APITOOL": "True",
        "LEANIX_INTEGRATION_COLLIBRATOOL": "True",
        "LEANIX_INTEGRATION_SERVICENOWTOOL": "True",
        "LEANIX_INTEGRATION_SIGNAVIOTOOL": "True",
        "LEANIX_INVENTORY_DATA_QUALITYTOOL": "True",
        "LEANIX_KG_INGESTTOOL": "True",
        "LEANIX_MANAGED_CODE_EXECUTIONTOOL": "True",
        "LEANIX_METRICSTOOL": "True",
        "LEANIX_MTMTOOL": "True",
        "LEANIX_NAVIGATIONTOOL": "True",
        "LEANIX_OAUTH_CLIENT_ID": "leanix-mcp",
        "LEANIX_OAUTH_REDIRECT_PORT": "56122",
        "LEANIX_OAUTH_SCOPE": "openid offline_access",
        "LEANIX_PATHFINDERTOOL": "True",
        "LEANIX_POLLTOOL": "True",
        "LEANIX_REFERENCE_DATATOOL": "True",
        "LEANIX_REFERENCE_DATA_CATALOGTOOL": "True",
        "LEANIX_STORAGETOOL": "True",
        "LEANIX_SURVEYTOOL": "True",
        "LEANIX_SYNCLOGTOOL": "True",
        "LEANIX_TECHNOLOGY_DISCOVERYTOOL": "True",
        "LEANIX_TODOTOOL": "True",
        "LEANIX_TRANSFORMATIONSTOOL": "True",
        "LEANIX_WEBHOOKSTOOL": "True",
        "LEANIX_WORKSPACE": "https://app.leanix.net",
        "TESTING_FALLBACK": "False",
        "UNIVERSAL_APITOOL": "True"
      }
    }
  }
}

Runtime references require an alias-aware launcher such as Arbora. Other launchers must omit those entries and inject the resolved values through their own runtime secret boundary.

Streamable-HTTP Transport (networked / production)

{
  "mcpServers": {
    "leanix-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "leanix-agent[mcp]",
        "leanix-mcp",
        "--transport",
        "streamable-http",
        "--port",
        "8000"
      ],
      "env": {
        "TRANSPORT": "streamable-http",
        "HOST": "127.0.0.1",
        "PORT": "8000",
        "MCP_TOOL_MODE": "intent",
        "AUDIENCE": "https://app.leanix.net",
        "DELEGATED_SCOPES": "api",
        "GRAPHQLTOOL": "True",
        "INSTANCE_GRAPHTOOL": "True",
        "LEANIX_AI_INVENTORY_BUILDERTOOL": "True",
        "LEANIX_APPTIO_CONNECTORTOOL": "True",
        "LEANIX_AUTH_METHOD": "technical",
        "LEANIX_AUTOMATIONSTOOL": "True",
        "LEANIX_BROWSER_LOGIN": "False",
        "LEANIX_DISCOVERY_AI_AGENTSTOOL": "True",
        "LEANIX_DISCOVERY_LINKING_V1TOOL": "True",
        "LEANIX_DISCOVERY_LINKING_V2TOOL": "True",
        "LEANIX_DISCOVERY_SAASTOOL": "True",
        "LEANIX_DISCOVERY_SAPTOOL": "True",
        "LEANIX_DISCOVERY_SAP_EXTENSIONTOOL": "True",
        "LEANIX_DOCUMENTSTOOL": "True",
        "LEANIX_IMPACTSTOOL": "True",
        "LEANIX_INTEGRATION_APITOOL": "True",
        "LEANIX_INTEGRATION_COLLIBRATOOL": "True",
        "LEANIX_INTEGRATION_SERVICENOWTOOL": "True",
        "LEANIX_INTEGRATION_SIGNAVIOTOOL": "True",
        "LEANIX_INVENTORY_DATA_QUALITYTOOL": "True",
        "LEANIX_KG_INGESTTOOL": "True",
        "LEANIX_MANAGED_CODE_EXECUTIONTOOL": "True",
        "LEANIX_METRICSTOOL": "True",
        "LEANIX_MTMTOOL": "True",
        "LEANIX_NAVIGATIONTOOL": "True",
        "LEANIX_OAUTH_CLIENT_ID": "leanix-mcp",
        "LEANIX_OAUTH_REDIRECT_PORT": "56122",
        "LEANIX_OAUTH_SCOPE": "openid offline_access",
        "LEANIX_PATHFINDERTOOL": "True",
        "LEANIX_POLLTOOL": "True",
        "LEANIX_REFERENCE_DATATOOL": "True",
        "LEANIX_REFERENCE_DATA_CATALOGTOOL": "True",
        "LEANIX_STORAGETOOL": "True",
        "LEANIX_SURVEYTOOL": "True",
        "LEANIX_SYNCLOGTOOL": "True",
        "LEANIX_TECHNOLOGY_DISCOVERYTOOL": "True",
        "LEANIX_TODOTOOL": "True",
        "LEANIX_TRANSFORMATIONSTOOL": "True",
        "LEANIX_WEBHOOKSTOOL": "True",
        "LEANIX_WORKSPACE": "https://app.leanix.net",
        "TESTING_FALLBACK": "False",
        "UNIVERSAL_APITOOL": "True"
      }
    }
  }
}

Alternatively, connect to a pre-deployed Streamable-HTTP instance by url:

{
  "mcpServers": {
    "leanix-mcp": {
      "url": "http://localhost:8000/leanix-mcp/mcp"
    }
  }
}

Run a reviewed container image as a least-privilege stdio child (no listener or published port):

docker run -i --rm \
  --read-only \
  --cap-drop=ALL \
  --security-opt=no-new-privileges \
  --pids-limit=256 \
  --tmpfs /tmp:rw,noexec,nosuid,nodev,size=64m \
  -e TRANSPORT=stdio \
  -e MCP_TOOL_MODE=intent \
  -e AUDIENCE=https://app.leanix.net \
  -e DELEGATED_SCOPES=api \
  -e GRAPHQLTOOL=True \
  -e INSTANCE_GRAPHTOOL=True \
  -e LEANIX_AI_INVENTORY_BUILDERTOOL=True \
  -e LEANIX_APPTIO_CONNECTORTOOL=True \
  -e LEANIX_AUTH_METHOD=technical \
  -e LEANIX_AUTOMATIONSTOOL=True \
  -e LEANIX_BROWSER_LOGIN=False \
  -e LEANIX_DISCOVERY_AI_AGENTSTOOL=True \
  -e LEANIX_DISCOVERY_LINKING_V1TOOL=True \
  -e LEANIX_DISCOVERY_LINKING_V2TOOL=True \
  -e LEANIX_DISCOVERY_SAASTOOL=True \
  -e LEANIX_DISCOVERY_SAPTOOL=True \
  -e LEANIX_DISCOVERY_SAP_EXTENSIONTOOL=True \
  -e LEANIX_DOCUMENTSTOOL=True \
  -e LEANIX_IMPACTSTOOL=True \
  -e LEANIX_INTEGRATION_APITOOL=True \
  -e LEANIX_INTEGRATION_COLLIBRATOOL=True \
  -e LEANIX_INTEGRATION_SERVICENOWTOOL=True \
  -e LEANIX_INTEGRATION_SIGNAVIOTOOL=True \
  -e LEANIX_INVENTORY_DATA_QUALITYTOOL=True \
  -e LEANIX_KG_INGESTTOOL=True \
  -e LEANIX_MANAGED_CODE_EXECUTIONTOOL=True \
  -e LEANIX_METRICSTOOL=True \
  -e LEANIX_MTMTOOL=True \
  -e LEANIX_NAVIGATIONTOOL=True \
  -e LEANIX_OAUTH_CLIENT_ID=leanix-mcp \
  -e LEANIX_OAUTH_REDIRECT_PORT=56122 \
  -e LEANIX_OAUTH_SCOPE="openid offline_access" \
  -e LEANIX_PATHFINDERTOOL=True \
  -e LEANIX_POLLTOOL=True \
  -e LEANIX_REFERENCE_DATATOOL=True \
  -e LEANIX_REFERENCE_DATA_CATALOGTOOL=True \
  -e LEANIX_STORAGETOOL=True \
  -e LEANIX_SURVEYTOOL=True \
  -e LEANIX_SYNCLOGTOOL=True \
  -e LEANIX_TECHNOLOGY_DISCOVERYTOOL=True \
  -e LEANIX_TODOTOOL=True \
  -e LEANIX_TRANSFORMATIONSTOOL=True \
  -e LEANIX_WEBHOOKSTOOL=True \
  -e LEANIX_WORKSPACE=https://app.leanix.net \
  -e TESTING_FALLBACK=False \
  -e UNIVERSAL_APITOOL=True \
  registry.example.invalid/leanix-agent@sha256:<digest> leanix-mcp

For containerized network HTTP, supply an authenticated TLS ingress (or direct server TLS), exact MCP_ALLOWED_HOSTS, and an exact trusted-proxy CIDR policy through the operator-owned deployment profile. The generator does not emit an unauthenticated non-loopback listener.

Auto-generated from the code-read env surface (MCP_TOOL_MODE + package vars) — do not edit.

Additional Deployment Options

leanix-agent can run as a local stdio process or container, or behind a remote network boundary. The Deployment guide carries the detailed transport contract.

  • Local container — launch a reviewed immutable image as a least-privilege stdio child with no listener or published port.
  • Remote URL — connect through an operator-supplied authenticated HTTPS ingress. Keep its URL, outbound identity references, trust profile, and exact MCP_ALLOWED_HOSTS in AgentConfig.

Agent

This repository features a fully integrated Pydantic AI Graph Agent. It communicates over the Agent Control Protocol (ACP) and interacts smoothly with the Agent Web UI (AG-UI) and Terminal interface.

Running the Agent CLI

To start the interactive command-line agent:

# Set credentials
export LEANIX_WORKSPACE="your_value"
export LEANIX_API_TOKEN="your_value"
export TLS_PROFILE_REF="secret://transport/leanix"
export DEBUG="your_value"
export PYTHONUNBUFFERED="your_value"
export LEANIX_TOKEN="your_value"

# Run the agent server
leanix-agent --provider openai --model-id gpt-4o

Docker Compose Orchestration

The checked-in docker/agent.compose.yml starts the MCP and agent services with fixed non-root identities, read-only root filesystems, dropped capabilities, bounded resources, loopback-only published ports, and no-new-privileges. It deliberately has no mutable image or model defaults. Supply immutable image digests and the operator-selected model through the environment:

export LEANIX_AGENT_MCP_IMAGE='registry.example.invalid/leanix-agent@sha256:<digest>'
export LEANIX_AGENT_AGENT_IMAGE='registry.example.invalid/leanix-agent@sha256:<digest>'
export PROVIDER='<configured-provider>'
export MODEL_ID='<configured-model>'
docker compose -f docker/agent.compose.yml up -d

Agent, graph-sync, and deployment behavior is documented in Deployment and Usage.


Security & Governance

Built directly upon the enterprise-ready scion-sdk core, standard security parameters are fully supported:

Access Control & Policy Enforcement

  • Eunomia Policies: Fine-grained, policy-driven tool authorization. Supports none, local embedded (mcp_policies.json), or centralized remote modes.
  • OIDC Token Delegation: Compliant with RFC 8693 token exchange for flowing authenticating user credentials from Web UI / ACP → Agent → MCP.
  • Scoped Credentials: Execution context runs restricted to the specific caller identity.

Runtime Security Grid

Feature Feature Enablement
Tool Guard Sensitivity inspection with human-in-the-loop validation Enabled by default
Prompt Injection Defense Input scanning, repetition monitoring, and recursive loop blocks Enabled by default
Context Safety Guard Stuck-loop detectors and contextual overflow preemptive alerts Enabled by default

Environment Variables

Package environment variables

Variable Example Description
HOST 127.0.0.1
PORT 8000
TRANSPORT stdio options: stdio, streamable-http, sse
MCP_TOOL_MODE intent options: intent, condensed, verbose, both
PROVIDER <configured-provider>
MODEL_ID <configured-model>
ENABLE_OTEL False
OTEL_EXPORTER_OTLP_ENDPOINT https://otel.example.invalid
OTEL_EXPORTER_OTLP_PUBLIC_KEY_REF secret://observability/otel-public-key
OTEL_EXPORTER_OTLP_SECRET_KEY_REF secret://observability/otel-secret-key
OTEL_EXPORTER_OTLP_PROTOCOL http/protobuf
EUNOMIA_TYPE none options: none, embedded, remote
EUNOMIA_POLICY_FILE mcp_policies.json
EUNOMIA_REMOTE_URL http://eunomia-server:8000
LEANIX_WORKSPACE https://app.leanix.net Base URL or specific workspace URL
LEANIX_AUTH_METHOD technical Options: technical, browser, token, api_token
LEANIX_TECHNICAL_USER — Technical user client ID; inject at runtime
LEANIX_TECHNICAL_USER_PASSWORD secret-injected Technical user secret; inject at runtime
LEANIX_API_TOKEN secret-injected Alternative static API token; inject at runtime
LEANIX_TOKEN secret-injected Generic fallback token; inject at runtime
LEANIX_BROWSER_LOGIN False Force browser interactive OAuth SSO fallback
LEANIX_OAUTH_CLIENT_ID leanix-mcp OAuth Application Client ID
LEANIX_OAUTH_SCOPE openid offline_access Standard OAuth Scopes
LEANIX_OAUTH_REDIRECT_PORT 56122 Local port to receive auth code callback
AUDIENCE https://app.leanix.net Audience URI for delegation
DELEGATED_SCOPES api Requested scopes for token exchange
TLS_PROFILE leanix Named profile selected from the runtime catalog
TLS_PROFILES_REF secret://transport/tls-profiles Runtime profile catalog
TLS_PROFILE_REF secret://transport/leanix Direct profile reference; use instead of TLS_PROFILE
DEFAULT_AGENT_NAME LeanIX Agent Customized name for downstream LLMs
AGENT_DESCRIPTION Enterprise Architecture Agent Customized agent description
AGENT_SYSTEM_PROMPT Act as an EA expert... Customized agent prompt template
TESTING_FALLBACK False Fallback testing switch for browser authentication
LEANIX_AI_INVENTORY_BUILDERTOOL True
LEANIX_APPTIO_CONNECTORTOOL True
LEANIX_AUTOMATIONSTOOL True
LEANIX_REFERENCE_DATA_CATALOGTOOL True
LEANIX_DISCOVERY_AI_AGENTSTOOL True
LEANIX_DISCOVERY_LINKING_V1TOOL True
LEANIX_DISCOVERY_LINKING_V2TOOL True
LEANIX_DISCOVERY_SAP_EXTENSIONTOOL True
LEANIX_DISCOVERY_SAASTOOL True
LEANIX_DOCUMENTSTOOL True
LEANIX_IMPACTSTOOL True
LEANIX_INTEGRATION_APITOOL True
LEANIX_INTEGRATION_COLLIBRATOOL True
LEANIX_INTEGRATION_SERVICENOWTOOL True
LEANIX_INTEGRATION_SIGNAVIOTOOL True
LEANIX_INVENTORY_DATA_QUALITYTOOL True
LEANIX_KG_INGESTTOOL True
LEANIX_MTMTOOL True
LEANIX_MANAGED_CODE_EXECUTIONTOOL True
LEANIX_METRICSTOOL True
LEANIX_NAVIGATIONTOOL True
LEANIX_PATHFINDERTOOL True
LEANIX_POLLTOOL True
LEANIX_REFERENCE_DATATOOL True
LEANIX_DISCOVERY_SAPTOOL True
LEANIX_TECHNOLOGY_DISCOVERYTOOL True
LEANIX_STORAGETOOL True
LEANIX_SURVEYTOOL True
LEANIX_SYNCLOGTOOL True
LEANIX_TODOTOOL True
LEANIX_TRANSFORMATIONSTOOL True
LEANIX_WEBHOOKSTOOL True
GRAPHQLTOOL True
INSTANCE_GRAPHTOOL True
UNIVERSAL_APITOOL True

Inherited scion-sdk variables (apply to every connector)

Variable Example Description
MCP_ENABLED_TOOLS — Comma-separated tool allow-list
MCP_DISABLED_TOOLS — Comma-separated tool deny-list
MCP_ENABLED_TAGS — Comma-separated tag allow-list
MCP_DISABLED_TAGS — Comma-separated tag deny-list
MCP_CLIENT_AUTH — Outbound MCP child auth: oidc-client-credentials | basic | none
OIDC_CLIENT_ID — OIDC client id (service-account auth)
OIDC_CLIENT_SECRET_REF secret://identity/oidc-client-secret Runtime secret reference for the OIDC service account
MCP_BASIC_AUTH_USERNAME — HTTP Basic username (MCP_CLIENT_AUTH=basic)
MCP_BASIC_AUTH_PASSWORD_REF secret://identity/mcp-basic-password Runtime secret reference for HTTP Basic auth (MCP_CLIENT_AUTH=basic)
DEBUG False Verbose logging
PYTHONUNBUFFERED 1 Unbuffered stdout (recommended in containers)
MCP_URL http://localhost:8000/mcp URL of the MCP server the agent connects to
ENABLE_WEB_UI True Serve the AG-UI web interface

68 package + 13 inherited variable(s). Auto-generated from .env.example + the shared scion-sdk set — do not edit.

Every variable the server reads. Copy .env.example to .env and populate only what the operator use; blank connector credentials leave the corresponding surface inactive.

Connection & credentials

Variable Description Default
LEANIX_WORKSPACE Base URL or specific workspace URL https://app.leanix.net
LEANIX_AUTH_METHOD Auth method: technical, browser, token, api_token technical
LEANIX_TECHNICAL_USER Technical user client id —
LEANIX_TECHNICAL_USER_PASSWORD Technical user password / secret —
LEANIX_API_TOKEN Static API token —
LEANIX_TOKEN Generic fallback token —
LEANIX_BROWSER_LOGIN Force browser interactive OAuth SSO fallback False
TLS_PROFILE Named runtime TLS profile selected through AgentConfig —
TLS_PROFILE_REF Direct secret reference containing a runtime TLS profile —
TLS_PROFILES_REF Secret reference containing the named profile catalog —

Certificate and hostname verification are mandatory. Runtime TLS profiles can add private trust anchors, mTLS client material, proxy policy, and standard-environment integration without storing certificate material or machine paths in this package.

SSO / OAuth (SSO path)

Variable Description Default
LEANIX_OAUTH_CLIENT_ID OAuth application client id leanix-mcp
LEANIX_OAUTH_SCOPE Standard OAuth scopes openid offline_access
LEANIX_OAUTH_REDIRECT_PORT Local port to receive the auth-code callback 56122

OIDC token delegation (RFC 8693)

Variable Description Default
AUDIENCE Audience URI for delegation https://app.leanix.net
DELEGATED_SCOPES Requested scopes for token exchange api

MCP server / transport

Variable Description Default
TRANSPORT stdio, streamable-http, or sse stdio
HOST Bind host (HTTP transports) 127.0.0.1
PORT Bind port (HTTP transports) 8000
MCP_TOOL_MODE Tool surface: intent, condensed, verbose, or both intent
DEBUG Verbose logging False
PYTHONUNBUFFERED Unbuffered stdout (recommended in containers) 1

Agent identity (full [agent] runtime only)

Variable Description Default
DEFAULT_AGENT_NAME Custom name for downstream LLMs LeanIX Agent
DEFAULT_AGENT_DESCRIPTION Custom agent description Enterprise Architecture Agent
DEFAULT_AGENT_SYSTEM_PROMPT Custom agent prompt template —

Telemetry & governance

Variable Description Default
ENABLE_OTEL Enable OpenTelemetry export False
OTEL_EXPORTER_OTLP_ENDPOINT OTLP collector endpoint —
OTEL_EXPORTER_OTLP_PUBLIC_KEY / OTEL_EXPORTER_OTLP_SECRET_KEY OTLP auth keys —
OTEL_EXPORTER_OTLP_PROTOCOL OTLP protocol (e.g. http/protobuf) —
EUNOMIA_TYPE Authorization mode: none, embedded, remote none
EUNOMIA_POLICY_FILE Embedded policy file mcp_policies.json
EUNOMIA_REMOTE_URL Remote Eunomia server URL —

Tool toggles

Each action-routed tool can be disabled individually via its toggle env var (set to false). The full list is in the Available MCP Tools table above (e.g. LEANIX_DOCUMENTSTOOL, LEANIX_NAVIGATIONTOOL, GRAPHQLTOOL).


Installation

Pick the extra that matches what the operator want to run:

Extra Installs Use when
leanix-agent[mcp] MCP server stack (scion-sdk, including the shared medulla core) The operator run the MCP server without model orchestration
leanix-agent[agent] Model orchestration and observability (scion-sdk) The operator run the integrated agent
leanix-agent[gql] GraphQL client dependency (gql) The operator use the native GraphQL tool
leanix-agent[all] MCP, model orchestration, observability, OWL, and GraphQL Development / both surfaces
# MCP server without model orchestration
uv pip install "leanix-agent[mcp]"

# Full agent runtime (Pydantic AI + medulla engine)
uv pip install "leanix-agent[agent]"

# Everything (development)
uv pip install "leanix-agent[all]"      # or: python -m pip install "leanix-agent[all]"

Container image targets

One multi-stage docker/Dockerfile builds two runtime surfaces, selected by --target:

Build target Contents Entrypoint
mcp MCP runtime plus the shared Scion SDK and medulla core leanix-mcp
agent (default) MCP runtime plus model orchestration and observability leanix-agent
docker build --target mcp   -t leanix-agent:mcp-local   docker/
docker build --target agent -t leanix-agent:agent-local docker/

Promote and deploy only an operator-reviewed immutable image digest.

Knowledge-graph database (medulla)

Every install carries the medulla core through Scion SDK. Select an embedded or remote engine through AgentConfig; an MCP-only deployment can connect to a shared Arbora service without autostarting another local engine. Deployment recipes (single-node + Raft HA), connection config, and the full database architecture are documented in the medulla deployment guide.


Documentation

The complete documentation is published as the official documentation site and is the recommended reference for installation, deployment, and day-to-day operation.

Page Contents
Installation pip, source, extras, prebuilt Docker image
Deployment run the MCP and agent servers, Compose, Caddy + Technitium, env config
Usage the MCP tools, the LeanixApi and GraphQL clients, the CLI
Overview the standardized agent-package pattern and concept registry
Introspection & Filtering authentication modes and dynamic toolset filtering
Concepts concept registry (CONCEPT:LIX-*)

Contribute

Contributions are welcome! Please ensure code quality by running local checks before submitting pull requests:

  • Format code using ruff format .
  • Lint code using ruff check .
  • Validate type-safety with mypy .
  • Ran test suites using pytest

Governed capability contract

This package ships a compact canonical skill surface with specialist procedures kept as referenced workflows. The current MCP tools, skill metadata, connector_manifest.yml, ontology, mappings, shapes, fixtures, migrations, tool-schema fingerprints, and certification metadata form one versioned capability contract. Validate them together; do not rely on stale tool names or historical per-task skill wrappers.

Runtime endpoints, credentials, certificate trust, tenant identity, retention, and observability policy are deployment inputs and are never packaged values. See Configuration, trust, and privacy before enabling a network transport, connector ingestion, Arbora delegation, or trace export.

Metadata

Release files for leanix-agent 2.3.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for leanix-agent 2.3.9
File Size Uploaded Provenance Actions
leanix_agent-2.3.9.tar.gz 202.1 kB Without provenance Details for leanix_agent-2.3.9.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for leanix-agent 2.3.9
File Interpreter ABI Platform Actions
leanix_agent-2.3.9-py3-none-any.whl Python 3 none any Details for leanix_agent-2.3.9-py3-none-any.whl

Total release size: 419.5 kB

Release files / leanix_agent-2.3.9.tar.gz

Download URL leanix_agent-2.3.9.tar.gz
Size 202.1 kB
Tags Source
SHA-256 checksum
How to use checksums
59f397f23baa8f4228cdc51166a0edea1b0378274bd2f12a147fcbccf74df001
BLAKE2b-256 checksum
How to use checksums
3e011004b495c703eb6e3545432b796300d6965d497794b549e0c9366589935f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.4

Release files / leanix_agent-2.3.9-py3-none-any.whl

Download URL leanix_agent-2.3.9-py3-none-any.whl
Size 217.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
466b0fb5df9c805b6bac8d41b52fec2e9311fd1694148d86466270b9a176b34e
BLAKE2b-256 checksum
How to use checksums
85da27fbd1c6741ac727a544979aef42c3745c6843cd38bae58729c42ccd2dc7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.4

Security for leanix-agent 2.3.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.3.9 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page