szkoly-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SZKOLY_STATS | No | Set to 1 to enable anonymous counters exposed under /stats. | |
| SZKOLY_CONTACT | No | Contact information sent with requests. | |
| SZKOLY_DATA_DIR | No | Directory where the source data is downloaded and cached as JSON (default is ~/.cache/szkoly-mcp). | |
| SZKOLY_E8_YEARS | No | Number of years of eighth-grade exam (egzamin ósmoklasisty) results to include. Default is 3. | 3 |
| SZKOLY_PUBLIC_URL | No | Public URL of the server. | |
| SZKOLY_RATE_LIMIT | No | Rate limit applied to the server. | |
| SZKOLY_MATURA_YEARS | No | Number of years of matura results to include. Default is 3. | 3 |
| SZKOLY_REFRESH_HOURS | No | How often (in hours) the downloaded data is refreshed/checked. Default is 24. | 24 |
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": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| find_schoolsA | Schools or kindergartens in a Polish town / gmina or near an address: type, public or non-public, address, number of pupils, RSPO id, website and the latest exam results (eighth-grade exam for primary schools, matura pass rate and averages for licea/technika) vs the national average. place: town "Kórnik", gmina, address "Kraków, Długa 5" (sorted by distance) or 'lat,lon'. |
| school_detailsA | One school: register data (type, address, governing body, pupils, teachers, pupils per teacher) and exam results for the last years by subject – eighth-grade exam or matura (pass rate, basic and extended subjects) – compared with the county and national averages. school: RSPO number or name; town helps to disambiguate. |
| data_sourcesC | Where the data comes from and caveats. |
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
find_schools is clearly a search/list operation, school_details retrieves a single school's full profile, and data_sources provides provenance information. The three purposes are distinct with no meaningful overlap.
All names use consistent snake_case, but the pattern is mixed: find_schools uses a verb_noun form while school_details and data_sources are noun phrases. The deviation is minor and still readable.
Three tools are well-scoped for a focused school-search server: search, detail lookup, and data provenance. Each tool has a clear reason to exist, and the surface is not thin or bloated.
The core lifecycle—find schools with filters, inspect a specific school's detailed exam results, and check data caveats—is covered. Minor gaps like bulk listing or explicit town/gmina enumeration are not critical for the stated purpose.