legal-cite

Legal citation verifier (PL / EU law) — an MCP server that fetches the exact, in-force wording of a cited article straight from the official source. An anti-hallucination tool for Claude (and any MCP client): instead of trusting the model's memory of a statute, it returns the verbatim text of the cited article from the official register.

Weryfikator cytatów prawnych (prawo PL / UE) — serwer MCP pobierający dokładne, aktualne brzmienie cytowanego artykułu prosto z oficjalnego źródła. Narzędzie anti-halucynacyjne dla Claude (i dowolnego klienta MCP).

• 🇵🇱 PL law — api.sejm.gov.pl (ELI). Returns the consolidated text (tekst jednolity, currently in force), not the original as-promulgated version.

• 🇪🇺 EU law — Publications Office CELLAR / EUR-Lex (Polish text), latest in-force consolidated version (CELEX 0…-YYYYMMDD, found via the CELLAR SPARQL endpoint), not the original Official Journal text — so amendments (e.g. AI Act art. 111(4) added by Regulation 2026/1744) are not missed. Consolidated text is labelled unofficial (📄), names the amending act behind each changed article and lists amending acts that entered into force after the consolidation date. Amendment markers (►M1, ▼B) are stripped from the quote. Falls back to the original text, with an explicit note, when no consolidated version exists or SPARQL is down.

Returns only the cited article (not the whole act). The quote comes straight from the source.

Consolidated texts available only as PDF (since 2025)

Since 2025 the Sejm ELI API publishes Journal of Laws acts only as PDF — the newest consolidated texts of the Civil Code, Labour Code, Civil Procedure Code and others have no HTML. The tool therefore picks the version first, the format second: the newest consolidated text is the basis, and when it exists only as PDF, the tool converts the official PDF itself with a pinned version of eli2md (MIT) and reads the article from the resulting tree of units. Such a result is an unofficial reading of an official PDF and is labelled as such (📄 instead of 📜), with the Journal of Laws number, link to the PDF, PDF checksum and converter version. Two separate judgements are reported: fidelity of the reading and currency of the law.

Fidelity checks before anything is returned (any failure → the tool refuses instead of returning an older text):

1. structure — article numbers increase in document order; the article is a unit of the tree, not a quoted passage;

2. text layer, second reader — the article's words must appear in order in the PDF text layer read by poppler's pdftotext (eli2md reads through pdfminer), and words the converter skipped inside the article may only be page headers and footnotes;

3. older consolidated text in HTML (official and independent of the PDF) — an identical article is returned as the official HTML text, confirmed as unchanged by the newest consolidated text; a different article must be explained by a footnote at the unit or by an amendment that entered into force between the two texts.

Currency is a separate line: the amending acts (Journal of Laws number and date, from the ELI register) that entered into force after the consolidated text's date, or none — and, separately, amending acts already published but not yet in force (with their date). The [dla modelu] fields nowelizacje_po_tj and nowelizacje_oczekujace list their ELI ids. The trailing [dla modelu] line carries the same judgements as fields for an LLM reading the tool output.

Measured on 2026-10-10 (8 acts whose newest consolidated text is PDF-only, 4676 articles): 99.7 % pass the text-layer check; of those also present in the older HTML, 4339 are word-for-word identical. Requirements: pdftotext (Debian/Ubuntu: apt install poppler-utils); without it the PDF path refuses. First conversion of a code takes 30–90 s and is cached on disk (LEGAL_CITE_CACHE, default under the system temp dir). Optionally set LEGAL_CITE_GCS_BUCKET (and install .[gcs]) to keep conversions in Cloud Storage: a new instance downloads them instead of converting (file names carry the PDF checksum and converter version; fidelity checks run on the downloaded file as on a fresh one; any bucket error falls back to conversion). On Cloud Run use at least --memory=512Mi and the default request timeout (300 s).

English

Tools

• verify_article("art. 45 u.k.k.") — the wording of a provision. Format: art. N [ust. M] CODE. Handles letter suffixes (art. 36a), § as a unit (art. 58 § 2 KC), superscript paragraphs (art. 98 § 1¹ k.p.c. / § 1[1]), superscripts with letters (art. 385¹ / 385[1] / 131¹ᵃ / 131[1a]), dotted codes (k.p.c.). When a consolidated text prints two wordings of the same paragraph/point (current one and one entering into force later), the tool returns only the one in force today, chosen by the date in the footnote, and says so; if the date cannot be read, it refuses.

• list_acts() — list of supported act codes (PL + EU).

• Any EU act can be cited by its type and number or by CELEX: art. 6 ust. 1 dyrektywy 93/13/EWG, art. 4 rozporządzenia (WE) nr 593/2008, art. 5 rozporządzenia 2016/679, art. 2 decyzji 2011/753/UE, art. 1 CELEX 32019L0770; the Treaties and the Charter as art. 267 TFUE, art. 4 ust. 3 TUE, art. 47 Karty praw podstawowych. The number is read in both EU numbering orders (regulations up to 2014: number/year, from 2015: year/number; directives: year/number); a candidate CELEX is accepted only when CELLAR knows it as an act of that type and its Polish title contains the cited number. No match, two matches, an act no longer in force or an act without a Polish language version → refusal. Acts adopted before 1 May 2004 that exist in Polish only in the special edition of the Official Journal are read from the CELLAR HTML of that edition. Random sample of 100 in-force regulations and directives (2026-10-29, testy/pokrycie_ue.py): 575 articles with correct article boundaries, 0 boundary errors, 0 download refusals, 11 acts refused for having no Polish language version. There is no independent second source of EU text, so this checks article boundaries, not wording.

• verify_article(citation, na_dzien="YYYY-MM-DD") — the wording in force on a given day. Polish acts: from the consolidated texts published before and after that day and the ELI register of amending acts; the Ustalenie: line says whether the wording is confirmed, inferred from the amending acts (also when no newer consolidated text exists yet and none of the amending acts in the period mentions the article or amends the act as a whole), or not established (then both wordings are given). EU acts: the consolidated version in force on that day (the latest one dated no later than that day), with amending acts that entered into force between that version and the day; an act already repealed is served for days on which it was in force (art. 4 dyrektywy 87/102/EWG, 2005-06-01), and refused before its entry into force or after its end of validity.

• Any Polish statute (ustawa) outside the list can be cited by its Journal of Laws address, including the address of a consolidated text: art. 5 Dz.U. 2024 poz. 1061, art. 1 DU/2018/723. A statute can also be named by its title (art. 9 ustawy o ochronie konkurencji i konsumentów; ambiguous titles are refused with candidates). Regulations (rozporządzenia) are cited by paragraph and Journal of Laws address: § 2 ust. 1 Dz.U. 2025 poz. 1899 (random sample of 100 in-force regulations: 713 paragraphs, 0 wrong wordings). A regulation can also be named by its title, with or without issuer and date: § 2 rozporządzenia Ministra Sprawiedliwości z dnia 22 października 2015 r. w sprawie opłat za czynności adwokackie, § 2 rozporządzenia w sprawie opłat za czynności radców prawnych. The ELI search must return a non-amending regulation with an identical subject; a given issuer and date must match; several in-force matches → refusal with candidates. Random sample of 100 in-force regulations (2026-10-29, testy/rozporzadzenie_tytul.py --proba 100): the full title leads back to the same act in 100 of 100 cases, the title without date in 99 (1 refusal: several regulations with that subject), 0 cases of a different act. Acts of the Monitor Polski (resolutions, orders, rules of procedure) are cited by address: art. 6 ust. 1 M.P. 2022 poz. 990, art. 6 MP/1992/185; the Rules of Procedure of the Sejm also as art. 7 ust. 1 Regulaminu Sejmu (2026-10-29: 196 articles, 0 refusals). International agreements (e.g. the ECHR, Dz.U. 1993 nr 61 poz. 284) are refused: ELI has them only as PDF printed bilingually in two columns, and the reading is not reliable; the answer links the binding PDF. Full coverage of all 1,127 in-force substantive statutes outside the list (2026-10-28): 71,174 articles, 0 wrong wordings. A random sample of 100 in-force statutes outside the list (2026-10-28): 6,314 articles, 0 wrong wordings, 0 refusals, 1 explicit ambiguity (testy/pokrycie_proba.py).

Run locally (stdio — Claude Desktop / Claude Code)

pip install -e .
legal-cite          # stdio

claude_desktop_config.json:

{ "mcpServers": { "legal-cite": { "command": "legal-cite" } } }

Deploy to Cloud Run (streamable-http — one shared URL)

gcloud run deploy legal-cite \
  --source=. \
  --region=europe-west4 \
  --allow-unauthenticated \
  --memory=512Mi --cpu=1 --max-instances=1 --timeout=300 --port=8080

Public, no-auth is safe here — the service serves only public legal texts (no data, no database, no LLM calls).

Connect in Claude: Connectors → Add custom connector → https://<service-url>.run.app/mcp (streamable-http mounts MCP at /mcp).

Add a new act

Add an entry to PL_ACTS (key = abbreviation; pub/year/pos from the Journal of Laws / ELI) or EU_ACTS (key = abbreviation, celex) in legal_cite/core.py.

Related MCP server: mcp-eur-lex

Polski

Prawo UE

Akty UE są cytowane z najnowszej obowiązującej wersji skonsolidowanej (CELEX 0…-RRRRMMDD, ustalanej przez SPARQL CELLAR), a nie z tekstu pierwotnego z Dz.U. UE — inaczej umykają zmiany (np. art. 111 ust. 4 AI Act dodany rozporządzeniem 2026/1744). Tekst skonsolidowany jest oznaczony jako nieurzędowy (📄), z aktem zmieniającym dany artykuł i aktami zmieniającymi, które weszły w życie po dacie konsolidacji. Znaczniki ►M1/▼B są usuwane z cytatu. Gdy wersji skonsolidowanej nie ma albo SPARQL nie odpowiada — tekst pierwotny z jawną adnotacją.

Narzędzia

• verify_article("art. 45 u.k.k.") — brzmienie przepisu. Format: art. N [ust. M] KOD. Obsługuje sufiks literowy (art. 36a), § jako jednostkę (art. 58 § 2 KC), paragraf z indeksem górnym (art. 98 § 1¹ k.p.c. / § 1[1]), indeks górny z literą (art. 385¹ / 385[1] / 131¹ᵃ / 131[1a]), kody z kropkami (k.p.c., k.r.o.). Gdy tekst jednolity drukuje dwa brzmienia tego samego paragrafu, ustępu lub punktu (obowiązujące i wchodzące w życie później), narzędzie zwraca tylko obowiązujące dziś — wybrane po dacie z odnośnika — i to zaznacza; gdy daty nie da się odczytać, odmawia.

Teksty jednolite dostępne tylko w PDF (od 2025 r.)

Od 2025 r. API ELI Sejmu publikuje akty Dziennika Ustaw wyłącznie w PDF — najnowsze teksty jednolite k.c., k.p., k.p.c. i innych nie mają HTML. Narzędzie wybiera więc najpierw wersję, potem format: podstawą jest najnowszy tekst jednolity, a gdy jest tylko w PDF, narzędzie samo konwertuje urzędowy PDF przypiętą wersją eli2md (MIT) i wycina artykuł z drzewa jednostek. Taki wynik to nieurzędowy odczyt urzędowego PDF i tak jest oznaczony (📄 zamiast 📜): numer Dz.U., link do PDF, suma kontrolna PDF, wersja konwertera. Osobno podawane są dwie oceny: wierność odczytu i aktualność prawna.

Kontrole wierności przed oddaniem wyniku (każda niezaliczona → odmowa zamiast starszego brzmienia):

1. struktura — numery artykułów rosną w kolejności dokumentu, artykuł jest węzłem drzewa, nie cytatem w przepisie przejściowym;

2. warstwa tekstowa, drugi czytnik — słowa artykułu muszą wystąpić w tej kolejności w warstwie tekstowej PDF czytanej przez pdftotext (poppler; eli2md czyta przez pdfminer), a słowa pominięte przez konwerter w obrębie artykułu mogą być tylko nagłówkami stron i przypisami;

3. starszy tekst jednolity w HTML (urzędowy, niezależny od PDF) — artykuł identyczny jest zwracany jako tekst urzędowy HTML, potwierdzony przez najnowszy t.j. jako niezmieniony; artykuł różny musi mieć wytłumaczenie w odnośniku przy jednostce albo w nowelizacji, która weszła w życie między datami obu tekstów.

Aktualność to osobna linia: akty zmieniające (numer Dz.U. i data, wg wykazu ELI), które weszły w życie po dacie tekstu jednolitego, albo że żaden — i osobno akty ogłoszone, które jeszcze nie obowiązują (z datą). Pola nowelizacje_po_tj i nowelizacje_oczekujace w linii [dla modelu] podają ich identyfikatory ELI. Linia [dla modelu] na końcu powtarza te oceny jako pola dla modelu czytającego wynik narzędzia.

Pomiar 2026-10-10 (8 aktów z najnowszym t.j. tylko w PDF, 4676 artykułów): 99,7 % przechodzi kontrolę warstwy tekstowej; spośród obecnych w starszym HTML 4339 jest identycznych co do słowa. Wymagania: pdftotext (Debian/Ubuntu: apt install poppler-utils); bez niego ścieżka PDF odmawia. Pierwsza konwersja kodeksu trwa 30–90 s i jest trzymana na dysku (LEGAL_CITE_CACHE, domyślnie w katalogu tymczasowym systemu). Opcjonalnie LEGAL_CITE_GCS_BUCKET (instalacja .[gcs]) trzyma konwersje w Cloud Storage: nowa instancja pobiera je zamiast konwertować (nazwa pliku zawiera sumę PDF i wersję konwertera; kontrole wierności biegną na pobranym pliku tak samo; błąd zasobnika = powrót do konwersji). Na Cloud Run co najmniej --memory=512Mi.

• list_acts() — lista obsługiwanych kodów aktów (PL + UE).

• Dowolny akt UE — rodzajem i numerem albo CELEX-em: art. 6 ust. 1 dyrektywy 93/13/EWG, art. 4 rozporządzenia (WE) nr 593/2008, art. 5 rozporządzenia 2016/679, art. 2 decyzji 2011/753/UE, art. 1 CELEX 32019L0770; traktaty i Karta: art. 267 TFUE, art. 4 ust. 3 TUE, art. 47 Karty praw podstawowych. Numer jest czytany w obu porządkach numeracji UE (rozporządzenia do 2014 r. numer/rok, od 2015 r. rok/numer; dyrektywy rok/numer); kandydat CELEX przechodzi tylko wtedy, gdy CELLAR zna go jako akt tego rodzaju, a polski tytuł zawiera numer z cytatu. Brak trafienia, dwa trafienia, akt nieobowiązujący albo bez polskiej wersji językowej — odmowa. Akty sprzed 1.05.2004 r., które po polsku istnieją tylko w wydaniu specjalnym Dz.U. UE, są czytane z HTML tego wydania w CELLAR. Losowa próba 100 obowiązujących rozporządzeń i dyrektyw (29.10.2026, testy/pokrycie_ue.py): 575 artykułów z poprawnymi granicami, 0 błędów granic, 0 odmów pobrania, 11 aktów odrzuconych z powodu braku polskiej wersji językowej. Niezależnego drugiego źródła tekstu UE nie ma, więc to kontrola granic artykułów, nie porównanie brzmień.

• verify_article(citation, na_dzien="RRRR-MM-DD") — brzmienie obowiązujące we wskazanym dniu. Akty polskie: z tekstów jednolitych ogłoszonych przed tym dniem i po nim oraz wykazu aktów zmieniających w ELI; linia Ustalenie: mówi, czy brzmienie jest potwierdzone, ustalone z treści nowelizacji (także wtedy, gdy nowszego tekstu jednolitego jeszcze nie ma, a żadna nowelizacja z okresu nie wymienia artykułu ani nie zmienia całej ustawy), czy nieustalone (wtedy oba brzmienia). Akty UE: wersja skonsolidowana obowiązująca w tym dniu (najnowsza z datą nie późniejszą), z aktami zmieniającymi, które weszły w życie między tą wersją a tym dniem; akt już uchylony jest podawany na dni, w których obowiązywał (art. 4 dyrektywy 87/102/EWG, 2005-06-01), a przed wejściem w życie i po utracie mocy — odmowa.

• Dowolną ustawę spoza listy można wskazać adresem Dz.U., także adresem tekstu jednolitego: art. 5 Dz.U. 2024 poz. 1061, art. 1 DU/2018/723. Ustawę można też wskazać tytułem (art. 9 ustawy o ochronie konkurencji i konsumentów; przy niejednoznaczności odmowa z kandydatami). Rozporządzenia — paragrafem i adresem Dz.U.: § 2 ust. 1 Dz.U. 2025 poz. 1899 (losowa próba 100 obowiązujących rozporządzeń: 713 paragrafów, 0 błędnych brzmień). Rozporządzenie można też wskazać tytułem, z organem i datą albo bez: § 2 rozporządzenia Ministra Sprawiedliwości z dnia 22 października 2015 r. w sprawie opłat za czynności adwokackie, § 2 rozporządzenia w sprawie opłat za czynności radców prawnych. Wyszukiwarka ELI musi zwrócić rozporządzenie niezmieniające o identycznym przedmiocie; podane organ i data muszą się zgadzać; kilka obowiązujących trafień — odmowa z kandydatami. Losowa próba 100 obowiązujących rozporządzeń (29.10.2026, testy/rozporzadzenie_tytul.py --proba 100): pełny tytuł prowadzi do tego samego aktu w 100 na 100 przypadków, tytuł bez daty w 99 (1 odmowa: kilka rozporządzeń o tym przedmiocie), 0 przypadków innego aktu. Akty z Monitora Polskiego (uchwały, zarządzenia, regulaminy) — adresem: art. 6 ust. 1 M.P. 2022 poz. 990, art. 6 MP/1992/185; Regulamin Sejmu także jako art. 7 ust. 1 Regulaminu Sejmu (29.10.2026: 196 artykułów, 0 odmów). Umowy międzynarodowe (np. EKPCz, Dz.U. 1993 nr 61 poz. 284) — odmowa: ELI ma je tylko w PDF drukowanym dwujęzycznie w dwóch kolumnach, a odczyt nie jest wiarygodny; odpowiedź podaje link do wiążącego PDF. Pełne pokrycie wszystkich 1127 obowiązujących ustaw merytorycznych spoza listy (28.10.2026): 71 174 artykułów, 0 błędnych brzmień. Losowa próba 100 obowiązujących ustaw spoza listy (28.10.2026): 6314 artykułów, 0 błędnych brzmień, 0 odmów, 1 jawna niejednoznaczność (testy/pokrycie_proba.py).

Uruchomienie lokalne (stdio — Claude Desktop / Claude Code)

pip install -e .
legal-cite          # stdio

Wpis w claude_desktop_config.json:

{ "mcpServers": { "legal-cite": { "command": "legal-cite" } } }

Deploy na Cloud Run (streamable-http — współdzielony URL)

gcloud run deploy legal-cite \
  --source=. \
  --region=europe-west4 \
  --allow-unauthenticated \
  --memory=512Mi --cpu=1 --max-instances=1 --timeout=300 --port=8080

Publiczny bez auth jest tu bezpieczny — serwis serwuje wyłącznie publiczne teksty aktów (zero danych, zero bazy, zero wywołań LLM).

Podłączenie w Claude: Connectors → Add custom connector → https://<adres-serwisu>.run.app/mcp.

Ekosystem / Related

Część zestawu otwartych narzędzi LegalTech (PL):

• legal-cite-pl — (ten projekt) MCP: weryfikacja brzmienia przepisu PL/UE ze źródła.

• commercial-legal-pl — Claude skill: redakcja i analiza umów (PL); używa verify_article.

• anon-legal-pl — lokalna anonimizacja akt prawnych (PL).

• kancelaria-dms — DMS/CRM dla kancelarii (Google Workspace).

License

Apache License 2.0 — see LICENSE.