Skip to main content

kataster-mcp

MCP server pre kataster nehnuteľností Slovenskej republiky. Umožňuje AI asistentovi alebo jazykovému modelu v ľubovoľnom klientovi s podporou Model Context Protocol zistiť o konkrétnom pozemku čo najviac z verejných zdrojov: hranice a výmeru parcely, list vlastníctva a vlastníkov, bonitu pôdy, úradnú hodnotu, LPIS, záplavové územia, ochranu prírody, les, sklon terénu, siete a mapu.

English: an MCP server for the Slovak land registry. An English README is in preparation.

Údaje majú informatívny charakter. Nie sú výpisom z listu vlastníctva a nedajú sa použiť na právne úkony.

Čo vie

Nástroj Čo vráti
kataster_ku katastrálne územie podľa názvu alebo kódu (obec, okres)
kataster_parcela parcelu registra C alebo E podľa čísla alebo súradníc: výmera, hranica, referenčný bod
kataster_vlastnici vlastníkov a podiely jednej zadanej parcely a číslo listu vlastníctva; na požiadanie (detail_stavieb) aj detail stavby na nej: LV stavby, druh a vlastníkov (každá stavba je ďalší dotaz do denného limitu; pri bytovom dome vlastníkov bytov nevracia, namiesto toho navedie, ako si uložiť a naimportovať list vlastníctva domu)
kataster_vrstvy tematické údaje o parcele (zoznam nižšie), pri plošných vrstvách aj podiel na výmere
kataster_skupina rozbor viacerých parciel: celková výmera, spoločné hranice, súvislé celky, susedia
kataster_mapa mapu parcely ako PNG, HTML (Leaflet), GeoJSON alebo KML, bez osobných údajov
kataster_lv odkaz na výpis z listu vlastníctva na portáli ESKN (výpis si otvoríte sami)
kataster_osoba_navod postup krok za krokom, ako si v oficiálnom vyhľadávaní portálu ESKN nájsť listy vlastníctva osoby a uložiť ich náhľady (server pri tom na portál nevolá)
kataster_lv_import načítanie výpisu LV alebo náhľadu LV, ktorý ste si uložili (HTML alebo PDF); aj celý priečinok naraz; pri bytovom dome načíta aj byty a nebytové priestory s vchodom, poschodím, podielom a vlastníkmi
kataster_osoba_prehlad prehľad parciel a podielov jednej osoby zložený z náhľadov LV, ktoré ste si uložili; bez dotazu na portál
kataster_status verziu, limity a dnešné využitie kvóty

Vrstvy v kataster_vrstvy: bonitovaná pôdnoekologická jednotka (BPEJ), úradná hodnota pôdy, LPIS, užívateľ pôdy, záplavy, chránené územia, nadmorská výška, sklon terénu, zastavané územie obce, zakreslené ťarchy, pozemkové úpravy v katastrálnom území, les a siete (cesty, železnice, elektrické vedenia).

Každá odpoveď uvádza zdroj, čas a to, či údaj prišiel z lokálnej cache. Neoficiálne rozhrania sú označené.

Čo zámerne nerobí

  • Sám nehľadá podľa osoby. Vlastníkov zistí len pre parcelu, ktorú zadáte. Ak chcete parcely konkrétnej osoby, vyhľadáte ju sami v oficiálnom vyhľadávaní portálu ESKN („Fyzické osoby“), server vás tým prevedie a uložené náhľady listov vlastníctva potom načíta a zloží do prehľadu.
  • Nenahrádza súpis nehnuteľností podľa § 69 ods. 9 zákona č. 162/1995 Z. z., ktorý vydáva úrad len samotnej osobe. Prehľad zložený z náhľadov je informatívny.
  • Neprechádza celé katastrálne územia kvôli vlastníkom.
  • Neobchádza CAPTCHA. Keď portál CAPTCHA vyžiada, alebo keď je denná kvóta vyčerpaná, server vám poradí presný ručný postup v prehliadači a uložený výpis či náhľad potom načíta.
  • Nezaťažuje portál. Medzi dotazmi na kataster.skgeodesy.sk čaká aspoň 3 sekundy a nikdy sa nepýta paralelne. Vlastníkov zistí najviac pre 50 parciel denne. Limity platia spoločne pre všetky spustené procesy (viac MCP klientov aj príkazový riadok) a nedajú sa vypnúť nastavením ani zmenou dátového adresára.

Inštalácia

Potrebujete uv (Linux, macOS aj Windows). Server sa spúšťa ako lokálny proces cez stdio, takže ho pridáte do každého MCP klienta rovnako: príkaz uvx s argumentom kataster-mcp. Väčšina klientov to zapisuje do JSON konfigurácie v tomto tvare (presné miesto a názov kľúča nájdete v dokumentácii svojho klienta):

{
  "mcpServers": {
    "kataster": {
      "command": "uvx",
      "args": ["kataster-mcp"]
    }
  }
}

Napríklad v Claude Code jedným príkazom:

claude mcp add kataster -- uvx kataster-mcp

Vývojovú verziu priamo z GitHubu spustíte cez uvx --from git+https://github.com/braklo/kataster-mcp kataster-mcp.

Potom sa stačí opýtať, napríklad: „Čo je za pozemok E 503 v katastrálnom území Vyšný Kubín a kto ho vlastní?“

Príkazový riadok

Balík obsahuje aj príkaz sk-kataster. Bez inštalácie ho spustíte cez uvx --from kataster-mcp sk-kataster, natrvalo ho nainštaluje uv tool install kataster-mcp. Výstup je JSON.

sk-kataster doctor
sk-kataster ku resolve 'Vyšný Kubín'
sk-kataster lv inspect ~/Stiahnuté/vypis.html
sk-kataster lv import ~/Stiahnuté/vypis.html
sk-kataster person overview --surname Novák --first-name Ján
sk-kataster tools
sk-kataster call kataster_parcela '{"ku": "Vyšný Kubín", "cislo": "E 503"}'

doctor ukáže verziu, adresáre a dnešné využitie kvóty. ku, lv url, lv inspect, lv import a person overview na portál nevolajú, lv inspect ani lv import --dry-run nič neukladajú. Výpis LV vracajú predvolene v súhrne; parcely a vlastníkov pridá --full. tools vypíše nástroje servera a call jeden z nich spustí. Ak nástroj ide na portál, platí rovnaká pauza a denný limit ako pre MCP server.

Dátový adresár (cache a uložené LV) presuniete premennou KATASTER_DATA_DIR, v príkazovom riadku aj voľbou --data-dir. Stav limitov zostáva na pevnom mieste.

Pre AI klientov, ktorí pracujú cez príkazový riadok, je v repozitári voliteľný návod skills/kataster/SKILL.md.

Osobné údaje

Mená, dátumy narodenia a adresy vlastníkov sa ukladajú len lokálne, do súboru osoby.sqlite v dátovom adresári servera, a po 7 dňoch sa pri ďalšom dotaze načítajú znova. Dátový adresár (presnú cestu vypíše kataster_status):

Systém Adresár Ochrana
Linux ~/.local/share/kataster-mcp (alebo $XDG_DATA_HOME/kataster-mcp) práva 0700 / 0600
macOS ~/Library/Application Support/kataster-mcp práva 0700 / 0600
Windows %LOCALAPPDATA%\kataster-mcp prístup len pre používateľa (predvolené nastavenie Windows)

Premenná KATASTER_DATA_DIR má prednosť pred týmito umiestneniami na všetkých troch systémoch a platí pre MCP server aj príkazový riadok.

Denný limit dotazov na vlastníkov, pauza medzi dotazmi a blokácia po CAPTCHA sa evidujú zvlášť, v pevnom adresári, ktorý nemení žiadna premenná prostredia ani presun dátového adresára (presnú cestu vypíše kataster_status ako limity_dir):

Systém Adresár limitov Ochrana
Linux ~/.local/state/kataster-mcp práva 0700 / 0600
macOS ~/Library/Application Support/kataster-mcp-limits práva 0700 / 0600
Windows %USERPROFILE%\AppData\Local\kataster-mcp-limits prístup len pre používateľa (predvolené nastavenie Windows)

Server ich neposiela nikam inam než do odpovede vášmu AI asistentovi; ak model beží v cloude, dostane ich aj jeho poskytovateľ. Za to, ako ich použijete, zodpovedáte vy (GDPR, katastrálny zákon).

Zdroje dát

Úrad geodézie, kartografie a katastra SR (INSPIRE, ESKN, ZBGIS, výškový model), Výskumný ústav pôdoznalectva a ochrany pôdy, Národné lesnícke centrum, Ministerstvo pôdohospodárstva a rozvoja vidieka SR, Slovenský vodohospodársky podnik, Štátna ochrana prírody SR. Podmienky ich použitia platia aj pri použití cez tento server; zdroj uvádzajte.

Stav

Otestované s Claude Code na Linuxe. Na Windows a macOS prechádzajú automatické testy, v bežnom používaní to zatiaľ overené nie je; skúsenosti uvítame v issues.

Chyby a návrhy

Issues, po slovensky aj po anglicky. Do issue nedávajte mená vlastníkov ani výpisy z listu vlastníctva.

Licencia

Kód: MIT. Licencia kódu sa nevzťahuje na údaje, ktoré server sprostredkúva.

Metadata

Release files for kataster-mcp 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kataster-mcp 0.3.1
File Size Uploaded Provenance Actions
kataster_mcp-0.3.1.tar.gz 313.1 kB With provenance Details for kataster_mcp-0.3.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for kataster-mcp 0.3.1
File Interpreter ABI Platform Actions
kataster_mcp-0.3.1-py3-none-any.whl Python 3 none any Details for kataster_mcp-0.3.1-py3-none-any.whl

Total release size: 503.8 kB

Release files / kataster_mcp-0.3.1.tar.gz

Download URL kataster_mcp-0.3.1.tar.gz
Size 313.1 kB
Tags Source
SHA-256 checksum
How to use checksums
3ae78f0ebbc37e5c3f2906585138d899cd6a98df784423fa66a4756b82c7a382
BLAKE2b-256 checksum
How to use checksums
5e27795a53b15d9ddbd41fd5c5668446235c0e0809c98fdcfeaf6251db61b908
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Release files / kataster_mcp-0.3.1-py3-none-any.whl

Download URL kataster_mcp-0.3.1-py3-none-any.whl
Size 190.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
dc4d61f3a73504ae273861c3f0830ddc607c6a3d5329bb7ddbf057c2b93fc0ad
BLAKE2b-256 checksum
How to use checksums
671dcbbfba46a361fec26cee48c822c4ee0c4b50e2f17dbb3f97c67b40dd06ad
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

Security for kataster-mcp 0.3.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for kataster_mcp-0.3.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.3.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page