mcp-sejm-proces

MCP server dla polskiego procesu legislacyjnego (druki sejmowe + historia procesu) przez oficjalne, bezpłatne API Sejmu RP (api.sejm.gov.pl). Zero kluczy API.

Autor: Piotr Waśniowski, Legal Link.

Domyka trójkę z Twoim mcp-isap (ustawy, Dz.U./M.P.) i mcp-eu-sparql/mcp-saos/mcp-nsa (orzecznictwo) — ten sam kontrakt structuredContent.citations, ten sam wzorzec kodów błędów, ten sam drift test.

Tools

• search_prints(title, term?, limit?) — szuka druków po fragmencie tytułu. API Sejmu nie filtruje po swojej stronie — ten tool ściąga pełną listę druków danej kadencji (~1.7 MB, kilka tysięcy pozycji) i filtruje lokalnie. Wynik cache'owany 10 minut.
• get_print(nr, term?) — metadane druku: tytuł, daty, załączniki PDF, numer procesu.
• get_process(nr, term?) — serce serwera: pełna historia procesu legislacyjnego — etapy (czytania, prace komisji, głosowania), czy przyjęty, link do RCL, i ELI wynikowego aktu jeśli proces zakończył się publikacją.

Domyślna kadencja: 10 (aktualna od 13.11.2023) — sprawdź, czy to się nie zmieniło, jeśli uruchamiasz ten serwer po kolejnych wyborach.

Domykanie pętli z mcp-isap

get_process zwraca ELI (np. "DU/2024/1635"), gdy proces zakończył się publikacją aktu. To ten sam identyfikator, który przyjmuje mcp-isap.get_act / get_act_text — droga "druk → proces → aktualny tekst ustawy" jest teraz w pełni przejezdna między tymi dwoma serwerami.

Ważne pułapki (potwierdzone empirycznie, 2026-08-05)

• Nie każdy druk ma własny proces. HTTP 404 na get_process dla realnie istniejącego druku jest normalne (np. pisma dodatkowe, część raportów) — nie jest to błąd serwera. Sprawdzone na żywo: druk 200 i 400 (kadencja 10) nie mają procesu, druk 300 ma proces, ale passed: false i brak ELI.
• passed: false nie znaczy "odrzucony przez Sejm". Dla dokumentów typu "informacja rządowa" czy "lista kandydatów" to pole bywa false, bo takie dokumenty nie "przechodzą" w sensie ustawodawczym — to nie jest głosowanie, które przegrało.
• Numer druku z sufiksem to inny dokument. "23-A" (pismo dodatkowe do druku 23) ≠ "23" — potwierdzone na żywym API (term9/prints/23-A zwraca inny tytuł).

Build + run

npm install
npm run build
npm start                 # stdio transport

npm run drift              # offline - spójność INSTRUCTIONS/TOOLS/ErrorCode
npm run test:offline       # offline - walidacja, formatowanie, fixtures z żywych odpowiedzi
npm run smoke               # LIVE - api.sejm.gov.pl (brak udokumentowanego dziennego limitu)

Konfiguracja Claude Desktop

{
  "mcpServers": {
    "sejm-proces": {
      "command": "node",
      "args": ["<ścieżka>/mcp-sejm-proces/dist/index.js"]
    }
  }
}

License

MIT.