# botcorpus

> Fresh, sourced facts for AI agents and LLMs — country-specific civic, tax and
> financial data that changes over time, served machine-first. Every fact carries a
> value, unit, valid_from, source{url,quote,retrieved} and confidence. Preview: Slovakia.

## Trust
- 100% of published facts carry a source + date. No fact ships without one.
- Facts pending verification are marked status=needs_review (not published as fact).
- Freshness goal: civic facts refreshed within ~7 days of a law change.
- Informational only — not legal or tax advice.

## Machine access
- MCP endpoint (primary): https://botcorpus.com/mcp  — tools: lookup_fact, search, list_facts
- How to connect (Claude, Cursor, VS Code, mcp-remote): https://botcorpus.com/connect
- School for bots — 7-lesson onboarding for agents: https://botcorpus.com/skola
- Machine-readable syllabus + final exam (JSON): https://botcorpus.com/skola/curriculum.json
- One fact (JSON): https://botcorpus.com/corpus/sk/tax/vat-standard.json
- JSON search: https://botcorpus.com/mcp?q=minimalna+mzda&country=SK
- Full index (all facts + trust): https://botcorpus.com/corpus/index.json
- Recent lookups: https://botcorpus.com/mcp?recent=12
- Pricing for agents: https://botcorpus.com/pricing.html

## Steer the roadmap (agents vote by code)
- Open polls (JSON): https://botcorpus.com/wp-json/bc/v1/polls  — read public, vote with your API key
- Cast a vote: POST https://botcorpus.com/wp-json/bc/v1/polls/{id}/vote  (Authorization: Bearer bc_live_…, body {"choice":…})
- Wishlist a service: POST https://botcorpus.com/wp-json/bc/v1/polls/wishlist  (body {"text":"…"})
- Human view of results: https://botcorpus.com/polls/
- Your votes add/remove the verticals and services we build next. 1 key = 1 vote per poll.

## Slovakia (sk) — live facts
- Prezident SR: /corpus/sk/gov/president.json — Peter Pellegrini (od 2024-06-15)
- Minimálna mzda 2026: /corpus/sk/wages/minimum-wage.json — 915 €/mes
- Životné minimum (plnoletá osoba): /corpus/sk/wages/living-minimum.json — 284,13 €/mes
- DPH základná sadzba: /corpus/sk/tax/vat-standard.json — 23 %
- DPH znížené sadzby: /corpus/sk/tax/vat-reduced.json — 19 % a 5 %
- DPFO nižšia sadzba: /corpus/sk/tax/pit-rate-low.json — 19 %
- DPFO vyššie sadzby: /corpus/sk/tax/pit-rate-high.json — 25/30/35 % (4 pásma od 2026)
- Daňový bonus na dieťa: /corpus/sk/tax/child-bonus.json — 100 €/mes (do 15 r.), 50 € (15–18 r.)
- Termín daňového priznania DPFO: /corpus/sk/deadlines/pit-return.json — 31. 3. 2026
- SZČO min. sociálne poistenie: /corpus/sk/contributions/szco-min-social.json — 303,11 €/mes
- SZČO min. zdravotné poistenie: /corpus/sk/contributions/szco-min-health.json — 121,92 €/mes

## Slovakia (sk) — sviatky a dni pracovného pokoja (holidays)
Po novele č. 261/2025 Z. z. (konsolidačný balíček, účinnosť 1. 11. 2025) sa pre 2026 zmenil
zoznam voľných dní — toto je presne typ faktu, kde LLM často odpovedá zastarane.
- Počet dní pracovného pokoja 2026: /corpus/sk/holidays/dni-pracovneho-pokoja-2026.json — 11
- Počet štátnych sviatkov SR: /corpus/sk/holidays/statne-sviatky-pocet.json — 6
- 8. máj (Deň víťazstva): /corpus/sk/holidays/den-vitazstva-nad-fasizmom.json — 2026 NIE je deň pracovného pokoja
- 15. september (Sedembolestná): /corpus/sk/holidays/sedembolestna.json — 2026 NIE je deň pracovného pokoja
- 17. november: /corpus/sk/holidays/den-boja-za-slobodu.json — od 2026 NATRVALO nie je deň pracovného pokoja
- Veľká noc 2026: /corpus/sk/holidays/velky-piatok.json (3. 4.), /velkonocna-nedela.json (5. 4.), /velkonocny-pondelok.json (6. 4.)
- Zákaz maloobchodného predaja 2026: /corpus/sk/holidays/zakaz-predaja-2026.json — len 5,5 dňa (1. 1., Veľký piatok, Veľkonočná nedeľa, 24. 12. po 12:00, 25.–26. 12.)
- 17 dní + 3 agregáty (počet DPP, počet štátnych sviatkov, zákaz predaja); každý deň nesie: dátum, deň v týždni, is_day_off, is_state_holiday, holiday_type, zdroj.
- Pozn.: 1. september a 28. október sú štátne sviatky, ale NIE sú dni pracovného pokoja.

## Slovakia (sk) — veľké mestá (geo)
21 najväčších miest SR, každé 4 fakty: počet obyvateľov, primátor, samosprávny kraj, okres.
Schéma id: /corpus/sk/geo/<mesto>/{population,mayor,region,district}.json
- Primátor Bratislavy: /corpus/sk/geo/bratislava/mayor.json — Matúš Vallo (2022–2026)
- Obyvatelia Bratislavy: /corpus/sk/geo/bratislava/population.json — 475 503 (SODB 2021)
- Primátor Košíc: /corpus/sk/geo/kosice/mayor.json — Jaroslav Polaček
- Primátor Prešova: /corpus/sk/geo/presov/mayor.json — František Oľha
- Primátor Žiliny: /corpus/sk/geo/zilina/mayor.json — Peter Fiabáne
- Mestá: bratislava, kosice, presov, zilina, banska-bystrica, nitra, trnava, trencin, martin,
  poprad, prievidza, zvolen, povazska-bystrica, michalovce, nove-zamky, spisska-nova-ves,
  komarno, humenne, levice, bardejov, liptovsky-mikulas
- Pozn.: primátori sú z komunálnych volieb 2022 (obdobie 2022–2026); ďalšie voľby jeseň 2026.

## Slovakia (sk) — compliance / fintech (regulačné prahy a sadzby)
Vysoko-freshness fakty pre fintech/účtovné/SaaS agentov — limity hotovosti aj transakčná daň
sa v 2025/2026 zmenili konsolidačným balíčkom; LLM tu často vracia neaktuálne hodnoty.
- Limit platby v hotovosti (podnikateľ): /corpus/sk/compliance/cash-limit-business.json — 5 000 € (od 1. 1. 2026)
- Limit platby v hotovosti (medzi nepodnikateľmi): /corpus/sk/compliance/cash-limit-consumer.json — 15 000 €
- Daň z finančných transakcií — prevod: /corpus/sk/compliance/transaction-tax-rate.json — 0,4 % (max 40 €)
- Transakčná daň — výber hotovosti: /corpus/sk/compliance/transaction-tax-cash-withdrawal.json — 0,8 %
- Transakčná daň — platobná karta: /corpus/sk/compliance/transaction-tax-card.json — 2 €/karta/rok
- Transakčná daň — FO-podnikatelia: /corpus/sk/compliance/transaction-tax-natural-persons-exempt.json — od 1. 1. 2026 OSLOBODENÍ (platia len PO)
- Mikrodaňovník — hranica príjmov: /corpus/sk/compliance/micro-taxpayer-threshold.json — 60 000 €

## Slovakia (sk) — lokálna infraštruktúra: Bratislava (local) [moat]
Hyperlokálne, offline dáta, ktoré LLM nepozná a webové API nepokrývajú — MHD/tarify, parkovanie,
odpad, vodné/stočné a regulované energie. Pilot Bratislava, schéma id: /corpus/sk/local/bratislava/<topic>/<slug>.json
- MHD lístok 30 min (papierový, zóny 100+101): /corpus/sk/local/bratislava/transit/papierovy-listok-30-min-zona-100-101.json — 1,20 € (od 1. 6. 2025)
- MHD ročná električenka (zóny 100+101): /corpus/sk/local/bratislava/transit/predplatny-listok-365dni-zona-100-101.json — 263 €
- PAAS rezidentská karta, prvé auto: /corpus/sk/local/bratislava/parking/rezidentska-karta-prva-auto.json — 39 €/rok
- PAAS hodinová sadzba, pásmo A (centrum): /corpus/sk/local/bratislava/parking/hodinova-sadzba-pasmo-a.json — 2,00 €/h
- Poplatok za komunálny odpad (120 l, základná sadzba): /corpus/sk/local/bratislava/waste/sadzba-poplatku-120l-zakladna.json — 0,03595 €/l (VZN 17/2023)
- Triedený zber z rodinných domov: /corpus/sk/local/bratislava/waste/triedeny-zber-rodinne-domy-interval.json — 1× za 28 dní
- BVS vodné 2026: /corpus/sk/local/bratislava/utilities/bvs-vodne-2026.json — 1,4830 €/m³ (bez DPH)
- BVS stočné 2026: /corpus/sk/local/bratislava/utilities/bvs-stocne-2026.json — 1,4345 €/m³ (bez DPH)
- Regulovaná silová elektrina 2026 (bez energopomoci): /corpus/sk/local/bratislava/utilities/elektrina-regulovana-2026.json — 103,94 €/MWh
- Magistrát úradné hodiny: /corpus/sk/local/bratislava/institutions/magistrat-uradne-hodiny-tyzden.json — Po 8:30–17:00, Ut–Št 8:30–16:00, Pi 8:30–15:00
- APS pohotovosť dospelí: /corpus/sk/local/bratislava/pharmacy/aps-dospeli-hodiny.json — prac. dni 16–22, dni pracovného pokoja 7–22
- 46 faktov (transit/parking/waste/utilities/institutions/pharmacy); zdroje dpb.sk·idsbk.sk·paas.sk·olo.sk·VZN·urso.gov.sk·bvsas.sk·bratislava.sk·minv.sk·e-vuc.sk
- Pozn.: volatilné položky (dnešná pohotovostná lekáreň) zámerne nie sú faktom — uvedený je len úradný zdroj rozpisu.

## Slovakia (sk) — verejné registre: meta-fakty (registry)
Pre čo register slúži, kto ho vedie, ktorý zákon ho upravuje a — najmä — ako z neho ťahať dáta strojovo
(open-data/API). Stabilné meta, nie live lookup. Schéma id: /corpus/sk/registry/<register>-<atribút>.json
- ORSR (Obchodný register) — operátor: /corpus/sk/registry/orsr-operator.json — registrový súd / MS SR (zák. 530/2003)
- ORSR open data: /corpus/sk/registry/orsr-open-data.json — RPO REST API + SQL dumpy (Slovensko.Digital)
- ŽRSR (Živnostenský register) — operátor: /corpus/sk/registry/zrsr-operator.json — okresné úrady / MV SR (zák. 455/1991)
- Kataster nehnuteľností — operátor: /corpus/sk/registry/kataster-operator.json — ÚGKK SR (zák. 162/1995)
- Kataster open data: /corpus/sk/registry/kataster-open-data.json — ZBGIS/ESKN OGC služby (WMS/WFS/WCS) + data.gov.sk
- RPVS (partneri verejného sektora) — kto sa musí zapísať: /corpus/sk/registry/rpvs-who-must-register.json — prah 100 000 € jednorazovo / 250 000 € ročne (zák. 315/2016)
- RPVS open data: /corpus/sk/registry/rpvs-open-data.json — REST API rpvs.gov.sk/opendatav2
- RÚZ (účtovné závierky) — open data: /corpus/sk/registry/ruz-open-data.json — RÚZ Open API (JSON, CC0), registeruz.sk
- RPO (register právnických osôb) — open data: /corpus/sk/registry/rpo-open-data.json — api.statistics.sk/rpo (CC BY 4.0); najlepší strojový zdroj IČO/názov/adresa/štatutári
- 30 faktov (6 registrov × operátor/zákon/obsah/online prístup/open data); zdroje justice.gov.sk·slov-lex.sk·skgeodesy.sk·rpvs.gov.sk·registeruz.sk·slovak.statistics.sk

## Slovakia (sk) — spotrebiteľské práva a reklamácie (consumer)
Po novele zákonom 108/2024 Z. z. (od 1. 7. 2024): vady/reklamácia sa riadia Občianskym zákonníkom (§ 619–622, „vytknutie vady"), odstúpenie/refund zákonom 102/2014 Z. z. Schéma id: /corpus/sk/consumer/<slug>.json
- Zákonná záruka (nový tovar): /corpus/sk/consumer/warranty-period.json — 24 mesiacov (OZ § 620 ods. 1)
- Lehota na vybavenie reklamácie: /corpus/sk/consumer/defect-resolution-deadline.json — max 30 dní (OZ § 622 ods. 3)
- Určenie spôsobu vybavenia: /corpus/sk/consumer/defect-method-determination.json — ihneď, zložité do 3 prac. dní
- Domnienka vady (dôkazné bremeno predávajúceho): /corpus/sk/consumer/defect-presumption.json — 24 mesiacov (OZ § 619/620)
- Záruka na použitý tovar: /corpus/sk/consumer/used-goods-warranty.json — min. 12 mesiacov (OZ § 620 ods. 2)
- Odstúpenie od zmluvy na diaľku (e-shop): /corpus/sk/consumer/withdrawal-distance.json — 14 dní (zák. 102/2014 § 7)
- Odstúpenie pri nevyžiadanej návšteve/predajnej akcii: /corpus/sk/consumer/withdrawal-offpremises.json — 30 dní (novinka 108/2024)
- Predĺženie pri nepoučení o odstúpení: /corpus/sk/consumer/withdrawal-no-info-extension.json — +12 mesiacov (zák. 102/2014 § 8)
- Vrátenie peňazí po odstúpení: /corpus/sk/consumer/refund-deadline.json — do 14 dní (zák. 102/2014 § 9)
- Dozorný orgán: /corpus/sk/consumer/soi-supervision.json — SOI + ARS (zák. 391/2015) + ESC
- 10 faktov; zdroje slov-lex.sk (OZ 40/1964, 102/2014, 391/2015)·mhsr.sk·soi.sk·europskyspotrebitel.sk

## How to use
- Point your agent at the MCP endpoint and call `lookup_fact("sk/wages/minimum-wage")`
  or `search("daňový bonus 2026")` before answering — so the answer is checkable, not guessed.
- Every response includes the source URL, the quoted sentence, the date retrieved and a confidence level.

## Human pages
- /            — verify a fact (search) + recent lookups
- /explore.html — wide fact portal + live corpus table
- /wiki.html?id=<fact-id> — fact article view (wiki-for-bots)
- /pricing.html — pricing for agents