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
passedi 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 agent | Cał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 powrotem | Gotową odpowiedź ze źródłami | Jeden 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 statystyk | Gdy 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
offsetilimit. Najważniejsze adresy:/sejm/term10/votings/{posiedzenie}/{numer}(wynik ivotes[]),/sejm/term10/processes/{druk}(etapy,passed,ELI,displayAddress),/sejm/term10/interpellations/{numer}i/sejm/term10/writtenQuestions/{numer}(replies[]z flagamiprolongationionlyAttachment) oraz/sejm/term10/MP/{id}/votings/stats(frekwencja z polemabsenceExcuse). - Rozpoznawanie głosowań. Pole
kindprzyjmuje wartościELECTRONIC,TRADITIONALlubON_LIST. PrzyON_LISTgłos posła ma wartośćVOTE_VALID, a wybory są wlistVotes. Głosowanie kworum rozpoznasz po wartościachPRESENTi niezerowym polupresent. - MCP. Klient pobiera listę narzędzi serwera żądaniem
tools/list(każde ma nazwę, opis i schemat parametrówinputSchema), a model wywołuje je przeztools/call, kiedy uzna to za potrzebne. - x402 (wersja 2). Serwer zwraca
402z nagłówkiemPAYMENT-REQUIRED, w którym zakodowane w Base64 są warunki: schemat, cena, sieć i adres odbiorcy. Klient ponawia żądanie z nagłówkiemPAYMENT-SIGNATURE, a serwer po rozliczeniu dołącza nagłówekPAYMENT-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
- Dokumentacja API Sejmu
- Specyfikacja OpenAPI API Sejmu
- Dokumentacja API ELI (akty prawne)
- API Sejmu: proces legislacyjny druku 1749
- Ustawa o ogłaszaniu aktów normatywnych, tekst jednolity Dz.U. 2019 poz. 1461 (ISAP)
- Model Context Protocol: wprowadzenie
- Model Context Protocol: specyfikacja narzędzi (tools)
- Anthropic: Introducing the Model Context Protocol (25.11.2024)
- RFC 9110, 402 Payment Required
- x402: otwarty standard płatności przez HTTP
- x402: HTTP 402 i nagłówki protokołu
- Linux Foundation: uruchomienie x402 Foundation (14.07.2026)
- Stripe Docs: Machine Payments Protocol
- Stripe: Introducing the Machine Payments Protocol (18.03.2026)
- MPP: sesje i płatności strumieniowe
- Stripe Docs: Shared Payment Tokens
Udostępnij poradnik
Nowe ustawy w Twojej skrzynce.
Raz w tygodniu: co zmieniło się w Sejmie w Twojej branży.
