Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
KAFKA_SSLNoSet to 'true' to enable TLS for the Kafka connection.
KAFKA_MODENoAccess mode: read-only, read-write, or admin. Defaults to read-only.read-only
KAFKA_BROKERSYesComma-separated list of Kafka broker addresses. Example: broker1:9092,broker2:9092
KAFKA_DRY_RUNNoIf 'true', write and admin tools validate + log intent without making cluster changes. Defaults to 'false'.false
KAFKA_AUDIT_LOGNoIf 'true', emits a JSON audit log line to stderr per guarded operation. Defaults to 'true'.true
KAFKA_ALLOW_DELETENoSet to 'true' to enable delete_topic and delete_consumer_group (requires admin mode). Defaults to 'false'.false
KAFKA_SASL_PASSWORDNoPassword for SASL authentication.
KAFKA_SASL_USERNAMENoUsername for SASL authentication.
KAFKA_SASL_MECHANISMNoSASL mechanism: PLAIN, SCRAM-SHA-256, or SCRAM-SHA-512.
KAFKA_TOPIC_ALLOWLISTNoComma-separated list of allowed topics. When set, operations on other topics are refused.
KAFKA_PROTECTED_TOPICSNoComma-separated list of additional topics that are read-only forever.
KAFKA_PROTECT_INTERNAL_TOPICSNoSet to 'false' to allow mutation of topics starting with an underscore. Defaults to 'true'.true

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
cluster_infoA

Describe the Kafka cluster: brokers, controller, and cluster id.

list_topicsA

List topic names. Topics outside the allowlist are filtered out.

describe_topicA

Partitions, replicas, in-sync replicas, and non-default configs for a topic.

topic_offsetsA

Earliest and latest offsets per partition for a topic (message backlog view).

list_consumer_groupsA

List consumer groups and their protocol types.

describe_consumer_groupA

Describe a consumer group's state and compute per-partition and total lag across its topics.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4/5.0

Scored across 6 tools

Disambiguation5/5

Each tool targets a distinct aspect: cluster metadata, topic names, topic configuration, offsets, consumer group listing, and consumer group lag. The only mild overlap is describe_topic vs topic_offsets, but their descriptions clearly separate configuration/replica details from offset ranges.

Naming Consistency4/5

Most tools follow list_* or describe_* verb patterns, which is predictable and clear. However, topic_offsets and cluster_info use noun-style names rather than verb_noun, creating minor inconsistency.

Tool Count5/5

Six tools is well-scoped for a Kafka inspection and monitoring server. Each tool covers a meaningful read-only capability without redundancy or bloat.

Completeness4/5

The set provides solid read-only coverage: cluster info, topic discovery/description, offsets, consumer groups, and lag. It lacks administrative operations like creating/deleting topics or message produce/consume, but those seem outside the likely inspection-focused purpose.

Maintenance

ActivityMaintained
ResponsivenessNo issues