Skip to main content
Glama
Sign In
szkoly-mcp

szkoly-mcp

by ContentWriterco
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

Podłącz w 30 sekund

Adres MCP: https://szkoly.compabase.com/mcp (Streamable HTTP, bez logowania).

  • Claude: Ustawienia → Connectors → Add custom connector → wklej adres.

  • ChatGPT: Settings → Connectors (tryb deweloperski) → dodaj serwer MCP.

  • Claude Code: claude mcp add --transport http szkoly https://szkoly.compabase.com/mcp

  • Lokalnie (stdio): npx -y szkoly-mcp, np. w Claude Desktop:

{ "mcpServers": { "szkoly": { "command": "npx", "args": ["-y", "szkoly-mcp"] } } }

Related MCP server: PH Schools MCP Server

Co potrafi

Narzędzie

Do czego

find_schools

Szkoły albo przedszkola w miejscowości, gminie lub najbliżej adresu (z odległością): typ, publiczna/niepubliczna, specyfika (np. specjalna, sportowa), adres, liczba uczniów, strona www, numer RSPO i najnowsze wyniki egzaminu na tle Polski – egzamin ósmoklasisty dla podstawówek, zdawalność i średnie z matury dla liceów i techników. Sortowanie po odległości, wynikach albo nazwie; filtr „tylko publiczne”.

school_details

Jedna szkoła (po numerze RSPO albo nazwie): dane z rejestru, organ prowadzący, liczba uczniów i nauczycieli, wyniki z ostatnich 3 lat z każdego przedmiotu na tle powiatu i kraju – egzamin ósmoklasisty albo matura (zdawalność, przedmioty podstawowe i rozszerzone).

data_sources

Źródła, roczniki danych i zastrzeżenia.

Przykładowe pytania: „Jakie podstawówki są najbliżej ul. Garbary 10 w Poznaniu?”, „Najlepsze licea w Poznaniu wg matury”, „Porównaj SP 1 i SP 2 w Kórniku”, „Jakie przedszkola są w gminie Swarzędz?”, „Jak technikum w Bolesławcu wypada z matematyki na maturze?”.

Skąd dane

  • Wykaz szkół i placówek oświatowych – MEN, System Informacji Oświatowej (stan na 30 września), dane.gov.pl, CC BY 4.0: ok. 42 tys. szkół i przedszkoli z adresem, typem, organem prowadzącym, liczbą uczniów i nauczycieli.

  • Wyniki egzaminów – Centralna Komisja Egzaminacyjna, Mapa wyników egzaminów: egzamin ósmoklasisty i matura (formuła 2023) z ostatnich 3 lat, dla każdej szkoły (średnie pokazywane od 5 zdających). Średnie powiatu i kraju liczymy z wyników szkół (ważone liczbą zdających).

  • Odległości – adresy szkół geokodowane państwowym rejestrem adresów GUGiK.

  • Dane pobierają się przy pierwszym uruchomieniu (~35 MB plików źródłowych, zapisywane jako ~35 MB JSON w ~/.cache/szkoly-mcp) i są sprawdzane raz na dobę.

  • Zastrzeżenia: wynik egzaminu zależy w dużej mierze od tego, jacy uczniowie trafiają do szkoły, i nie mierzy wszystkiego, co w niej ważne. O przyjęciu do szkoły podstawowej decyduje obwód (rejon) ustalony przez gminę.

Własny serwer

npx -y szkoly-mcp --http --port 3000      # MCP: http://localhost:3000/mcp
npx -y szkoly-mcp find "Kórnik" --level podstawowa
npx -y szkoly-mcp school 70077

Zmienne: SZKOLY_DATA_DIR, SZKOLY_REFRESH_HOURS (24), SZKOLY_E8_YEARS / SZKOLY_MATURA_YEARS (3), SZKOLY_RATE_LIMIT, SZKOLY_STATS=1 (anonimowe liczniki pod /stats), SZKOLY_CONTACT, SZKOLY_PUBLIC_URL.

Licencja

Kod: MIT. Dane: MEN (SIO, dane.gov.pl, CC BY 4.0), CKE (Mapa wyników egzaminów), GUGiK – dane przetworzone. Projekt niezależny, hostowany pro publico bono przez Compabase. Zobacz też rozkład-mcp, ceny-nieruchomosci-mcp, leki-mcp i powietrze-mcp.

English

szkoly-mcp gives AI assistants the official register of Polish schools and kindergartens (Ministry of Education, SIO) with pupils, teachers and addresses, plus per-school exam results – the eighth-grade exam (egzamin ósmoklasisty) and the matura – for the last three years by subject, compared with county and national averages. Find schools in a town, gmina or near an address (with distances). Public endpoint: https://szkoly.compabase.com/mcp (no key), or run locally with npx -y szkoly-mcp.

Available Tools

3 tools
data_sourcesData sourcesC
Read-only
Inspect

Where the data comes from and caveats.

Inputs: no named parameters.

find_schoolsFind schools and kindergartens (Poland)A
Read-only
Inspect

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'.

Inputs: place (required), max, sort, level, +2 more.

school_detailsSchool details and exam results (Poland)A
Read-only
Inspect

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.

Inputs: school (required), town.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    B3.3/5.0

    Scored across 3 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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.

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Skolverket MCP Server

      isakskogstad
      A
      license
      A
      quality
      D
      maintenance
      Enables LLMs to access Swedish educational data through Skolverket's open APIs, allowing users to search curricula, courses, schools, adult education programs, and analyze educational requirements and standards. Provides comprehensive tools for teachers, students, guidance counselors, and educational researchers to interact with official Swedish education data.
      27
      13
      MIT

    • PH Schools MCP Server

      darwinphi
      A
      license
      A
      quality
      D
      maintenance
      Enables querying and analyzing the Philippine schools masterlist dataset, including searching schools, listing regions and divisions, and getting school details by BEIS ID.
      5
      75 npm
      ISC

    • schooldigger-mcp

      pajaydev
      A
      license
      Not graded
      quality
      D
      maintenance
      Integrates with SchoolDigger's API to search schools, get rankings, and find districts by location. Enables querying school data through natural language.
      1
      MIT

    • regon-mcp

      SmartMobileHouse
      A
      license
      A
      quality
      C
      maintenance
      Provides clean, typed access to the Polish REGON business register (GUS BIR1), enabling AI assistants to look up companies by NIP, REGON, or KRS and retrieve structured data like name, address, and legal form.
      6
      1
      MIT