Lagaam
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TRINO_HOST | No | Trino coordinator host. | localhost |
| TRINO_PORT | No | Trino coordinator port. | 8080 |
| TRINO_USER | No | Trino user. | lagaam |
| LAGAAM_ENGINE | No | Set to pinot to use the native Pinot adapter. | trino |
| LAGAAM_MAX_ROWS | No | Scanned-row estimate budget per query. | |
| LAGAAM_AUDIT_LOG | No | Audit JSONL file path. | stderr |
| LAGAAM_AGENT_NAME | No | Identity stamped on the audit trail. | anonymous |
| LAGAAM_METADATA_TTL | No | Metadata cache TTL, seconds. | 300 |
| LAGAAM_QUERY_TIMEOUT | No | Wall-clock seconds per query. | 300 |
| LAGAAM_ALLOWED_TABLES | No | Comma list of catalog.schema.table grants. Required unless LAGAAM_ALLOW_ALL_TABLES is set to true. | |
| LAGAAM_MAX_SCAN_BYTES | No | Scan-bytes budget per query, pre-execution. | 53687091200 |
| LAGAAM_ALLOW_ALL_TABLES | No | Set to true to run with no grant at all. | |
| LAGAAM_MAX_RETURNED_ROWS | No | Rows returned to the agent per query; max 100000. | 1000 |
| LAGAAM_MAX_INTERMEDIATE_ROWS | No | Rows the engine would build at its widest step. | 50000000 |
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
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_catalogsA | List every catalog, schema, and table you are allowed to query. Call this first to ground yourself before describing tables or writing SQL — table names you have not seen here are guesses. |
| describe_tableA | Get the exact columns and types of one table. Read-only. |
| query_dataA | Run a read-only SELECT and get the rows back. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 3 tools
Each tool targets a distinct step in the metadata-to-query workflow: catalog discovery, table introspection, and query execution. The descriptions explicitly state the intended ordering and cross-reference each other, leaving no realistic chance of misselection.
All three names follow a uniform snake_case verb_noun pattern (list_catalogs, describe_table, query_data). The verbs are accurate and non-overlapping.
Three tools is lean but each is essential to the read-only query lifecycle, so nothing is redundant. It sits at the low end of the comfortable range, with no room for auxiliary operations like budget or explain previews.
Discover-schema, describe-table, and run-SELECT cover the core read-only workflow end to end, including safety refusals and row caps. Minor gaps exist — no way to preview query cost/budget or search schema objects by name — but agents can work around them.