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_tableB | Get the exact columns and types of one table. Always describe a table before querying it; column names you have not seen here are guesses. |
| 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
The three tools map to clearly distinct stages of a data workflow: discovery (list_catalogs), schema introspection (describe_table), and execution (query_data). There is no overlap in purpose, and the descriptions actively steer the agent between them.
All three names follow the same snake_case verb_noun pattern (list_catalogs, describe_table, query_data). The convention is predictable and self-explanatory.
Three tools is exactly right for a read-only SQL access server — each earns its place with no redundancy. Adding more would only fragment the discover-describe-query workflow.
The surface fully covers the read-only lifecycle: explore, inspect schema, then query. Write operations are absent, but that is a deliberate scope choice rather than a gap, leaving only minor omissions such as metadata or sample-value helpers.