Firmogram dla asystentów AI
MCP · OpenAPI · bezpłatneSerwer 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):
- Ustawienia → Konektory → Dodaj własny konektor.
- Wklej adres powyżej i zapisz (bez autoryzacji).
- W rozmowie włącz konektor ikoną narzędzi i pytaj, np. „Sprawdź kontrahenta o NIP [wklej numer]”.
ChatGPT (tryb deweloperski, plan Plus/Pro):
- Ustawienia → Aplikacje i konektory → Utwórz (tryb deweloperski).
- Wklej adres serwera MCP powyżej (bez autoryzacji) i zapisz.
- 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ędzie | Co robi |
|---|---|
firmogram_szukaj_firm | Wyszukiwanie 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_firmy | Pełny profil po KRS/NIP: siedziba, data rejestracji, kapitał, zarząd, wspólnicy z udziałami, prokura, PKD i wynik ryzyka (A–E). |
firmogram_powiazania | Graf powiązań: wspólnicy i zarząd → inne spółki, w których uczestniczą (1–3 poziomy). |
firmogram_historia_wpisow | Chronologia wpisów KRS z odpisu pełnego — daty, opisy, sygnatury sądów; działa też dla wykreślonych podmiotów. |
firmogram_sprawdz_vat | Biała lista VAT (MF) po NIP: status VAT i zweryfikowane rachunki bankowe. |
firmogram_vies | VIES: rejestracja numeru VAT-UE w kraju UE. |
firmogram_zdarzenia | Strumień zdarzeń rejestrowych KRS z filtrami (podmiot, typ, fraza). |
firmogram_kraz | Rejestr agencji zatrudnienia (KRAZ) z bieżącym statusem wpisu. |
firmogram_licencje | Licencje transportowe GITD (TU-/OU-) z flagą aktywności. |
firmogram_akta_rejestrowe | Akta rejestrowe (Repozytorium MS): stan dostępności i urzędowy link — bez fikcyjnej listy spraw. |
firmogram_dokumenty_finansowe | Katalog dokumentów finansowych z repozytorium MS (XML/PDF/XHTML) z datami i stanem odczytu. |
firmogram_finanse | Metryki finansowe z e-sprawozdań XML: bilans, RZiS i wskaźniki per rok obrotowy. |
firmogram_statystyki | Statystyki 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
Problemy z podłączeniem? Napisz do nas. Specyfikacja techniczna API: Dokumentacja API.