FOAF
Vyhľadávanie ⌘K
Model Context Protocol

Dokumentácia MCP.

Nástroje, postupy a plány.

MCP server foaf.sk sprístupňuje slovenské firemné, finančné, katastrálne a registerové údaje priamo v AI chate. Táto stránka popisuje, ako sa pripojiť, aké postupy asistent typicky používa a ktorý plán FOAF odomkne ktorú kategóriu nástrojov.

Späť na pripojenie foaf.sk · Inštalácia krok za krokom

Obsah

  1. Ako sa pripojiť
  2. Typické postupy
  3. IČO, establishment a same_ico
  4. Skupiny nástrojov podľa domény
  5. Plány a dostupnosť nástrojov
  6. Cenník a ďalšie odkazy

Ako sa pripojiť

foaf.sk MCP funguje v Claude a ChatGPT. Vo vašej aplikácii pridáte vlastný konektor s adresou servera https://mcp.foaf.sk/mcp a prihlásite sa cez Huglo svojím účtom foaf.sk — rovnako ako na webe.

Podrobný návod s krokmi pre každú aplikáciu nájdete na stránke Pripojenie za minútu. Po pripojení sa nástroje foaf.sk objavia v chate; asistent si ich volí sám podľa vašej otázky.

Čo budete potrebovať

  • Účet foaf.sk (Huglo) — bez prihlásenia MCP nefunguje.
  • Plán FOAF podľa toho, aké dáta chcete cez MCP získať (pozri tabuľku nižšie).

Typické postupy

Asistent volá viacero nástrojov za sebou. Nižšie sú dva bežné reťazce — nemusíte poznať názvy nástrojov; stačí otázka v prirodzenom jazyku.

Kontrola firmy (vyhľadanie → profil → detail)

  1. Vyhľadanie podľa názvu alebo IČO — nájde kandidátov a vráti IČO (a prípadne same_ico).
  2. Snapshot firmy — základný profil: názov, sídlo, štatutári, NACE, príznaky.
  3. Voliteľné rozšírenia — podľa otázky: dlhy a exekúcie, účtovné závierky, súdne rozhodnutia, zmluvy so štátom, Foaf skóre a pod.

Príklad otázky: „Je Stavmont s.r.o. spoľahlivý partner na zmluvu za 180 000 €?“

Adresa a kataster

  1. Nájdenie adresy — normalizuje zadanú adresu na registerový tvar.
  2. Informácie o adrese — údaje z registrov viazané na adresu, prípadne firmy na adrese.
  3. Kataster — parcely, vlastníctvo, záložné práva; vyhľadanie podľa adresy, IČO alebo názvu.

Príklad otázky: „Ktoré nehnuteľnosti vlastní táto firma a je na nich záložné právo?“

IČO, establishment a same_ico

Firmu vždy identifikujte podľa IČO. Väčšina nástrojov pracuje s parametrom ico.

Pri jednom IČO môže existovať viac právnych subjektov (napríklad po transformácii alebo zániku a opätovnom vzniku). API preto môže vrátiť pole same_ico — zoznam ďalších subjektov s rovnakým IČO, každý s vlastným dátumom vzniku.

Parameter establishment je dátum a čas vzniku konkrétneho subjektu vo formáte ISO 8601 (napr. 2020-01-15T00:00:00.000Z). Ak odpoveď obsahuje same_ico alebo chcete jednoznačne určiť, o ktorú entitu ide, preneste establishment z predchádzajúcej odpovede do ďalších volaní (financie, dlhy, kataster…). Bez správneho establishment môže API vrátiť iný subjekt alebo chybu 404.

Praktické pravidlo pre asistenta

  1. Najprv vyhľadajte firmu a prečítajte establishment aj same_ico.
  2. Ak je same_ico neprázdne, spýtajte sa používateľa, o ktorý subjekt ide, alebo vyberte podľa dátumu vzniku z kontextu.
  3. Pri každom ďalšom nástroji s rovnakým IČO posielajte rovnaké establishment.

Skupiny nástrojov podľa domény

Názvy nástrojov v MCP sú anglické (napr. search-company); v chate stačí otázka po slovensky. Pre prehľad sú zoskupené podľa oblasti dát.

Doména Čo získate Príklady nástrojov
Vyhľadávanie firiem Hľadanie podľa názvu, IČO alebo DIČ; základný profil firmy; Foaf skóre a DPH prehľady. search-company, get-company-info-by-ico, get-company-reliability
Financie Dlhy voči štátu, účtovné závierky, agregované ukazovatele, porovnanie s odvetvím. get-company-debts-by-ico, get-company-financial-by-ico, get-financial-aggregate-nace-stats
Adresy Normalizácia adresy, detail adresy, firmy registrované na adrese. find-address, get-address-information, get-companies-by-address
Kataster Parcely a listy vlastníctva, záložné práva, vyhľadanie podľa IČO, názvu alebo adresy. search-cadastry-by-ico, get-cadastry-information, get-cadastry-encumbrances
Súdy a insolvencia Súdne rozhodnutia, exekúcie, konkurzy a reštrukturalizácie (REPLIK), záložné práva. get-company-rozhodnutia-by-ico, get-company-exekucie-by-ico, get-company-replik-by-ico
Zmluvy a register partnerov Zmluvy so štátom (CRZ), zápisy v RPVS. get-company-crz-by-ico, get-company-rpvs-by-ico
Osoby a prepojenia Detail osoby alebo právnickej osoby, vyhľadanie firiem podľa osoby. get-person-by-key, search-company-by-person
PEPPOL a prehľady Certifikované organizácie PEPPOL, sprostredkovatelia, mesačné registerové prehľady. list-peppol-cert-organizations, get-monthly-summary

Platené nástroje pri nedostatočnom pláne vrátia chybovú správu s odkazom na cenník — ide o obmedzenie produktu, nie o chybu prihlásenia.

Plány a dostupnosť nástrojov

Dostupnosť nástrojov MCP kopíruje plány na foaf.sk. V cenníku sa plány volajú Zadarmo, Biznis a Kataster.

Kategória nástrojov Zadarmo Biznis Kataster
Vyhľadávanie firiem (základ, profil, Foaf skóre, DPH)
PEPPOL a mesačné prehľady
Financie (dlhy, závierky, rozšírené grafy, časová os) Obmedzené
Adresy a firmy na adrese —
Súdy, exekúcie, insolvencia, zmluvy so štátom —
Kataster (parcely, LV, záložné práva) — —

Plán Zadarmo umožňuje základné vyhľadávanie a obmedzený prístup cez MCP. Plný firemný rozsah (financie, súdy, adresy, osoby) vyžaduje plán Biznis. Katastrálne nástroje sú súčasťou plánu Kataster.

Cenník a ďalšie odkazy

Aktuálne ceny a detailné porovnanie funkcií nájdete v cenníku foaf.sk.

Potrebujete plný prístup?

MCP je súčasťou plánov Biznis a Kataster.

Pozrieť cenník