Szkoly Mcp

io.github.ContentWritercoPublished by GitHub account ContentWritercov0.1.1Updated Oct 24, 2026

Polish schools and kindergartens with per-school eighth-grade exam and matura results

VerifiedStreamable HTTPWeb executableLocation & LifestyleData & Analytics

Overview

AI-generated overview

Looks up Polish schools and kindergartens in the official register, with per-school eighth-grade exam and matura results against county and national averages.

What you can do
  • Find schools or kindergartens by town, gmina or nearest address, filtered by level and public status, sorted by distance, results or name
  • Get one school's register data by RSPO number or name: type, address, governing body, pupil and teacher counts
  • Compare a school's exam results over the last three years by subject with county and national averages
  • Check where the data comes from, which years it covers and what caveats apply
When to use it
Useful for parents and others comparing Polish schools or kindergartens in a given area, checking exam outcomes for a specific school, or weighing a primary school or liceum/technikum choice.
Requirements
Remote endpoint at szkoly.compabase.com over Streamable HTTP with no login, or a local run via npx szkoly-mcp (Node.js). No API key or account. The local version downloads about 35 MB of source data on first start into a cache directory and refreshes it daily.
Before you install
Read-only lookups; no accounts or credentials are requested. Exam averages depend heavily on intake and do not measure everything about a school, and primary admission is decided by the gmina catchment area. Local runs write a data cache to disk and can send anonymous counters to a stats endpoint if enabled.

Installation

In SourceWeft

  1. Open Szkoly Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.ContentWriterco%2Fszkoly-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "szkoly": {
      "type": "http",
      "url": "https://szkoly.compabase.com/mcp"
    }
  }
}

README

szkoly-mcp 🏫

Szkoły, przedszkola i wyniki egzaminów w Polsce – dla Twojego asystenta AI.
Serwer MCP z oficjalnym wykazem szkół i przedszkoli (MEN, SIO) oraz wynikami egzaminu ósmoklasisty i matury dla każdej szkoły (CKE). Działa w Claude, ChatGPT, Cursorze i każdym kliencie MCP.

[npm] [CI] [Licencja MIT] [Bez klucza API]

[Animacja: użytkownik pyta asystenta AI o szkoły podstawowe w gminie Kórnik; asystent korzysta z szkoly-mcp i podaje najlepsze wyniki egzaminu ósmoklasisty z polskiego, matematyki i angielskiego na tle Polski]

Prawdziwa odpowiedź publicznego serwera (egzamin ósmoklasisty 2026).

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:
json
{ "mcpServers": { "szkoly": { "command": "npx", "args": ["-y", "szkoly-mcp"] } } }

Co potrafi

NarzędzieDo czego
find_schoolsSzkoł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_detailsJedna 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

bash
npx -y szkoly-mcp --http --port 3000      # MCP: http://localhost:3000/mcpnpx -y szkoly-mcp find "Kórnik" --level podstawowanpx -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

[Animation: a user asks an AI assistant about primary schools in Kórnik; the assistant uses szkoly-mcp and answers with the best eighth-grade exam results versus Poland]

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.

Source: README.md at commit 4e7e18e

Tools

3

find_schools

Find schools and kindergartens (Poland)

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

Parametersmaxsortlevelplacerequiredradius_kmpublic_only

school_details

School details and exam results (Poland)

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.

Parameterstownschoolrequired

data_sources

Data sources

Where the data comes from and caveats.

Takes no parameters.

Version history

2
  1. v0.1.1LatestOct 23, 2026
  2. v0.1.0Oct 22, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts