Skip to main content
Glama
ZenixSolutions

lumics-mcp

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LUMICS_TOKENYesLumics API token (JWT bearer). Sent as Authorization: Bearer <token>.
LUMICS_BASE_URLNoAPI base URL. Override only for a self-hosted or non-production Lumics.https://app.lumics.io/api/v1
LUMICS_HTTP_HOSTNoHTTP bind address (v0.2 only, inert in 0.1.0).127.0.0.1
LUMICS_HTTP_PORTNoHTTP listener port (v0.2 only, inert in 0.1.0).3000
LUMICS_LOG_LEVELNoDiagnostic verbosity on stderr: debug, info, warn, error, silent.info
LUMICS_READ_ONLYNoSet to '1' to register only read tools. Recommended.
LUMICS_TRANSPORTNoTransport mode: stdio (only supported in 0.1.0).stdio
LUMICS_COMPANY_IDNoYour Lumics company id (24-character hex). If unset, the server starts with only tools that need no company.
LUMICS_TIMEOUT_MSNoPer-request timeout in milliseconds.30000
LUMICS_CONTRACT_TESTSNoMaintainers only. Set to '1' to run tests that make real, read-only calls against a live tenant.
LUMICS_HTTP_AUTH_TOKENNoShared secret for HTTP transport (v0.2 only, inert in 0.1.0).
LUMICS_MAX_OUTPUT_CHARSNoMaximum characters of tool output.25000
LUMICS_HTTP_ALLOWED_HOSTSNoComma-separated Host allowlist for DNS-rebinding protection (v0.2 only, inert in 0.1.0).127.0.0.1,localhost,[::1]
LUMICS_ALLOW_CROSS_COMPANYNoSet to '1' to let a tool call name a companyId other than LUMICS_COMPANY_ID.
LUMICS_ENABLE_BATCH_UPDATENoSet to '1' to expose bulk device update.
LUMICS_HTTP_ALLOWED_ORIGINSNoComma-separated Origin allowlist for CORS (v0.2 only, inert in 0.1.0).
LUMICS_ENABLE_TOKEN_REVOCATIONNoSet to '1' to expose token revocation.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
lumics_get_device_definition_componentsA

Return the platform-wide component definitions that describe what each component type looks like: filePath, and a "data" block with modelName, itemType, componentAlias, isDefaultMonitored, nameProperty, the field "schema" (which property names a component of that type carries, and their types), and componentManagement. Use this when you need to know what fields a component type has or how it is defined — for instance to interpret an unfamiliar component. Its "schema" is the INVENTORY schema and carries no metric property names, so do NOT use it to find values for a metric tool's "properties" argument: a live contract run on 2026-07-30 grepped the whole payload and found zero occurrences of any metric type group. Use lumics_get_metric_summary for that instead (spec section 12.5 M6). This endpoint IS the source for a metric itemType, which is built as the filePath module/group path plus "data.itemType" joined by "_" — for example /components/snmp/common/Cpu.yml with itemType "cpu" gives "snmp_common_cpu". This is Lumics platform metadata, not tenant data: it is the same for every company, describes every type the product supports rather than the types this tenant uses, and takes no company id. It is also large, and it accepts no limit — if you only need a valid component type key for this tenant, call lumics_list_component_types instead, which is much smaller. Pass "fields" (e.g. ["filePath"]) to keep the response manageable.

lumics_get_meA

Return the Lumics user this server authenticates as, together with the company that user belongs to — the company id, name, IANA timezone and active flag. This is the tool that bootstraps the rest of the server: LUMICS_COMPANY_ID is optional, and when the operator has not set it the company-scoped tools (devices, collectors, components, IPAM, company metrics) are not registered at all, so this may be almost the only tool you can see. In that state, call this tool, then tell the operator to set LUMICS_COMPANY_ID to the "company.id" value it returns and restart the server — passing the id as a companyId argument will not help, because those tools are absent rather than failing. It is also the cheapest way to check that the configured credential works at all. Takes no arguments and changes nothing.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ZenixSolutions/lumics-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server