krs-verify — weryfikacja firm u źródła, żeby AI nie zmyślało danych z KRS
Modele językowe potrafią z pełnym przekonaniem podać błędną nazwę spółki, nieaktualny skład zarządu albo zły NIP. Przy oznaczaniu stron umowy to ryzyko prawne, nie kosmetyka. krs-verify łączy asystenta AI wprost z rejestrami państwowymi — KRS Ministerstwa Sprawiedliwości i Białą Listą VAT — i zwraca dane firmy dosłownie ze źródła.
Po co powstało
Przy umowach najwięcej kłopotu robią nie klauzule, tylko komparycja. Wystarczy literówka w numerze KRS albo zarząd sprzed zmiany, by podważyć reprezentację strony. Generyczny asystent AI „pamięta" te dane z treningu — czyli w praktyce zgaduje. krs-verify usuwa zgadywanie: pobiera odpis na żywo i oddaje go bez przetwarzania.
To narzędzie komplementarne do legal-cite-pl. Jedno pilnuje przepisów, drugie — podmiotów. Razem dają komplet: zweryfikowany przepis i zweryfikowana strona umowy.
Jak to działa
Zamiast ufać pamięci modelu, podłączamy go wprost do API rejestrów. Technicznie jest to serwer MCP (Model Context Protocol) — standard, dzięki któremu asystent AI sięga do zewnętrznych narzędzi i danych. krs-verify udostępnia cztery funkcje: verify_entity (po numerze KRS), verify_entity_by_nip, verify_entity_by_regon oraz list_supported_registries.
Dane pochodzą z dwóch oficjalnych źródeł: API KRS (Ministerstwo Sprawiedliwości, odpis aktualny) i Białej Listy VAT (Ministerstwo Finansów). Bez kluczy, wyłącznie dane publiczne.
W praktyce
Tak wygląda jedno zapytanie w asystencie podłączonym do narzędzia:
Przykład użycia (Claude Desktop / Cursor). Asystent nie „pamięta” firmy — pobiera odpis na żywo z KRS.
Co zwraca
Pełną nazwę i formę prawną, numery KRS / NIP / REGON, adres siedziby, organ i sposób reprezentacji, skład zarządu, kapitał zakładowy oraz status. Czyli wszystko, co trafia do komparycji umowy — i co najłatwiej pomylić.
Czego nie obsługuje
Świadomie pomija CEIDG (wymaga klucza) i GUS REGON (wymaga zatwierdzenia wniosku). Biała Lista VAT ma po stronie MF limit 100 zapytań na dobę. Tam, gdzie danych nie da się pobrać u źródła, narzędzie zgłasza błąd — zamiast podstawiać zmyśloną treść.
Jak tego użyć
Narzędzie napisaliśmy w Pythonie, na licencji Apache 2.0. Lokalnie wystarczy wskazać pakiet w konfiguracji klienta MCP:
{
"mcpServers": {
"krs-verify": { "command": "uvx", "args": ["krs-verify"] }
}
}Do pracy zespołowej narzędzie stawia się w trybie HTTP na Google Cloud Run. W parze z legal-cite-pl daje komplet: zweryfikowany przepis i zweryfikowana strona umowy.
⚠️ Zastrzeżenie, o którym mówimy wprost
Dane z API mają charakter informacyjny. Odpis przez API nie zastępuje urzędowego odpisu sądowego tam, gdzie wymaga go prawo lub postanowienie umowne. Zawsze weryfikuj dane z aktualnym odpisem z systemu PRS (prs.ms.gov.pl).
Dlaczego powstało u nas
Nie zamówiliśmy go u zewnętrznego dostawcy, tylko napisaliśmy sami, bo to my potrzebowaliśmy korzystać z AI przy umowach bez ryzyka, że poda zmyśloną stronę. Z tego samego powodu jest otwarte (Apache 2.0): każdy może sprawdzić, jak działa, i dopisać kolejne rejestry wprost w kodzie.
Wdrażasz AI w kancelarii lub firmie?
Chcesz robić to bezpiecznie — zgodnie z AI Act i RODO? Doradzamy w prawie nowych technologii z perspektywy praktyków, którzy te narzędzia tworzą.