mcp-tk
This MCP server provides access to Polish Constitutional Tribunal (Trybunał Konstytucyjny) official judgments via MCP tools.
search(query, ...) – search judgments thematically in metadata or full text, with date/kind filters, pagination, inflection, and optional section (
where).search_by_signature(signature, ...) – find exact docket number (e.g.,
K 23/11).list_recent(pageSize, pageNumber) – retrieve latest judgments from the official IPO list.
get_judgment(id, ...) – fetch full text and metadata by IPO document ID or OTK ZU reference (e.g.,
2026/A/96), with section selection (sentencja, uzasadnienie, etc.), character offsets, chunked reading, andnext_offset/has_more.Responses include structured citations (title, URL, signature, date, doc_id, case_id) and official OTK ZU URLs/PDF links.
Provides multiple search modes (
auto,full_text,metadata,live) with safeguards and explicit errors for portal drift or upstream failures.
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., "@mcp-tk Pokaż najnowsze orzeczenia Trybunału Konstytucyjnego"
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.
mcp-tk
Serwer MCP dla polskiego orzecznictwa Trybunału Konstytucyjnego. Korzysta wyłącznie z oficjalnych serwisów TK:
Nie używa SAOS ani komercyjnych baz, nie wymaga konta i nie wymaga klucza API.
Po co
mcp-tk daje modelowi rzeczywiste orzeczenia TK: sygnaturę, datę, rodzaj, przedmiot, skład, pełny tekst, bezpośredni link i pozycję OTK ZU. Długie dokumenty można pobierać sekcjami i porcjami, zamiast zużywać cały budżet kontekstu naraz.
Related MCP server: SAOS MCP
Instalacja
Wymagany jest Node.js 18+. Serwer nie wymaga konta ani klucza API.
ChatGPT desktop — zalecany sposób
Zainstaluj serwer jednorazowo w terminalu:
npm install -g https://github.com/tramer222888-alt/mcp-tk/archive/refs/heads/main.tar.gzNastępnie w ustawieniach MCP wybierz STDIO.
Windows:
polecenie:
cmd.exeargumenty:
/d,/s,/c,mcp-tk— każdy jako osobna pozycja
macOS/Linux:
polecenie:
mcp-tkbez argumentów
Instalacja przed dodaniem MCP jest celowa: ChatGPT ma krótki limit startu
procesu, a pobieranie pakietu przez npx może go przekroczyć.
Codex CLI
Po wykonaniu powyższego npm install -g:
codex mcp add tk -- mcp-tkNa Windows, jeśli bezpośrednie uruchomienie nie działa:
codex mcp add tk -- cmd.exe /d /s /c mcp-tkGotowe pliki dist są wersjonowane w repozytorium, więc serwer nie
kompiluje TypeScriptu podczas startu.
Narzędzia
Tool | Działanie |
| Wyszukiwanie tematyczne. Domyślny |
| Dokładne wyszukiwanie po sygnaturze, np. |
| Najnowsze orzeczenia bezpośrednio z żywej listy IPO. |
| Pełny tekst i metadane. |
Każda odpowiedź zawiera structuredContent.citations. get_judgment umieszcza pobrany fragment również w structuredContent.judgment.content_chunk, ponieważ część klientów MCP pokazuje modelowi tylko dane strukturalne.
Cztery tryby wyszukiwania
Domyślny searchMode=auto przeszukuje lokalnie pełną treść orzeczeń pobraną z oficjalnego IPO. Dzięki temu skróty i nazwy występujące dopiero w uzasadnieniu — np. BGK — nie znikają tylko dlatego, że nie ma ich w polu „Dotyczy”. Wyszukiwanie nie czeka na wolny formularz JSF portalu.
Tryby:
searchMode=auto— zalecany; szybki lokalny indeks pełnej treści, z prostym uwzględnianiem odmiany słów;searchMode=full_text— ten sam pełnotekstowy indeks, jawnie wymagany;searchMode=metadata— tylko sygnatura, rodzaj, data i pole „Dotyczy”; najszybszy, ale o słabej kompletności;searchMode=live— żywy formularz JSF IPO; pozwala ograniczyć sekcję przezwhere, ale jest wolny i awaryjny.
Stary parametr searchInContent pozostaje obsługiwany: true odpowiada full_text, a false — metadata. Nowe wywołania powinny używać searchMode.
Indeksy są automatycznie odświeżane przez GitHub Actions co tydzień. Każda odpowiedź podaje index_generated_at. Jeśli podczas pierwszej publikacji brakuje jeszcze indeksu pełnej treści, auto jawnie zwraca tymczasowe metadane; nie uruchamia w tle wielominutowego formularza.
searchMode=live uruchamia pełnotekstowy formularz JSF oficjalnego IPO. Parametr where pozwala ograniczyć wyszukiwanie do:
wszedziekomparycjasentencjauzasadnieniehistoriaprzed_rozprawana_rozprawieocena_prawnazdanie_odrebne
Formularz TK bywa przeciążony i może odpowiadać znacznie wolniej niż pobieranie dokumentów. Błąd [upstream_error] oznacza jawną awarię lub timeout źródła, nie „zero wyników”.
Przykład kwerendy nastawionej na kompletność:
search(query="BGK", searchMode="auto", inflection=false, pageSize=50)Długie orzeczenia: sekcje i offset
get_judgment wykrywa następujące sekcje:
Sekcja | Zawartość |
| cały dokument |
| skład orzekający |
| rozstrzygnięcie ( |
| całe uzasadnienie |
| część poprzedzająca własną ocenę TK |
| fragment od „Trybunał Konstytucyjny zważył…” |
| zdania odrębne |
maxChars przyjmuje 500–50 000 znaków (domyślnie 15 000). offset jest liczony od początku wybranej sekcji. Odpowiedź zawiera bezwzględny zakres znaków, mapę sekcji, has_more i gotowy next_offset.
Przykładowy tok pracy:
search({ query: "prawo do sądu" })get_judgment({ id: "25567", section: "ocena_trybunalu" })jeżeli
has_more=true: ponowne wywołanie z tym samymsectioni podanymnext_offset
Pozycje OTK ZU
Można podać bezpośrednio identyfikator publikacji:
get_judgment(id="2026/A/96")Serwer pobiera oficjalną stronę OTK ZU, odczytuje z niej powiązane identyfikatory IPO, a następnie pobiera tekst na żywo. W odpowiedzi zachowuje oddzielnie:
url— strona dokumentu IPO,otkzu_url— pozycja Zbioru Urzędowego,otkzu_pdf_url— urzędowy PDF, gdy jest dostępny.
Obsługiwany jest nowy format RRRR/A/POZ oraz starszy RRRR/NR-A/POZ.
Cytowania
structuredContent.citations[] zawiera:
{
"title": "Wyrok K 7/18 z 2026-06-24",
"url": "https://...",
"signature": "K 7/18",
"date": "2026-06-24",
"author": "Trybunał Konstytucyjny",
"snippet": "...",
"doc_id": "25567",
"case_id": "20793"
}Dla pobranego orzeczenia preferowanym URL cytowania jest bezpośrednia pozycja OTK ZU, jeżeli metadane pozwalają ją jednoznacznie wyznaczyć; w pozostałych przypadkach używany jest oficjalny dokument IPO.
Bezpiecznik na dryf portali
Oba serwisy są publiczne, ale ich kontrakt techniczny nie jest dokumentowany. Konektor sprawdza między innymi:
obecność formularza
wyszukiwanie, JSFViewStatei znanych pól,strukturę listy oraz pagera,
identyfikatory
dokumentisprawa,kontener pełnego tekstu
tekst_{id},odsyłacz OTK ZU → IPO.
Zniknięcie krytycznego elementu daje [api_changed] z linkiem do issues. Awaria sieci lub HTTP daje [upstream_error]. Brak dokumentu lub sekcji daje [not_found]. Konektor nie zamienia błędu portalu w pozornie poprawny pusty wynik.
Transport i bezpieczeństwo
Node.js 18+, TypeScript,
@modelcontextprotocol/sdk, stdio.Natywny
node:http2: host IPO przy połączeniu HTTP/1.1 potrafi przyjąć połączenie i nie wysłać odpowiedzi.Bez wyłączania weryfikacji TLS.
Stała allowlista dwóch hostów TK i ścieżek portali; argument użytkownika nie staje się dowolnym URL.
Limit długości zapytań i rozmiaru fragmentów.
Około 2–3 żądania na sekundę, retry tylko dla błędów przejściowych.
Brak telemetrii i danych uwierzytelniających.
Zakres danych
Szybki indeks metadanych odzwierciedla listę dostępną w IPO (elektroniczny korpus portalu, w praktyce od końca lat 90.). Sam OTK ZU ma szerszy katalog historyczny; znaną starszą pozycję można pobrać przez jej identyfikator. Brak wyniku indeksowego nie dowodzi, że bardzo stare orzeczenie nie istnieje.
Build, testy i indeks
npm install
npm run build
npm run test:parse # testy offline parserów, sekcji, offsetów i drift guardów
npm run smoke # test LIVE: lista + pełny tekst z oficjalnego IPO
npm run index # przebudowa data/ipo-index.json z oficjalnej listy
npm run index:fulltext # przebudowa skompresowanego indeksu pełnej treści
npm run verify:index # kontrola regresji: co najmniej 7 dokumentów dla BGK
node dist/index.js # serwer MCP na stdioTesty offline używają małych fixture'ów odtwarzających rzeczywistą strukturę HTML portali. Live smoke jest uruchamiany ręcznie, aby zwykłe CI nie zależało od chwilowej dostępności TK.
Konfiguracja ręczna
{
"mcpServers": {
"tk": {
"command": "node",
"args": ["/ścieżka/do/mcp-tk/dist/index.js"]
}
}
}Uwaga prawna
Konektor udostępnia źródła, nie udziela porady prawnej. Przy powoływaniu orzeczenia sprawdź jego pełną treść, datę, sentencję, późniejsze orzecznictwo oraz skutki wynikające z art. 190 Konstytucji. Wynik wyszukiwania tematycznego jest kandydatem do analizy, a nie automatycznie „linią orzeczniczą”.
Podziękowania
Układ MCP, structuredContent.citations, porcjowanie i jawna obsługa dryfu są rozwinięciem wzorca z HelpToSave/mcp-eureka, który z kolei wskazuje konektory mcp-nsa Wiesława Mazura. Rozpoznanie stabilnych elementów publicznego HTML IPO porównano także z otwartym projektem worldwidelaw/legal-sources; implementacja w tym repozytorium jest niezależna.
Licencja
MIT © 2026 Mateusz Bednarski. Zobacz LICENSE.
Available Tools
4 toolsget_judgmentARead-onlyIdempotent
Pobiera na żywo pełny tekst orzeczenia z oficjalnego IPO. id może być numerem dokumentu IPO albo pozycją OTK ZU, np. 2026/A/96. Obsługuje sekcje, offset i porcje 500–50 000 znaków.
Inputs: id (required), caseId, offset, section, +1 more.
list_recentARead-onlyIdempotent
Pobiera na żywo najnowsze orzeczenia z oficjalnej listy IPO TK.
Inputs: pageSize, pageNumber.
searchARead-onlyIdempotent
Wyszukuje orzeczenia TK. Domyślnie przeszukuje szybki indeks oficjalnych metadanych IPO (sygnatura, rodzaj, data, pole „Dotyczy”). searchInContent=true uruchamia pełnotekstowy formularz oficjalnego IPO.
Inputs: query (required), kind, where, dateTo, +5 more.
search_by_signatureARead-onlyIdempotent
Wyszukuje po dokładnej sygnaturze TK, np. K 23/11 albo SK 45/09, w indeksie z oficjalnego IPO.
Inputs: signature (required), pageSize, pageNumber.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clear, distinct purpose: general search, signature-specific search, recent listings, and full-text retrieval. No two tools are likely to be confused for one another.
All tool names follow a consistent snake_case verb_noun pattern (search, search_by_signature, list_recent, get_judgment), making the API predictable and intuitive.
With 4 tools, the server is well-scoped for a focused domain of retrieving Polish Constitutional Tribunal judgments. Every tool earns its place without redundancy.
The tool surface covers the full lifecycle for a read-only lookup service: general search, specific signature lookup, listing recent entries, and fetching full texts. No obvious gaps remain.
Maintenance
Related MCP Connectors
Semantic search over Polish law and case law, citing the exact in-force article.
Polish statutes (Dziennik Ustaw, ELI) and court rulings (SAOS) for AI agents. Runs on Apify.
Polish and EU law: statutes, rulings, UODO/UOKiK/KNF, EU regulations, citation checks. Free tier.
Search ~656k Polish court rulings and ~165k legal acts, verify case numbers, find citing rulings.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI-powered legal research and analysis of Polish legal acts from the Sejm API. Provides comprehensive search, document retrieval, metadata analysis, and content access for legal documents from Dziennik Ustaw and Monitor Polski.1323MIT
- AlicenseAqualityCmaintenanceProvides access to Polish court judgments from the SAOS database. Enables search and retrieval of judgments with full-text search, filtering, and detailed case information.320 npm1Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables semantic search over Polish court judgments and legislative acts via MCP. Allows LLMs to retrieve legal documents using natural language queries.Apache 2.0
- AlicenseAqualityBmaintenanceEnables AI assistants to query official Polish Sejm data and the ELI legal acts database for deputies, clubs, committees, votes, interpellations, bills, proceedings, transcripts, and legal acts, with source links.2957 npm2Apache 2.0