judikatura-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@judikatura-mcp Co bylo zveřejněno 19.09.2026?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
judikatura-mcp – MCP server pro soudní rozhodnutí ČR (rozhodnuti.justice.cz)
English summary. A local Model Context Protocol server (stdio) for the Czech Ministry of Justice public database of anonymised court decisions of district, regional and high courts (rozhodnuti.justice.cz). Full-text search with filters (court, legal-institute keywords, statutory provision, judge, type, dates), lookup by case number or ECLI, browsing of the official open-data API by publication date, full decision text, DOCX/TXT export and a local SQLite/FTS5 cache. Czech documentation follows.
Lokální MCP server pro Claude Desktop, Claude Code a další MCP klienty. Umožňuje asistentovi vyhledávat a číst plné texty anonymizovaných rozhodnutí okresních, krajských a vrchních soudů zveřejňovaných Ministerstvem spravedlnosti.
Nástroje
Nástroj | Zdroj | Co dělá |
| vyhledávací API webu | fulltext (všechna slova / kterékoli / přesná fráze) + filtry: soud, klíčová slova, ustanovení předpisu (§ + číslo/rok), soudce, typ rozhodnutí, datum vydání / zveřejnění, vztah k napadenému rozhodnutí |
| vyhledávací API webu | hledání podle spisové značky |
| oficiální opendata API | procházení podle data zveřejnění: roky → měsíce → dny → seznam rozhodnutí (po 100) |
| oficiální opendata API | plný text podle uuid nebo ECLI (záhlaví, výrok, odůvodnění, poučení, metadata); ukládá do cache |
| – | uloží rozhodnutí jako |
| obojí | hromadně stáhne plné texty podle filtru / za den do lokální SQLite cache |
| lokální cache | fulltext FTS5 bez ohledu na diakritiku ( |
| lokální cache | stav cache |
| číselníky | 109 soudů (kód → název), 1 072 klíčových slov (právních institutů) |
Soudy i klíčová slova lze zadávat česky (Krajský soud v Ostravě, bezdůvodné obohacení) – server je
převede na kódy. Ustanovení se zadává jako § 2991 z. č. 89/2012 Sb. nebo jen 89/2012.
Related MCP server: rechtspraak-mcp
Instalace
A) Claude Desktop – jedním kliknutím (.mcpb)
Stáhněte
judikatura-mcp-X.Y.Z.mcpbz Releases.Otevřete soubor dvojklikem (nebo Claude Desktop → Settings → Extensions → Advanced settings → Install Extension…).
V nastavení rozšíření volitelně zadejte umístění cache a složku pro export.
Balíček používá runtime uv – Claude Desktop si sám obstará Python i závislosti.
B) Ručně (Claude Desktop, Claude Code, jiný klient)
git clone https://github.com/marshall1727/judikatura-mcp.git
cd judikatura-mcp
.\install.ps1 # vytvoří .venv, nainstaluje, spustí testy a vypíše blok pro claude_desktop_config.jsonnebo s uv:
{
"mcpServers": {
"judikatura": {
"command": "uv",
"args": ["--directory", "C:\\cesta\\k\\judikatura-mcp", "run", "judikatura-mcp"]
}
}
}Proměnné prostředí
Proměnná | Význam | Výchozí |
| soubor SQLite cache |
|
| složka pro export DOCX/TXT |
|
Příklady dotazů
„Najdi rozhodnutí Krajského soudu v Ostravě z roku 2026 k § 2991 OZ (bezdůvodné obohacení).“
„Vyhledej rozsudky s klíčovými slovy smluvní pokuta a ochrana spotřebitele vydané po 01.01.2026.“
„Najdi 8 Co 85/2026 u KSOS a ulož ho jako DOCX.“
„Stáhni do cache rozhodnutí OSPH01 k § 2079 OZ z letošního roku a pak v nich najdi odstoupení od smlouvy.“
„Co bylo zveřejněno 19.09.2026?“
Zdroje dat a omezení
Oficiální opendata API (https://rozhodnuti.justice.cz/opendata/) umožňuje jen procházení podle data zveřejnění a stažení detailu rozhodnutí. Používají ho
browse_published,get_decision,cache_fill_day.Vyhledávací endpoint
/api/finaldoc?…je interní API webové aplikace (stejné, které volá formulář na webu). Není dokumentované a může se změnit bez upozornění. Používají hosearch_decisions,find_by_case_number,cache_filla dohledání podle ECLI.Fulltext s velmi častými slovy („smlouva“, „žalobce“) trvá na straně serveru i desítky sekund a může skončit chybou – kombinujte s filtrem soudu, ustanovení nebo data.
Texty jsou anonymizované zdrojem; jména, adresy, data a částky mohou být nahrazeny placeholdery, které server zobrazuje v hranatých závorkách (
[datum],[Jméno žalobkyně]). Při citaci používejte soud, spisovou značku, ECLI a datum vydání z metadat.Databáze obsahuje rozhodnutí nižších soudů zveřejňovaná přibližně od roku 2021; NS, NSS a ÚS jsou v číselníku, ale primárním zdrojem pro ně zůstávají jejich vlastní databáze.
Server posílá nejvýše 4 souběžné požadavky;
cache_fillmá strop 500 rozhodnutí na volání.Číselníky soudů a klíčových slov odpovídají webové aplikaci verze 2.2.0 (říjen 2026).
Vývoj
pip install -e ".[dev]"
ruff check .
pytest # offline testy (fixture, mock HTTP)
python scripts\build_mcpb.py # dist\judikatura-mcp-<verze>.mcpb (vyžaduje Node.js pro npx @anthropic-ai/mcpb)Struktura:
judikatura_mcp/ server.py (nástroje), api.py (HTTP klient), format.py (text, číselníky),
cache.py (SQLite + FTS5), export.py (DOCX/TXT), courts.json, flags.json
mcpb/ manifest.json, icon.png, src/server.py – podklady balíčku pro Claude Desktop
scripts/build_mcpb.py
tests/ offline testy
.github/workflows/ CI (lint, testy, build) a Release (push tagu vX.Y.Z → .mcpb, wheel, sdist, zip)Licence
MIT. Data: Ministerstvo spravedlnosti ČR, otevřená data – https://rozhodnuti.justice.cz/opendata/
Available Tools
11 toolsbrowse_publishedA
Procházení oficiálního opendata API podle data ZVEŘEJNĚNÍ.
bez parametrů: přehled roků a počtů rozhodnutí
year: přehled měsíců; year+month: přehled dnů
year+month+day: seznam rozhodnutí zveřejněných v daný den (stránkováno po 100, page od 0); court = volitelný filtr na kód/název soudu (filtruje se lokálně v rámci stránky).
Inputs: day, page, year, court, +1 more. Returns: result
cache_fillA
Stáhne do lokální cache plné texty všech rozhodnutí odpovídajících filtru (stejné parametry jako search_decisions), nejvýše max_decisions (výchozí 50, max 500). Poté lze prohledávat offline nástrojem cache_search. Pozor: každé rozhodnutí = 1 HTTP požadavek; buďte šetrní k veřejnému serveru.
Inputs: mode, court, query, types, +7 more. Returns: result
cache_fill_dayB
Stáhne do cache všechna rozhodnutí zveřejněná v daný den (oficiální opendata API), volitelně jen pro zadaný soud (kód/název). max_decisions: strop (výchozí 100, max 500).
Inputs: day (required), year (required), month (required), court, +1 more. Returns: result
cache_searchA
Fulltext (SQLite FTS5, bez ohledu na diakritiku) nad rozhodnutími uloženými v lokální cache. Syntaxe: slova = AND; 'a OR b'; '"přesná fráze"'; 'promlč*' (prefix); NOT. Vrací úryvky se zvýrazněním >>slovo<<. Prohledává jen to, co bylo staženo (get_decision / cache_fill).
Inputs: query (required), court, limit. Returns: result
cache_statsB
Stav lokální cache: počet rozhodnutí, rozsah dat zveřejnění, nejčastější soudy, umístění databáze.
Inputs: no named parameters. Returns: result
export_decisionB
Uloží plný text rozhodnutí jako soubor. format: 'docx' | 'txt'. out_dir: cílová složka (výchozí: Dokumenty/judikatura-mcp nebo proměnná JUDIKATURA_MCP_EXPORT_DIR). filename: název souboru bez přípony (výchozí: kód soudu + spisová značka).
Inputs: uuid_or_ecli (required), format, out_dir, filename. Returns: result
find_by_case_numberA
Najde rozhodnutí podle spisové značky ve tvaru 'senát rejstřík číslo/rok' (např. '20 C 98/2026', '8 Co 85/2026'). court = kód nebo název soudu (doporučeno; stejná značka existuje u více soudů).
Inputs: case_number (required), court, limit. Returns: result
get_decisionA
Vrátí plný text rozhodnutí podle uuid nebo ECLI (např. 'ECLI:CZ:KSOS:2026:8.Co.85.2026.1'). section: 'all' | 'metadata' | 'verdict' (výrok) | 'justification' (odůvodnění) | 'header' | 'information' (poučení). Stažená rozhodnutí se ukládají do lokální cache; refresh=True vynutí nové stažení.
Inputs: uuid_or_ecli (required), refresh, section. Returns: result
list_courtsA
Číselník soudů (kód -> název). Volitelný filtr podle části názvu (bez ohledu na diakritiku), např. 'Ostrav', 'krajský', 'Praha'. Kódy se používají v parametru court u ostatních nástrojů.
Inputs: filter. Returns: result
list_keywordsA
Číselník klíčových slov (právních institutů), kterými jsou rozhodnutí označena. filter = část názvu (bez ohledu na diakritiku), např. 'smlouva', 'nájem', 'promlč'. Vrací kód -> český název. Název i kód lze použít v parametru keywords u search_decisions.
Inputs: filter (required), limit. Returns: result
search_decisionsA
Vyhledávání soudních rozhodnutí (fulltext + filtry). Používá nedokumentované API webu rozhodnuti.justice.cz.
Parametry:
query: hledaná slova v textu rozhodnutí.
mode: ALL = všechna slova, ANY = kterékoli slovo, EXACT = přesná fráze.
court: kód nebo název soudu; více soudů oddělit čárkou (např. 'KSOS, OSOV' nebo 'Krajský soud v Ostravě').
keywords: klíčová slova (kód nebo český název), více oddělit čárkou, např. 'bezdůvodné obohacení, smlouva o úvěru'.
regulation: dotčené ustanovení, např. '§ 2991 z. č. 89/2012 Sb.' nebo jen '89/2012' (všechna rozhodnutí citující OZ).
judge_last_name / judge_first_name: soudce.
types: 'JUDGEMENT' (rozsudek), 'ORDER_T' (trestní příkaz), 'RESOLUTION' (usnesení); více oddělit čárkou. Výchozí: vše.
issued_from/issued_to: datum vydání (YYYY-MM-DD). published_from/published_to: datum zveřejnění.
affected: vztah k napadenému rozhodnutí: 'CONFIRM', 'CHANGE', 'CANCEL', 'COMPLETE', 'CORRECT', 'REPLACE' (čárkou).
sort_by: PUBLISHED_AT | DECISION_AT; sort_direction: DESC | ASC.
page (od 0), limit (max 100).
Vrací seznam s uuid, ECLI, soudem, spisovou značkou, daty, předmětem a zkráceným výrokem. Plný text získáte nástrojem get_decision(uuid).
Inputs: mode, page, court, limit, +13 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Most tools have clearly distinct purposes: lookup tables (list_courts/list_keywords), online search (search_decisions), case-number lookup (find_by_case_number), date browsing (browse_published), full-text retrieval (get_decision), export, and cache operations. There is mild overlap among the several 'find decisions' tools and between cache_fill and cache_fill_day, but descriptions make the intended boundary clear.
Names follow a predictable snake_case convention, mostly verb_noun (list_courts, search_decisions, get_decision, export_decision). The cache group uses a noun-prefixed namespace (cache_fill, cache_fill_day, cache_search, cache_stats), a minor deviation but logically grouped and readable.
11 tools is well-scoped for a judicial-decisions server, covering discovery, retrieval, export, and offline cache workflow. Each tool earns its place with no filler.
The surface covers the full lifecycle of finding, retrieving, exporting, and caching decisions, including offline search and status. Minor gaps such as citation/related-decision lookup exist, but core workflows are covered without dead ends.
Maintenance
Related MCP Connectors
Polish legal data for AI assistants: full-text search across 2.94M+ court rulings (common courts, Supreme Court, Constitutional Tribunal, KIO, NSA/WSA), statute text and version history from the official ELI register (164k+ acts), rulings citing a provision and citations between rulings, a citation verifier for case numbers, case-outcome and duration statistics, KIS tax interpretations, CJEU rulings applied in Poland, UODO decisions, KRS company lookup, court competence, official bank accounts and legal calculators. Works without an API key (daily limit).
Case law search, court decisions and súmulas, across indexed public sources (STF, STJ, TST, state co
Czech law research with citations: statutes by date, court decisions, explanatory reports.
Resolve, search and verify legal citations against the official sources, with provenance.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables searching and retrieving Czech legal acts from the e-Sbirka database via SPARQL, including metadata and full consolidated text with verifiable citations.3128 PyPI2Apache 2.0
- AlicenseAqualityCmaintenanceEnables searching and retrieving Dutch case law (uitspraken) via the Rechtspraak Open Data API, including full text and citation graph exploration.666 npm2MIT
- AlicenseAqualityCmaintenanceEnables searching Polish Constitutional Tribunal judgments and rulings (with facet filters and sorting) and fetching the full HTML text of a given judgment directly from trybunal.gov.pl, without authentication.3Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to search, read and cross-check a local, offline SQLite corpus of STJ and TJSC appellate decisions (ementas), accepted repetitive themes and súmulas, plus citations between them, through five read-only tools. Coverage is partial and declared, so every search reports its sources, delays and gaps.1MIT