Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

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": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_subjectsA

Browse or search GUS BDL subject categories (top-level topics like 'CENY', 'LUDNOŚĆ', 'FINANSE PRZEDSIĘBIORSTW'). Use to discover subject IDs which then anchor variable searches.

search_variablesA

Search for variables (data series) in GUS BDL. Variables are the atomic units of statistical data — each has an ID used with get_data. Filter by subject_id (from search_subjects) and/or name.

search_unitsA

Search for territorial units by name — voivodeships, powiats, gminas. Returns unit IDs used with get_data. Level meanings: 0=Kraj (country), 2=Województwo, 5=Powiat, 6=Gmina.

get_unit_detailsB

Get full details of a territorial unit by ID.

get_dataA

Get actual data (time series) for a variable in one or more territorial units. Example: GDP per capita for all voivodeships over 2015-2024. Returns the raw values with year, unit, and unit label.

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 5 tools

Disambiguation5/5

Each tool targets a clearly distinct entity or action: subjects, variables, units, unit details, and data. The descriptions cross-reference IDs and usage patterns, making it easy for an agent to select the right tool.

Naming Consistency5/5

Tool names follow a consistent verb_noun pattern: search_subjects, search_variables, search_units, get_unit_details, get_data. All use lowercase snake_case and the prefixes search_ and get_ clearly distinguish discovery from retrieval.

Tool Count5/5

Five tools is well-scoped for a statistical data access server. Each tool covers a necessary part of the browsing and data retrieval workflow without unnecessary or redundant additions.

Completeness4/5

The core workflow is complete: discover subjects, search variables, locate territorial units, get unit details, and fetch data. Minor gaps exist such as detailed variable metadata or subject detail endpoints, but they are not essential for typical data retrieval.

Maintenance

ActivityMaintained
ResponsivenessNo issues