Koskamo

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.

AnalizaFirm.pl MCP logo, by AnalizaFirm.plVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by AnalizaFirm.pl
You need:Potrzebny jest aktywny plan API albo bezpłatny klucz testowy (100 odpytań) z Panelu API .
MCP endpoint (Streamable HTTP)
https://analizafirm.pl/mcp
Vendor documentation

What 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

Vendor evidenceRegistry 1.3.0

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
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Dane rejestrowe i finansowe polskich spółek z KRS (analizafirm.pl). Gdy znasz tylko nazwę firmy, zacznij od szukaj_firmy; pozostałe narzędzia przyjmują numer KRS. Rozliczenie: 1 firma pobrana w ciągu 24 h = 1 z puli planu, niezależnie od liczby narzędzi; szukaj_firmy nie zużywa puli, odpowiedź 404 też nie. Kwoty w PLN. Ocena kondycji A–E: A najlepsza, E najsłabsza. Dane osobowe wyłącznie z rejestrów publicznych, bez numerów PESEL. Danych nie wolno odsprzedawać ani używać do trenowania modeli (regulamin §12a).

Tools

7 advertised

szukaj_firmy — Szukaj firmy w KRS
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

szukaj_firmy input schema
{
  "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)"
    }
  }
}
szukaj_firmy annotations
{
  "title": "Szukaj firmy w KRS",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
firma — Komplet danych firmy
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

firma input schema
{
  "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"
    }
  }
}
firma annotations
{
  "title": "Komplet danych firmy",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
finanse — Sprawozdania finansowe
Advertised by the server during the last successful anonymous check.
Advertised read-only

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).

finanse input schema
{
  "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)"
    }
  }
}
finanse annotations
{
  "title": "Sprawozdania finansowe",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
sprawozdanie — Pełne sprawozdanie pozycja po pozycji
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

sprawozdanie input schema
{
  "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)"
    }
  }
}
sprawozdanie annotations
{
  "title": "Pełne sprawozdanie pozycja po pozycji",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
crbr — Beneficjenci rzeczywiści (CRBR)
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

crbr input schema
{
  "type": "object",
  "required": [
    "krs"
  ],
  "properties": {
    "krs": {
      "type": "string",
      "description": "Numer KRS (do 10 cyfr, np. 0000028860)"
    }
  }
}
crbr annotations
{
  "title": "Beneficjenci rzeczywiści (CRBR)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
zmiany — Zmiany u obserwowanych firm
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

zmiany input schema
{
  "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"
    }
  }
}
zmiany annotations
{
  "title": "Zmiany u obserwowanych firm",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
katalog — Lista spółek po filtrach
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

katalog input schema
{
  "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"
    }
  }
}
katalog annotations
{
  "title": "Lista spółek po filtrach",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

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.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http analizafirm-pl-mcp https://analizafirm.pl/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add analizafirm-pl-mcp --url https://analizafirm.pl/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable analizafirm-pl-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "analizafirm-pl-mcp": {
      "url": "https://analizafirm.pl/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "analizafirm-pl-mcp": {
      "type": "streamableHttp",
      "url": "https://analizafirm.pl/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start analizafirm-pl-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "analizafirm-pl-mcp": {
      "type": "http",
      "url": "https://analizafirm.pl/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http analizafirm-pl-mcp https://analizafirm.pl/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "analizafirm-pl-mcp": {
      "url": "https://analizafirm.pl/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "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.

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.

Claim this listing