Dane o sądach dla programów i asystentów AI

Serwer MCP

MCP (Model Context Protocol) to otwarty standard, przez który asystent AI wywołuje narzędzia z zewnętrznych serwisów. Podłącz nasz serwer, a asystent sam pobierze liczby z bazy, zamiast zgadywać.

Adres: https://cpdp.media/sady/mcp

Transport: streamable HTTP. Bez sesji: każde wywołanie to jedno żądanie POST z odpowiedzią JSON. Wszystkie narzędzia tylko czytają.

Claude Code

claude mcp add --transport http sady https://cpdp.media/sady/mcp

Claude (aplikacja i claude.ai)

Ustawienia → Łączniki (Connectors) → Dodaj własny łącznik → wklej adres https://cpdp.media/sady/mcp.

Cursor: ~/.cursor/mcp.json

{ "mcpServers": { "sady": { "url": "https://cpdp.media/sady/mcp" } } }

VS Code: .vscode/mcp.json

{ "servers": { "sady": { "type": "http", "url": "https://cpdp.media/sady/mcp" } } }

Opis serwisu dla modeli językowych leży w llms.txt.

Przykładowe pytania do asystenta

• Ile trwają sprawy cywilne w Sądzie Rejonowym w Zabrzu i jak to się zmieniało?
• Który sąd jest właściwy dla Wieliczki?
• Ile spraw wpłynęło do Sądu Okręgowego w Krakowie według MS w 2025 roku?
• Jakie organizacje dostały najwięcej pieniędzy z wyroków karnych w 2023 roku?
• W ilu opublikowanych orzeczeniach orzekał dany sędzia i jak kończyły się apelacje od jego wyroków?

Narzędzia

Każda odpowiedź ma te same pola obok danych: zrodlo, stan_danych, okres, zastrzezenia, adres (strona w serwisie) i jak_cytowac. Dzięki temu asystent dostaje zastrzeżenia razem z liczbą.

Listy mają najwyżej 50 wierszy. Narzędzie sql przyjmuje jedno zapytanie SELECT, oddaje najwyżej 500 wierszy i przerywa zapytanie po 3 sekundach.

Przykłady curl

Lista narzędzi:

curl -s -X POST https://cpdp.media/sady/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Profil sądu:

curl -s -X POST https://cpdp.media/sady/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"sad","arguments":{"slug":"sad-okregowy-w-krakowie"}}}'

Własne zapytanie SQL:

curl -s -X POST https://cpdp.media/sady/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
       "params":{"name":"sql","arguments":{"zapytanie":"SELECT type, COUNT(*) FROM court GROUP BY type"}}}'

API JSON (Datasette)

Wszystkie tabele bazy są też w Datasette. Dopisz .json do adresu tabeli albo zapytania, a dostaniesz JSON. Filtry działają jak w interfejsie, np. type__exact=okregowy.

curl -s 'https://cpdp.media/sady/dane/sady/court.json?_shape=array&type__exact=okregowy'

curl -s 'https://cpdp.media/sady/dane/sady.json?_shape=array&sql=select+name,+slug+from+court+where+type=%27apelacyjny%27'

Datasette przerywa zapytanie po 5 sekundach i oddaje najwyżej 1000 wierszy naraz. Kolejne strony pobierzesz z pola next_url.

Główne tabele

Surowe tabele nie mają naszych filtrów. Żeby liczyć orzeczenia jak serwis, dodaj warunek:

j.judgment_date IS NOT NULL
AND j.quality_flag IN ('ok', 'bad_signature', 'bad_duration')
AND (j.judgment_type IS NULL OR j.judgment_type <> 'REASONS')

Opis kolumn znajdziesz przy każdej tabeli w Datasette, a sposób liczenia w metodologii.

Jak cytować

Podaj nas jako źródło i dopisz okres, którego dotyczy liczba. Gotowy przypis:

Źródło: sady (cpdp.media/sady), na podstawie orzeczeń opublikowanych w SAOS i danych MS; stan danych na 13.10.2026.

Nasze zestawienia udostępniamy na licencji CC BY 4.0: możesz je kopiować i przerabiać, także komercyjnie, jeśli podasz źródło. Teksty orzeczeń pochodzą z SAOS.

Linkuj do konkretnej strony sądu albo sędziego. W odpowiedzi MCP jej adres jest w polu adres. Pełny tekst orzeczenia jest w SAOS, link w polu saos.

Czego dane nie pokazują

• Liczymy tylko orzeczenia opublikowane w SAOS, nie wszystkie sprawy. Od 2019 r. sądy publikują ich coraz mniej.
• Czas sprawy to szacunek: z sygnatury znamy tylko rok wpisania. Liczymy do pierwszego orzeczenia, nie do uprawomocnienia.
• Bieżący rok jest niepełny, a ostatnie lata mają zaniżony czas sprawy, bo długie sprawy jeszcze trwają.
• Wpłaty to kwoty zasądzone, nie wpłacone. Odczytuje je program z sentencji, więc może się pomylić.
• Apelacje: widzimy tylko te, w których sentencja wskazuje zaskarżone orzeczenie, a ono jest w SAOS.
• Dane MS obejmują wszystkie sprawy sądu, a wskaźniki apelacji opisują całą apelację, nie jeden sąd.
• Te dane nie mierzą jakości pracy sądu ani sędziego. Nie układaj z nich rankingów „najlepszych” i „najgorszych”.
• Model językowy może dodać do odpowiedzi wiedzę spoza tych danych. Sprawdzaj liczby na stronie z pola „adres”.

Wszystkie ograniczenia danych