LeanIX MTM

This MCP server lets you read LeanIX MTM data from your own workflows without altering any data. It exposes a comprehensive set of read-only endpoints for accounts, workspaces, users, contracts, events, domains, identity providers, labels, and more, so you can build powerful, read-backed automations and dashboards while handling large datasets with built-in pagination and filtering.

How to use

You will run a local MCP client that talks to the LeanIX MTM MCP server using a standard interface. Start the MCP runtime, then add the LeanIX MTM MCP server configuration to your client. You can query accounts, workspaces, users, contracts, instances, events, identities, domains, and labels. All operations are read-only, and you get robust pagination and filtering support to navigate large result sets. Use the event endpoints to surface changes over time and filter by date, type, or entity, and combine multiple endpoints to build comprehensive views of your LeanIX MTM data.

How to install

Prerequisites you need before installing include Node.js and an MCP-capable client or environment that can run MCP servers via stdio configuration.

Install the MCP runtime using your preferred package manager or the provided runtime. The setup below demonstrates the typical workflow used to run the LeanIX MTM MCP server locally.

# Install dependencies and build if required by your environment
npm install
npm run build

# Run the MCP inspector to verify the server is up (optional but helpful)
npm run inspector

Additional sections

Configuration for the LeanIX MTM MCP server centers on a token and instance to authenticate with LeanIX. You will provide these values to your MCP client so it can reach LeanIX securely.

Environment variables to set for the MCP runtime: LeanIX token and LeanIX instance.

Security and reliability notes: The server uses OAuth 2.0 authentication with automatic token refresh and includes proper error handling to help you build resilient integrations.

Example usage with Claude Desktop shows how to wire the MCP server into your client interface by supplying token and instance in the environment block.

If you run into issues, ensure your LeanIX token is valid and has access to the required MTM scopes, and verify that your LeanIX_INSTANCE matches the region or deployment you intend to query.

Available tools

get_accounts

List or search all accounts with pagination, returning account UUIDs and metadata.

get_account

Retrieve a single account by UUID.

get_workspaces

List workspaces with filters for features and labels, plus pagination.

get_workspace

Retrieve a single workspace by UUID.

get_users

List or search all users with pagination.

get_user

Retrieve a single user by UUID.

get_permissions

List user permissions with extensive filtering and pagination.

get_permission

Retrieve a single permission by UUID.

get_contracts

List all contracts with search and pagination.

get_contract

Retrieve a single contract by UUID.

get_instances

List all instances with filtering and pagination.

get_instance

Retrieve a single instance by UUID.

get_account_events

Retrieve all events for a specific account with date filtering and pagination.

get_workspace_events

Retrieve all events for a specific workspace with date filtering, event type filter, and pagination.

get_contract_events

Retrieve all events for a specific contract with date filtering and pagination.

get_user_events

Retrieve all events for a specific user with date filtering and pagination.

get_instance_events

Retrieve all events for a specific instance with date filtering and pagination.

get_identity_provider_events

Retrieve all events for a specific identity provider with date filtering and pagination.

get_event

Retrieve a single event by UUID.

get_technical_users

List or search all technical users with pagination.

get_technical_user

Retrieve a single technical user by UUID.

get_domains

List all domains with filtering (FQDN, instance) and pagination.

get_domain

Retrieve a single domain by UUID.

get_identity_providers

List all identity providers with filtering and pagination.

get_identity_provider

Retrieve a single identity provider by UUID.

get_custom_features

List all custom features filtered by contract or workspace.

get_custom_feature

Retrieve a single custom feature by UUID.

get_labels

Get all labels (optionally filtered by name).

get_labels_by_workspace

Get all labels attached to a specific workspace.