AnalizaFirm.pl MCP
Remote MCP server providing access to Polish company data from the National Court Register (KRS), including financial statements, credit ratings, beneficial owners, and VAT lists.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://analizafirm.pl/mcpWhat you can do with it
- Search for companies by name, NIP, or KRS
- Retrieve financial statements and credit ratings
- Identify beneficial owners (CRBR)
- Monitor changes in company records
Source and maintenance
Protocol and capabilities
- Server
- analizafirm 1.3.0
- MCP protocol
- 2025-06-18
- Tools
- 7 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
7 advertised
szukaj_firmy — Szukaj firmy w KRS
Wyszukuje spółki z KRS po nazwie, NIP, numerze KRS albo REGON. Zwraca listę: krs, name, nip, regon, address_city, legal_form. Nie zużywa puli. Użyj najpierw, gdy znasz tylko nazwę firmy — pozostałe narzędzia wymagają numeru KRS.
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Nazwa firmy, NIP, KRS albo REGON (min. 2 znaki)"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Liczba wyników (domyślnie 10)"
}
}
}{
"title": "Szukaj firmy w KRS",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}firma — Komplet danych firmy
Komplet danych spółki z KRS: dane rejestrowe, PKD, kapitał, zarząd i wspólnicy, ocena kondycji A–E (scoring), finanse do 10 lat z wskaźnikami, limit kredytu kupieckiego (kredyt_kupiecki), historia złożeń sprawozdań, postępowania w KRZ, Biała lista VAT z rachunkami, beneficjenci, fakty z informacji dodatkowej, szacunkowa wycena. Kwoty w PLN. Zużywa 1 z puli na firmę w ciągu 24 h; kolejne wywołania dla tej samej firmy w tej dobie (także finanse, sprawozdanie, crbr) są bezpłatne. Podaj krs albo nip.
{
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "Numer KRS (do 10 cyfr, np. 0000028860)"
},
"nip": {
"type": "string",
"description": "NIP (10 cyfr), gdy nie znasz KRS"
}
}
}{
"title": "Komplet danych firmy",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}finanse — Sprawozdania finansowe
Dane finansowe spółki, do 10 lat od najnowszego roku: bilans, rachunek zysków i strat, przepływy pieniężne, wskaźniki (rentowności, ROA, ROE, marża EBITDA w %; wskaznik_zadluzenia jako ułamek). Każdy rocznik ma basis (skonsolidowane/jednostkowe) i source (xml, pdf, esef, raport_gieldowy). Kwoty w PLN. Zużywa pulę jak firma (1 na firmę w 24 h).
{
"type": "object",
"required": [
"krs"
],
"properties": {
"krs": {
"type": "string",
"description": "Numer KRS (do 10 cyfr, np. 0000028860)"
},
"year": {
"type": "integer",
"description": "Rok obrotowy (opcjonalnie; domyślnie najnowszy)"
}
}
}{
"title": "Sprawozdania finansowe",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}sprawozdanie — Pełne sprawozdanie pozycja po pozycji
Pełne sprawozdanie finansowe pozycja po pozycji z kodami pozycji z załącznika nr 1 do ustawy o rachunkowości (np. A.II.1.): bilans, rachunek zysków i strat (wariant porównawczy albo kalkulacyjny), przepływy. value null = brak pozycji w sprawozdaniu (nie zero). Kwoty w PLN. Zużywa pulę jak firma.
{
"type": "object",
"required": [
"krs"
],
"properties": {
"krs": {
"type": "string",
"description": "Numer KRS (do 10 cyfr, np. 0000028860)"
},
"year": {
"type": "integer",
"description": "Rok obrotowy (opcjonalnie; domyślnie najnowszy)"
}
}
}{
"title": "Pełne sprawozdanie pozycja po pozycji",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}crbr — Beneficjenci rzeczywiści (CRBR)
Beneficjenci rzeczywiści spółki z Centralnego Rejestru Beneficjentów Rzeczywistych. Osoby wyłącznie w zakresie rejestru publicznego, ze stałym person_id; nigdy numer PESEL. Zużywa pulę jak firma.
{
"type": "object",
"required": [
"krs"
],
"properties": {
"krs": {
"type": "string",
"description": "Numer KRS (do 10 cyfr, np. 0000028860)"
}
}
}{
"title": "Beneficjenci rzeczywiści (CRBR)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}zmiany — Zmiany u obserwowanych firm
Zmiany od daty since (najwyżej 90 dni wstecz): ocena A–E, nowe postępowanie w KRZ, złożenie sprawozdania, nowy rocznik danych, zarząd (powołania i odwołania), rachunki na Białej liście VAT. Bez krs: firmy z listy obserwowanych subskrypcji (zarządzanej przez REST /api/v1/watchlist); z krs: jedna firma. Zwraca changes[]: krs, name, type, before, after, detected_at, details. Osoby wyłącznie z person_id, nigdy PESEL. Firma ze zmianami = 1 z puli (24 h); firmy bez zmian nie zużywają puli.
{
"type": "object",
"required": [
"since"
],
"properties": {
"krs": {
"type": "string",
"description": "Numer KRS (do 10 cyfr, np. 0000028860)"
},
"since": {
"type": "string",
"description": "Od kiedy: YYYY-MM-DD albo ISO 8601"
},
"types": {
"type": "string",
"description": "Opcjonalnie, po przecinku: ocena, krz, sprawozdanie, dane_finansowe, zarzad, vat"
}
}
}{
"title": "Zmiany u obserwowanych firm",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}katalog — Lista spółek po filtrach
Numery KRS spółek spełniających filtry (te same co eksport /pobierz-dane): region, PKD, forma, kapitał, rok wpisu, ocena A–E, VAT, przetargi, KRZ, przychód, zysk, wycena i metryki finansowe. Zwraca results (same numery KRS), count, next_after (do stronicowania parametrem after), total (tylko na 1. stronie). Dane konkretnej firmy pobierz narzędziem firma. Jedna strona wyników = 1 z puli.
{
"type": "object",
"properties": {
"krz": {
"type": "string",
"description": "Postępowania w KRZ: all, upadlosc albo restrukturyzacja"
},
"vat": {
"type": "string",
"description": "Status VAT po przecinku: czynny, zwolniony, niezarejestrowany, brak"
},
"city": {
"type": "string",
"description": "Miejscowość siedziby"
},
"after": {
"type": "string",
"description": "KRS z next_after poprzedniej strony"
},
"formy": {
"type": "string",
"description": "Formy prawne po przecinku: sp_zoo, sa, psa, sk, ska, sj, sp, spoldzielnia, oddzial, fundacja, stowarzyszenie, inne"
},
"gmina": {
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 10000,
"minimum": 1,
"description": "Wyników na stronę (domyślnie 200)"
},
"ocena": {
"type": "string",
"description": "Oceny A–E po przecinku, np. A,B"
},
"years": {
"type": "string",
"description": "Lata sprawozdań po przecinku, np. 2025,2024"
},
"kod_do": {
"type": "string",
"description": "Kod pocztowy do"
},
"kod_od": {
"type": "string",
"description": "Kod pocztowy od, np. 00-001"
},
"powiat": {
"type": "string"
},
"status": {
"type": "string",
"description": "all = także wykreślone i w likwidacji (domyślnie tylko aktywne)"
},
"krz_dni": {
"enum": [
30,
90,
180,
365
],
"type": "integer",
"description": "Postępowanie w KRZ z ostatnich N dni"
},
"metryki": {
"type": "object",
"description": "Zakresy metryk, np. {\"cagr3\": {\"min\": 20}, \"roe\": {\"min\": 15}}. Klucze: ebit, ebitda, gotowka, kapital_wlasny, suma_bilansowa (PLN), roe, roa, marza_netto, marza_op, zadluzenie, cagr1, cagr3, cagr5 (%). Dotyczy najnowszego sprawozdania firmy",
"additionalProperties": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
}
}
},
"pkd_kod": {
"type": "string",
"description": "Kod PKD, np. 62.01.Z"
},
"category": {
"type": "string",
"description": "Slug branży analizafirm.pl, np. it"
},
"przetargi": {
"type": "boolean",
"description": "true = tylko firmy z zamówieniami publicznymi"
},
"pkd_glowne": {
"type": "boolean",
"description": "Z pkd_kod: true = tylko gdy to PKD przeważające"
},
"profit_max": {
"type": "number"
},
"profit_min": {
"type": "number",
"description": "Zysk netto od (PLN)"
},
"wycena_max": {
"type": "number"
},
"wycena_min": {
"type": "number",
"description": "Szacunkowa wycena od (PLN)"
},
"kapital_max": {
"type": "number"
},
"kapital_min": {
"type": "number"
},
"pkd_section": {
"type": "string",
"description": "Sekcja PKD (litera), np. J"
},
"revenue_max": {
"type": "number"
},
"revenue_min": {
"type": "number",
"description": "Przychody od (PLN)"
},
"voivodeship": {
"type": "string",
"description": "Województwo małymi literami, np. mazowieckie"
},
"rok_wpisu_do": {
"type": "integer"
},
"rok_wpisu_od": {
"type": "integer"
}
}
}{
"title": "Lista spółek po filtrach",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1494 ms
- 95th percentile latency
- 1494 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1494 ms · metadata changed · 7 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http analizafirm-pl-mcp https://analizafirm.pl/mcpCodex
codex mcp add analizafirm-pl-mcp --url https://analizafirm.pl/mcpCursor
{
"mcpServers": {
"analizafirm-pl-mcp": {
"url": "https://analizafirm.pl/mcp"
}
}
}Cline
{
"mcpServers": {
"analizafirm-pl-mcp": {
"type": "streamableHttp",
"url": "https://analizafirm.pl/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"analizafirm-pl-mcp": {
"type": "http",
"url": "https://analizafirm.pl/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http analizafirm-pl-mcp https://analizafirm.pl/mcpClaude Desktop
{
"mcpServers": {
"analizafirm-pl-mcp": {
"url": "https://analizafirm.pl/mcp"
}
}
}Windsurf
{
"mcpServers": {
"analizafirm-pl-mcp": {
"serverUrl": "https://analizafirm.pl/mcp"
}
}
}Let your agent find its tools
Find servers like AnalizaFirm.pl MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other data and analytics servers
Do you run AnalizaFirm.pl MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.