Przejdź do treści

Dane Sejmu w agencie AI: MCP, x402 i MPP bez żargonu

Sejm publikuje swoje dane w otwartym API pod adresem api.sejm.gov.pl, ale surowe dane łatwo źle odczytać. MCP (Model Context Protocol) to wspólny standard, dzięki któremu asystent AI, np. Claude albo ChatGPT, korzysta z zewnętrznych narzędzi. Serwer MCP Legislo działa już w każdym planie: narzędzie „ask” przyjmuje całe pytanie i zwraca odpowiedź ze źródłami, a osiem zapytań o dane zwraca po jednym rekordzie: posła, głosowanie, druk, proces legislacyjny, frekwencję albo interpelację. Płatności za pojedyncze wywołania przez x402 i MPP jeszcze nie działają, a ich cen nie ustalono.

Poradnik · 9 min czytania · aktualizacja:

Najważniejsze w skrócie

  • API Sejmu (api.sejm.gov.pl) jest otwarte i dostępne bez logowania, a opisuje je specyfikacja OpenAPI.
  • Surowe dane mają pułapki: dwa kształty głosowań, „uchwalona” to nie „obowiązuje”, te same numery interpelacji i zapytań.
  • MCP to wspólny standard podłączania narzędzi do asystentów AI, coś jak port USB-C dla aplikacji AI.
  • Serwer MCP Legislo (mcp.legislo.pl) działa w każdym planie: narzędzie „ask” z odpowiedzią ze źródłami i osiem zapytań o dane Sejmu.
  • x402 i MPP pozwolą autonomicznym agentom płacić za pojedyncze wywołania. W Legislo to plan na przyszłość, bez ustalonych cen.

Skąd agent AI może wziąć dane o Sejmie?

Z oficjalnego API Sejmu pod adresem api.sejm.gov.pl. API to sposób, w jaki programy pobierają dane bezpośrednio, bez przeglądania stron internetowych. API Sejmu jest otwarte: dane pobierasz bez logowania, a całość opisuje specyfikacja OpenAPI (https://api.sejm.gov.pl/sejm/openapi), czyli plik, z którego programy same odczytują, jakie adresy i pola są dostępne.

Znajdziesz tam m.in. posłów i ich statystyki głosowań, kluby i koła, głosowania z głosem każdego posła, druki sejmowe z załącznikami, przebieg procesów legislacyjnych, interpelacje i zapytania z odpowiedziami, komisje, posiedzenia i transmisje. Osobne API ELI (https://api.sejm.gov.pl/eli) udostępnia akty prawne ogłoszone w Dzienniku Ustaw i Monitorze Polskim; np. adres …/eli/acts/DU/2026/62 zwraca opis ustawy budżetowej na 2026 r. z datą ogłoszenia i wejścia w życie.

Dlaczego surowe dane Sejmu trudno wykorzystać?

Dane Sejmu są rzetelne, ale żeby je poprawnie odczytać, trzeba znać procedurę. Oto pięć pułapek, na które trafiają i ludzie, i modele językowe:

  • Dwa kształty głosowań. Zwykłe głosowanie ma liczniki za, przeciw i wstrzymujących się oraz głos każdego posła. Głosowanie na listę, np. wybór Marszałka Sejmu, ma te liczniki zerowe, a wynik jest zapisany osobno dla każdej kandydatury (votingOptions, listVotes). Program, który zna tylko pierwszy kształt, uzna wybory za głosowanie, w którym nikt nie głosował.
  • „Uchwalona” to nie „obowiązuje”. W danych procesu legislacyjnego pole passed i końcowy etap „Uchwalono” pojawiają się, gdy ustawę uchwali Sejm, i zostają nawet po wecie prezydenta. Ustawa obowiązuje dopiero po ogłoszeniu w Dzienniku Ustaw. Potwierdza to adres publikacji, np. „Dz.U. 2026 poz. 62”. Adres zaczynający się od „M.P.” oznacza Monitor Polski, w którym ogłasza się m.in. uchwały Sejmu, a nie ustawy.
  • Te same numery. Interpelacje i zapytania poselskie mają osobne numeracje, więc interpelacja nr 1000 i zapytanie nr 1000 to dwa różne dokumenty. Sam numer, bez rodzaju sprawy, niczego nie przesądza.
  • Treść w PDF i prolongaty. Wiele odpowiedzi ministrów istnieje tylko jako załącznik PDF, a część „odpowiedzi” to zawiadomienia o przedłużeniu terminu, bez żadnej treści.
  • Kluby się zmieniają. Przy każdym głosowaniu zapisany jest klub posła z dnia głosowania. W trakcie kadencji posłowie przechodzą między klubami, a kluby i koła powstają i znikają, więc zestawienia „według klubów” trzeba liczyć głosowanie po głosowaniu.

Szczegóły znajdziesz w poradnikach Jak sprawdzić, jak głosował poseł w Sejmie i Interpelacja a zapytanie poselskie.

Czym jest MCP?

MCP (Model Context Protocol) to otwarty standard łączenia aplikacji AI z zewnętrznymi systemami: bazami danych, narzędziami i usługami. Opublikowała go firma Anthropic w listopadzie 2024 r., a dziś obsługują go m.in. Claude i ChatGPT. Dokumentacja MCP porównuje go do portu USB-C: tak jak jedno gniazdo pasuje do wielu urządzeń, tak jeden sposób podłączenia pozwala asystentowi AI korzystać z wielu źródeł danych.

Dla Ciebie oznacza to, że nie musisz kopiować danych do okna czatu. Podłączasz do asystenta serwer MCP, czyli usługę, która udostępnia opisane narzędzia, a asystent sam po nie sięga, gdy zadajesz pytanie.

Jak działa serwer MCP Legislo?

Legislo ma jeden serwer MCP pod adresem https://mcp.legislo.pl, w cenie każdego planu abonamentu. Udostępnia dziewięć narzędzi dwóch rodzajów:

Narzędzie „ask”Zapytania o dane
Co przekazuje Twój agentCałe pytanie, np. „Jak kluby głosowały nad ostatnią ustawą budżetową?”Wywołanie konkretnego narzędzia, np. get_voting z numerem posiedzenia i głosowania
Co dostaje z powrotemGotową odpowiedź ze źródłamiJeden rekord w uporządkowanej postaci: poseł (find_mp), głosowanie z podziałem na kluby (get_voting), głosy posła (get_mp_vote_record), frekwencja (get_mp_attendance), druk (get_print), proces legislacyjny (get_process), interpelacja (get_interpellation) albo lista interpelacji posła (get_mp_interpellations)
Kiedy je wybraćGdy chcesz dostać gotową odpowiedź, którą da się sprawdzić u źródła, także do porównań i statystykGdy Twój agent zna już numer i sam łączy dane z innymi źródłami, a wnioski wyciąga sam

Połączysz się na dwa sposoby: przez zalogowanie kontem Legislo (OAuth; w Claude czy ChatGPT dodajesz Legislo jako własny konektor) albo kluczem API wygenerowanym na stronie konta. Pytanie przekazane narzędziu ask kosztuje tyle kredytów z puli zespołu, co pytanie w czacie, a pojedyncze zapytanie o dane znacznie mniej. Kredyty są naliczane raz, po udanym wywołaniu. Narzędzia nie przyjmują zapytań SQL i niczego nie zapisują.

Jak to wygląda w praktyce? Pytasz swojego asystenta: „Jak kluby głosowały nad ostatnią ustawą budżetową?”, a on przekazuje pytanie narzędziu ask i dostaje odpowiedź ze źródłami: ustawa budżetowa na 2026 r. (druk 1749, Dz.U. 2026 poz. 62) przeszła na 47. posiedzeniu, w głosowaniu nr 99: 233 za, 197 przeciw, 0 wstrzymujących się. Na stronie dla agentów zobaczysz, jak to przebiega krok po kroku.

Czym są x402 i MPP?

Abonament sprawdza się, gdy z usługi korzystają ludzie albo agent, którego ktoś skonfigurował na swoim koncie. Agent działający samodzielnie, który trafia na usługę po raz pierwszy, potrzebuje innego sposobu: zapłacić od razu za to jedno wywołanie. Do tego służą x402 i MPP, dwa otwarte protokoły płatności za pojedyncze wywołania. Oba korzystają z kodu odpowiedzi HTTP 402 Payment Required („wymagana płatność”), który standard HTTP od lat rezerwuje „do przyszłego użytku” (RFC 9110).

x402 działa tak: agent prosi o dane, serwer odpowiada kodem 402 i podaje cenę, agent płaci (zwykle w stablecoinach, czyli kryptowalutach, których kurs jest powiązany z walutą tradycyjną, np. dolarem) i ponawia prośbę z dowodem zapłaty. Konto u sprzedawcy nie jest potrzebne. Protokół stworzył Coinbase, a od lipca 2026 r. rozwija go x402 Foundation działająca przy Linux Foundation (x402.org).

MPP (Machine Payments Protocol) to protokół współtworzony przez Stripe i Tempo, ogłoszony 18 marca 2026 r. Działa według podobnego schematu (kod 402 z warunkami płatności, płatność, ponowienie prośby i potwierdzenie) i obsługuje m.in. stablecoiny oraz karty przez Shared Payment Tokens, czyli tokeny dające sprzedawcy ograniczony dostęp do metody płatności klienta (docs.stripe.com). Pozwala też otworzyć sesję z limitem wydatków: agent z góry deponuje określoną kwotę, a potem płaci z niej za kolejne wywołania, bez osobnej transakcji za każde (mpp.dev).

Dla programistów: jak to wygląda technicznie?

  • API Sejmu. REST i JSON, bez uwierzytelniania; listy stronicuje się parametrami offset i limit. Najważniejsze adresy: /sejm/term10/votings/{posiedzenie}/{numer} (wynik i votes[]), /sejm/term10/processes/{druk} (etapy, passed, ELI, displayAddress), /sejm/term10/interpellations/{numer} i /sejm/term10/writtenQuestions/{numer} (replies[] z flagami prolongation i onlyAttachment) oraz /sejm/term10/MP/{id}/votings/stats (frekwencja z polem absenceExcuse).
  • Rozpoznawanie głosowań. Pole kind przyjmuje wartości ELECTRONIC, TRADITIONAL lub ON_LIST. Przy ON_LIST głos posła ma wartość VOTE_VALID, a wybory są w listVotes. Głosowanie kworum rozpoznasz po wartościach PRESENT i niezerowym polu present.
  • MCP. Klient pobiera listę narzędzi serwera żądaniem tools/list (każde ma nazwę, opis i schemat parametrów inputSchema), a model wywołuje je przez tools/call, kiedy uzna to za potrzebne.
  • x402 (wersja 2). Serwer zwraca 402 z nagłówkiem PAYMENT-REQUIRED, w którym zakodowane w Base64 są warunki: schemat, cena, sieć i adres odbiorcy. Klient ponawia żądanie z nagłówkiem PAYMENT-SIGNATURE, a serwer po rozliczeniu dołącza nagłówek PAYMENT-RESPONSE.
  • MPP. Przepływ ma trzy części: wyzwanie (challenge) w odpowiedzi 402, poświadczenie płatności (credential) w ponowionym żądaniu i potwierdzenie (receipt) w odpowiedzi z zasobem (mpp.dev).

Jak sprawdzić odpowiedź agenta AI o Sejmie?

Niezależnie od narzędzia wymagaj identyfikatorów, które da się sprawdzić u źródła: numeru posiedzenia i głosowania, numeru druku oraz adresu publikacji aktu. Głosowanie znajdziesz na sejm.gov.pl w „Głosowaniach na posiedzeniach Sejmu”, druk w „Przebiegu procesu legislacyjnego”, a ogłoszoną ustawę w ISAP, bazie aktów prawnych prowadzonej przez Kancelarię Sejmu. Odpowiedź bez takich numerów trudno zweryfikować.

Jakie dane o Sejmie obejmuje Legislo?

Legislo obejmuje 10. kadencję Sejmu, od 13 listopada 2023 r. Kopiuje dane z oficjalnego API Sejmu i odświeża je na bieżąco. W bazie są:

  • posłowie (460 mandatów i 499 osób, które sprawowały mandat w tej kadencji) oraz kluby i koła;
  • ponad 4 600 głosowań i ponad 2,1 mln indywidualnych głosów;
  • ponad 3 200 druków z załącznikami i ponad 1 600 procesów legislacyjnych z ich etapami;
  • interpelacje i zapytania z odpowiedziami ministrów, frekwencja z nieobecnościami usprawiedliwionymi oraz wyszukiwanie semantyczne, czyli według znaczenia, w dokumentach.

Dane o komisjach sejmowych i stenogramy obrad, które API Sejmu także udostępnia, są w Legislo planowane, ale jeszcze niedostępne. Już dziś Legislo odpowiada w czacie w języku pytania, po polsku lub angielsku, wyłącznie na podstawie zgromadzonych danych: głosowania podaje jako posiedzenie i numer, druki po numerze, a gdy źródło jest skopiowane tylko częściowo, mówi o tym.

Źródła

Udostępnij poradnik

Nowe ustawy w Twojej skrzynce.

Raz w tygodniu: co zmieniło się w Sejmie w Twojej branży.

Wyślemy link potwierdzający. Wypiszesz się jednym kliknięciem. Polityka prywatności.

Najczęstsze pytania

Zapytaj o to Legislo.

Agent zna głosowania, druki i przebieg procesów X kadencji i przy każdej liczbie podaje źródło.

+48 516 157 681kontakt@legislo.pllinkedin.com/company/legislo@legislopl