Skip to main content
Glama

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

Related MCP server: mcp-rosreestr

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

Available Tools

11 tools
kataster_kuA

Find a cadastral unit (katastrálne územie, k.ú.) by name or code.

Returns [{kod, nazov, obec, obec_kod, okres, lat, lon}]; lat/lon is a point inside the unit. Municipality (obec) and district (okres) tell apart units with the same name (128 names repeat). Works offline from a bundled list.

Inputs: query (required).

kataster_lvA

URL of the LV extract (výpis z LV) on the ESKN portal and a guide (navod) for the user.

Makes no network request. The portal shows a reCAPTCHA ('Nie som robot') that only the user may solve; this tool never bypasses it. The extract is the only public source of encumbrances (ťarchy, časť C), administrators and tenants. The guide explains LV preview vs. extract vs. official extract (eID, paid); walk the user through it one step at a time.

Inputs: ku (required), lv (required), format, parcely.

kataster_lv_importA

Read LV extracts (výpis z LV, HTML or PDF) and LV previews (Náhľad LV, HTML) saved from the browser.

One file: returns the parsed LV: header (district, municipality, k.ú., date of data), part A (parcels with area, land type, location; codes translated by the legend; buildings in stavby with súpisné číslo, the parcel under the building, kind and the LV of the land), part B (owners with shares, acquisition titles, notes; administrators and tenants) and part C (encumbrances, ťarchy). A block of flats lists its units in jednotky (flat or non-residential premises, entrance, floor, share of the common parts) and each owner of a unit carries jednotka. zdroj_typ tells the input: vypis_lv_html, vypis_lv_pdf or nahlad_lv (the preview has no administrators/tenants section). A folder or several paths: a summary per LV (the same LV twice is merged: newer data, extract before preview), unreadable files are listed in varovania. Makes no network request. Results are kept in the local personal-data cache for 7 days (owner-only permissions on POSIX); kataster_osoba_prehlad reads them.

Inputs: html, path, paths.

kataster_mapaA

Draw parcels on a map and save files. Returns the file paths.

PNG is rendered on the server (background from official WMS, outlines, labels, scale bar, attribution). HTML is an interactive Leaflet map with the same background embedded and, when the parcels lie apart, a sharp crop (vyrezy) per cluster of near parcels above it, so zooming in stays readable; each crop costs one request per background source (podklad_dotazy). GeoJSON/KML contain only geometry and public attributes (no owners).

Inputs: parcely (required), nazov, format, out_dir, +2 more.

kataster_osoba_navodA

Guide (navod) for finding the parcels of a person in ONE k.ú. in the official ESKN search, by the user.

The server never searches by person and makes no network request here: the user searches in the browser (the portal's invisible CAPTCHA lets a person through), opens the LV previews, saves them into one folder, then kataster_lv_import reads the folder and kataster_osoba_prehlad builds the overview. The search is per k.ú., not per municipality: a town can have several k.ú. (ine_ku_obce) and a property "in village X" can lie in a neighbouring village's k.ú.; repeat the guide for every k.ú. that matters. Walk the user through the steps ONE AT A TIME (wait until a step is done), do not paste the whole list.

Inputs: ku (required), ico, typ, meno, +2 more.

kataster_osoba_prehladA

Overview of a person's parcels from LVs imported with kataster_lv_import (no network request).

Per LV: k.ú., parcels (register, number, area, land type), buildings (súpisné číslo, the parcel under it, kind; lv_pozemku = the LV of the land when it is elsewhere), the person's share, the area by share, how many other co-owners (count only); bsm = joint property of spouses (the share belongs to both). Totals per person. Without a date of birth, people with the same name are listed separately. Imports are kept 7 days; when LVs are missing or expired, call kataster_lv_import again on the same folder. Not an LV extract and not the office's súpis nehnuteľností.

Inputs: ku, ico, meno, nazov, +2 more.

kataster_parcelaA

Parcel (parcela) geometry from the official INSPIRE WFS of ÚGKK SR.

Give either ku + cislo, or lat + lon (returns every C and E parcel at that point). Returns register, number, area in m² (výmera), reference point (referencny_bod, a point guaranteed inside the parcel), bbox and optionally the polygon. No owners here.

Inputs: ku, lat, lon, cislo, +2 more.

kataster_skupinaA

Analyse a group of parcels from official geometry (no owners).

Returns each parcel's area, the total, which group parcels share a boundary with each other (length in m), whether the group is one contiguous block, the nearest reference parcel with distance in m, and optionally all neighbouring parcels.

Inputs: parcely (required), susedia, referencne.

kataster_statusA

Server status: access policy, today's owners quota, cache contents and parser versions.

Inputs: no named parameters.

kataster_vlastniciA

Owners and shares (vlastníci a podiely) of ONE parcel, with the LV number (list vlastníctva).

Source: the unofficial ESKN portal parcel detail, queried at human pace with a daily limit on parcels. Returns LV number, land type (druh pozemku), location in/outside the built-up area, legal relation, owners (name, birth date, address, share), buildings on the parcel (stavby: house number only; a building may be on another LV than the land) and the data date (stav_k). With detail_stavieb=true also stavby_detail: per building its LV, kind, description, C parcels under it and owners with shares (a block of flats: unit owners are not returned); stavby_dotazy = queries spent. Personal data: use only for the parcel the user asked about; never walk parcels to find a person (for a person's parcels use kataster_osoba_navod). On CAPTCHA, a block or the daily limit the error carries a guide (navod) for doing the same in the browser.

Inputs: ku (required), cislo (required), obnovit, register, +2 more.

kataster_vrstvyA

Thematic layers for a parcel (whole polygon, with area shares) or a point.

  • bpej: soil-ecological units (BPEJ) with quality group (skupina kvality), points, protected soil, levies for taking farmland (odvod za záber) — VÚPOP

  • hodnota: official land value €/m² for land consolidation (vyhl. 38/2005), not a market price — VÚPOP

  • lpis: farm blocks (diel pôdneho bloku, LPIS) and land use — VÚPOP

  • uzivatel: who farms the land per subsidy applications (name, IČO, year) — NLC

  • zaplavy: flood hazard extent Q10/Q100/Q1000 and depth class — SVP

  • ochrana: Natura 2000 (CHVÚ, ÚEV), protected areas and degree of protection — ŠOP SR

  • vyska: elevation at the reference point (DMR 5.0) — ÚGKK

  • zastavane_uzemie: parcel inside or outside the built-up area of the municipality — cadastral map WMS of ÚGKK (register C, official) or ESKN identify (register E, unofficial)

  • tarchy: whether a drawn encumbrance (ťarcha) line crosses the parcel, with internal ids; an unofficial estimate from the rendered cadastral map, parcels only (not points); content only in the LV (kataster_lv)

  • pozemkove_upravy: land consolidation projects (in progress / finished, complex / simple) in the parcel's cadastral unit, with years and project area — MPRV SR open data; parcels only; says nothing about whether the parcel lies inside the project boundary

  • les: forest management units (JPRL: compartment, stand group, forest category hospodársky / ochranný / osobitného určenia, forest unit, management plan validity) and forest types, with area shares — NLC; no forest owner or manager

  • siete: access and line objects — nearest ZBGIS road (type, surface, distance; adjacent if <= 3 m) and roads, railways and power lines (voltage) crossing the parcel or within 50 m, with distance and length on the parcel — ZBGIS of GKÚ; parcels only; protection zones are not computed (warning only)

  • sklon: terrain slope of the parcel (mean, max, 95th percentile in % and degrees), prevailing exposure (S, SV, V, JV, J, JZ, Z, SZ = N, NE, E, SE, S, SW, W, NW, or rovina = flat), min/max height and difference — DMR 5.0 1 m grid of ÚGKK (INSPIRE WCS); parcels only A failing layer does not fail the others; it carries its own chyba.

Inputs: ku, lat, lon, cislo, +2 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 11 tools

    Disambiguation4/5

    Most tools have distinct resource+action purposes (geometry, owners, layers, map, group analysis). The four-tool LV/person family (kataster_lv, kataster_lv_import, kataster_osoba_navod, kataster_osoba_prehlad) and kataster_vlastnici vs kataster_lv could be momentarily confused, but descriptions tightly scope each (URL+guide vs file parsing vs step-by-step guidance vs aggregated overview vs per-parcel owners).

    Naming Consistency5/5

    Every tool follows the same kataster_<noun> snake_case pattern, with nested variants (kataster_lv_import, kataster_osoba_navod) staying readable and predictable. No camelCase or verb-style mixing; the noun-based convention is used uniformly.

    Tool Count5/5

    11 tools is well within the ideal 3-15 range for a rich cadastral domain. Each tool earns its place: geometry, owners, thematic layers, maps, LV handling, person workflow, unit lookup, group analysis and status are all non-redundant.

    Completeness4/5

    Core CRUD-like lifecycle for cadastral queries is well covered: k.ú. lookup, parcel geometry, owners, thematic layers, LV access/import, person overview, group analysis and map export. Gaps are minor and partly deliberate (no owner-based search by design, no address-to-parcel lookup, no plain 'list parcels in k.ú.'), which agents can work around.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Read-only MCP server providing direct, credentialed access to parcel data via Regrid and county ArcGIS sources, with tools for querying by point, owner, size, and county.
      -
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for the Spanish Cadastre, enabling local queries of official INSPIRE parcel data (area, geometry, neighboring parcels, searches) and online queries to the OVC and electronic headquarters for additional details, with rate limiting and caching.
      10
      17 npm
      1
      MIT