Ładuję wyniki…
Serwis informacyjny na otwartych danych rejestrów publicznych RODO Regulamin
Firmogram

Firmogram dla asystentów AI

MCP · OpenAPI · bezpłatne
Podłącz Firmogram do Claude lub ChatGPT i pytaj o polskie firmy wprost w czacie: wyszukiwanie po nazwie/NIP/KRS, profil z wynikiem ryzyka, graf powiązań, historia wpisów, biała lista VAT, VIES, zdarzenia rejestrowe, KRAZ i licencje transportowe. Serwis mówi do asystenta przez otwarty protokół MCP (Model Context Protocol).

Serwer MCP — podłączenie w 2 minuty

Adres serwera (Streamable HTTP, bez konta i bez logowania):

https://firmogram.pl/mcp

Claude (aplikacja desktop lub claude.ai):

  1. Ustawienia → Konektory → Dodaj własny konektor.
  2. Wklej adres powyżej i zapisz (bez autoryzacji).
  3. W rozmowie włącz konektor ikoną narzędzi i pytaj, np. „Sprawdź kontrahenta o NIP [wklej numer]”.

ChatGPT (tryb deweloperski, plan Plus/Pro):

  1. Ustawienia → Aplikacje i konektory → Utwórz (tryb deweloperski).
  2. Wklej adres serwera MCP powyżej (bez autoryzacji) i zapisz.
  3. Konektor włączasz per rozmowa; ChatGPT sam dobierze narzędzie.

Inny klient MCP (Cursor, VS Code, własny agent): wystarczy wskazać ten sam adres — transport Streamable HTTP.

GPT z akcją — Firmogram jako własny GPT w ChatGPT

Alternatywa dla konektora: w kreatorze GPT (chatgpt.com/gpt/editor) → Utwórz akcję → importuj specyfikację https://firmogram.pl/openapi.json. Autoryzacja: API Key — nagłówek X-API-Key z wartością klucza z Moje konto (klucz jest bezpłatny, zakładając konto na Firmogramie). Gotową instrukcję skopiuj z sekcji na dole tej strony.

Narzędzia (tylko odczyt)

NarzędzieCo robi
firmogram_szukaj_firmWyszukiwanie w KRS i pełnym rejestrze PRS — rozpoznaje NIP, KRS, REGON, kod PKD, kod pocztowy, miejscowość, nazwisko osoby w organach lub nazwę firmy.
firmogram_profil_firmyPełny profil po KRS/NIP: siedziba, data rejestracji, kapitał, zarząd, wspólnicy z udziałami, prokura, PKD i wynik ryzyka (A–E).
firmogram_powiazaniaGraf powiązań: wspólnicy i zarząd → inne spółki, w których uczestniczą (1–3 poziomy).
firmogram_historia_wpisowChronologia wpisów KRS z odpisu pełnego — daty, opisy, sygnatury sądów; działa też dla wykreślonych podmiotów.
firmogram_sprawdz_vatBiała lista VAT (MF) po NIP: status VAT i zweryfikowane rachunki bankowe.
firmogram_viesVIES: rejestracja numeru VAT-UE w kraju UE.
firmogram_zdarzeniaStrumień zdarzeń rejestrowych KRS z filtrami (podmiot, typ, fraza).
firmogram_krazRejestr agencji zatrudnienia (KRAZ) z bieżącym statusem wpisu.
firmogram_licencjeLicencje transportowe GITD (TU-/OU-) z flagą aktywności.
firmogram_akta_rejestroweAkta rejestrowe (Repozytorium MS): stan dostępności i urzędowy link — bez fikcyjnej listy spraw.
firmogram_dokumenty_finansoweKatalog dokumentów finansowych z repozytorium MS (XML/PDF/XHTML) z datami i stanem odczytu.
firmogram_finanseMetryki finansowe z e-sprawozdań XML: bilans, RZiS i wskaźniki per rok obrotowy.
firmogram_statystykiStatystyki serwisu i oficjalne źródła danych.

Dane i prywatność

Asystent wysyła do Firmogramu wyłącznie parametry wywołań narzędzi — numer NIP/KRS, nazwę, kod PKD. Nie potrzebujemy danych osobowych i ich nie zbieramy; nie widzimy Twojej rozmowy z asystentem (podlega ona polityce dostawcy asystenta). Po naszej stronie zapisujemy tylko techniczny dziennik wywołań: narzędzie, czas wykonania i adres IP (bez treści zapytania) — dla ochrony przed nadużyciami. Dane firm pochodzą z jawnych rejestrów publicznych: KRS (MS), wykaz podatników VAT (MF), VIES (KE), KRAZ (MRPiPS), licencje (GITD).

Limity i fair use

Bez konta: do 30 wywołań na minutę i 300 na godzinę z jednego adresu IP. Z nagłówkiem X-API-Key (klucz z konta) obowiązują limity taryfy — w planie bezpłatnym w zupełności starcza na normalną pracę z asystentem. Dane rejestrów są keszowane po naszej stronie, żeby nie obciążać systemów urzędowych.

Przykładowe pytania

  • „Co wiadomo o spółce o NIP [numer]? Podaj zarząd, wspólników i wynik ryzyka.”
  • „Sprawdź NIP [numer] na białej liście VAT i podaj zweryfikowane rachunki.”
  • „Z kim kapitałowo powiązana jest spółka o KRS [numer]?”
  • „Jak zmieniały się organy tej spółki w ostatnich latach?” (historia wpisów)
  • „Kto w Polsce prowadzi działalność PKD 62.01.Z — programowanie?”
  • „Czy agencja zatrudnienia o numerze wpisu [numer] ma aktualny status?”
Instrukcja dla własnego GPT — skopiuj do kreatora
Jesteś asystentem ds. weryfikacji polskich firm, oparty o API Firmogram (firmogram.pl) — oficjalne dane KRS, białej listy VAT, VIES, KRAZ i GITD. Zasady: 1. Po nazwie lub numerze firmy (NIP/KRS/REGON) zawsze najpierw wywołaj searchCompanies (GET /api/search?q=...) — rozpoznaje on automatycznie typ identyfikatora. 2. Profil firmy pobieraj getCompany (GET /api/firma/{krs}) — zawiera zarząd, wspólników z udziałami, PKD i wynik ryzyka (0–100; klasy A≥80, B≥65, C≥45, D≥25, E<25). 3. Przy weryfikacji kontrahenta do płatności sprawdź też checkVatWhitelist (status VAT + rachunki) i, dla VAT-UE, checkVies. 4. Powiązania kapitałowe i osobowe pokazuje getCompanyGraph (depth=2 dla pełniejszego obrazu). 5. Zmiany w firmie i jej przeszłość — getCompanyHistory (historia wpisów KRS). 6. Numery KRS podawaj jako 10 cyfr (uzupełnij zerami z lewej), NIP — 10 cyfr. 7. Imiona i nazwiska osób podawaj dokładnie tak, jak zwraca API — gdy dane zawierają pełne nazwiska (źródło PRS), podawaj je w całości; gdy widzisz wzorzec z gwiazdkami (zanonimizowany), nie zgaduj pełnych nazwisk. 8. Zawsze podawaj źródło i datę „stan z dnia” z odpowiedzi API. Jeśli API zwróci błąd 404 — powiedz wprost, że podmiotu nie znaleziono w Rejestrze P. 9. Odpowiadaj po polsku, zwięźle, a kluczowe liczby (KRS, NIP, wynik ryzyka, status VAT) wypunktuj.

Problemy z podłączeniem? Napisz do nas. Specyfikacja techniczna API: Dokumentacja API.