Skip to main content
Glama

AnalizaFirm.pl - Polish companies (KRS)

Lista spółek po filtrach

katalog
Read-onlyIdempotent

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.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "katalog"
  }
}

Input Schema

NameRequiredDescriptionDefault
krzNoPostępowania w KRZ: all, upadlosc albo restrukturyzacja
vatNoStatus VAT po przecinku: czynny, zwolniony, niezarejestrowany, brak
cityNoMiejscowość siedziby
afterNoKRS z next_after poprzedniej strony
formyNoFormy prawne po przecinku: sp_zoo, sa, psa, sk, ska, sj, sp, spoldzielnia, oddzial, fundacja, stowarzyszenie, inne
gminaNo
limitNoWyników na stronę (domyślnie 200)
ocenaNoOceny A–E po przecinku, np. A,B
yearsNoLata sprawozdań po przecinku, np. 2025,2024
kod_doNoKod pocztowy do
kod_odNoKod pocztowy od, np. 00-001
powiatNo
statusNoall = także wykreślone i w likwidacji (domyślnie tylko aktywne)
krz_dniNoPostępowanie w KRZ z ostatnich N dni
metrykiNoZakresy metryk, np. {"cagr3": {"min": 20}, "roe": {"min": 15}}. Klucze: przychody_sprz (przychody ze sprzedaży), ebit, ebitda, gotowka, kapital_wlasny, suma_bilansowa (PLN), roe, roa, marza_netto, marza_op, zadluzenie, cagr1, cagr3, cagr5 (%). Dotyczy najnowszego sprawozdania firmy
pkd_kodNoKod PKD, np. 62.01.Z
categoryNoSlug branży analizafirm.pl, np. it
przetargiNotrue = tylko firmy z zamówieniami publicznymi
pkd_glowneNoZ pkd_kod: true = tylko gdy to PKD przeważające
profit_maxNo
profit_minNoZysk netto od (PLN)
wycena_maxNo
wycena_minNoSzacunkowa wycena od (PLN)
kapital_maxNo
kapital_minNo
pkd_sectionNoSekcja PKD (litera), np. J
revenue_maxNo
revenue_minNoPrzychody łącznie od (PLN); gdy źródło podaje tylko sprzedaż albo kwota łączna jest nietypowa wobec skali spółki, sprzedaż, jak w rankingach; firmy bez sprzedaży nie spełniają filtra; sama sprzedaż: metryka przychody_sprz
voivodeshipNoWojewództwo małymi literami, np. mazowieckie
rok_wpisu_doNo
rok_wpisu_odNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / metryki / description
      Previous value: -"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"New value: +"Zakresy metryk, np. {\"cagr3\": {\"min\": 20}, \"roe\": {\"min\": 15}}. Klucze: przychody_sprz (przychody ze sprzedaży), ebit, ebitda, gotowka, kapital_wlasny, suma_bilansowa (PLN), roe, roa, marza_netto, marza_op, zadluzenie, cagr1, cagr3, cagr5 (%). Dotyczy najnowszego sprawozdania firmy"
    • changedInput schema / properties / revenue_min / description
      Previous value: -"Przychody od (PLN)"New value: +"Przychody łącznie od (PLN); gdy źródło podaje tylko sprzedaż albo kwota łączna jest nietypowa wobec skali spółki, sprzedaż, jak w rankingach; firmy bez sprzedaży nie spełniają filtra; sama sprzedaż: metryka przychody_sprz"
  2. First observed

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false and closed-world scope, so the safety profile is covered. The description adds genuinely new behavioral facts: results contain only KRS numbers, pagination uses next_after fed back into 'after', total appears only on page 1, and one page consumes one unit from a pool (quota/cost implication).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four compact sentences: what it returns, filter scope, return shape/pagination, and the alternative tool. Everything is front-loaded and nothing is redundant, though the filter enumeration is dense and could be shortened since the schema lists the same fields.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 31-parameter, zero-required, nested-object tool with no output schema, the description supplies the missing return contract (results, count, next_after, total) and the quota note, which is exactly what the structured data lacks. Defaults and enum details are left to the schema, which covers them adequately.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 31 parameters and 71% schema description coverage, the schema already carries most semantics, including the detailed revenue_min and metryki explanations. The description groups the filter families and links next_after to the 'after' parameter, but it does not add field-level meaning beyond the schema, so the baseline applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: it returns KRS numbers (not full records) for companies matching a named filter set, and it explicitly contrasts itself with the sibling 'firma' tool that serves single-company data. An agent can tell exactly what it gets back and what it should call instead for detail.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives clear usage context (filter-based listing, filters mirroring the /pobierz-dane export) and an explicit redirect: 'Dane konkretnej firmy pobierz narzędziem firma.' There are no stated exclusions or limits relative to other listing-style siblings, but the core when-to-use guidance is present and actionable.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources