Polish Company Financials

Search and filter Polish KRS companies (spółki). Compabase also holds the full CEIDG/JDG register; this tool does not browse JDG — those without a public contact email are hidden because of RODO. Default `fields=summary` returns a compact row (name, NIP, KRS, location, PKD, latest financials, email/phone/website) — small enough for MCP clients. `fields=contacts_only` is name/NIP/KRS/city/email/phone/website only. `fields=full` returns every company_search column plus contacts and may exceed client size limits. Use for rankings, sector filters, city/county/region browsing, name search, or NIP/KRS lookup. When a PKD is mostly JDG, a sparse result includes a `hint` (full CEIDG is in the database; listing is RODO-gated). Do not call export_companies just to get a handful of emails or phones.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name, used when the KRS or NIP is not known."
    },
    "krs": {
      "type": "string",
      "description": "KRS number of the company in the Polish National Court Register (10 digits)."
    },
    "nip": {
      "type": "string",
      "description": "Polish company tax number (NIP) of the business, 10 digits."
    },
    "city": {
      "type": "string",
      "description": "City name — KRS records use uppercase, e.g. 'WARSZAWA', 'POZNAŃ'."
    },
    "county": {
      "type": "string",
      "description": "County / powiat (lowercase)."
    },
    "region": {
      "type": "string",
      "description": "Voivodeship (lowercase), e.g. 'mazowieckie', 'wielkopolskie'."
    },
    "postal_code": {
      "type": "string",
      "description": "Postal code prefix, e.g. '00-9' or '61-'."
    },
    "pkd": {
      "type": "string",
      "description": "Primary PKD code prefix, e.g. '46.90.Z' or '46'."
    },
    "all_pkd": {
      "type": "string",
      "description": "Match any PKD code in the company's activity list (not just primary)."
    },
    "legal_form": {
      "type": "string",
      "description": "Legal form fragment, e.g. 'spółka z o.o.' or 'akcyjna'."
    },
    "currency": {
      "type": "string",
      "enum": [
        "pln",
        "usd",
        "eur"
      ],
      "description": "Currency for monetary filters. Default: pln."
    },
    "revenue_min": {
      "type": "number",
      "description": "Minimum total revenue."
    },
    "revenue_max": {
      "type": "number",
      "description": "Maximum total revenue."
    },
    "profit_min": {
      "type": "number",
      "description": "Minimum net profit."
    },
    "profit_max": {
      "type": "number",
      "description": "Maximum net profit."
    },
    "profit_operating_min": {
      "type": "number",
      "description": "Minimum operating profit (PLN). Negative allowed. Omit if unused."
    },
    "profit_operating_max": {
      "type": "number",
      "description": "Maximum operating profit (PLN). Omit if unused."
    },
    "total_assets_min": {
      "type": "number",
      "description": "Minimum total assets."
    },
    "total_assets_max": {
      "type": "number",
      "description": "Maximum total assets."
    },
    "ebitda_min": {
      "type": "number",
      "description": "Minimum EBITDA."
    },
    "ebitda_max": {
      "type": "number",
      "description": "Maximum EBITDA."
    },
    "capital_min": {
      "type": "number",
      "description": "Minimum share capital."
    },
    "capital_max": {
      "type": "number",
      "description": "Maximum share capital."
    },
    "estimated_value_min": {
      "type": "number",
      "description": "Minimum Ohlson estimated equity value in PLN."
    },
    "estimated_value_max": {
      "type": "number",
      "description": "Maximum Ohlson estimated equity value in PLN."
    },
    "registration_date_min": {
      "type": "string",
      "description": "Earliest KRS registration date, YYYY-MM-DD (inclusive). For newly registered companies use today's date for both registration_date_min and registration_date_max."
    },
    "registration_date_max": {
      "type": "string",
      "description": "Latest KRS registration date, YYYY-MM-DD (inclusive)."
    },
    "is_active": {
      "type": "boolean",
      "description": "true = active only, false = closed only. Omit for all."
    },
    "has_email": {
      "type": "boolean",
      "description": "true = only companies with email on record. Matching rows include contacts.email. Omit otherwise."
    },
    "has_website": {
      "type": "boolean",
      "description": "true = only companies with website on record. Matching rows include contacts.website. Omit otherwise."
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "revenue_total",
        "profit_net",
        "total_assets",
        "profit_operating",
        "ebitda",
        "capital_total",
        "estimated_value",
        "registration_date"
      ],
      "description": "Sort field (default: revenue_total). registration_date + sort_dir=desc lists the newest registrations first."
    },
    "sort_dir": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort direction (default: desc)."
    },
    "year": {
      "type": "integer",
      "description": "Filter to companies whose latest financial_period_to falls within this calendar year (e.g. 2024). Use only for sector/ranking browse — omit when looking up a company by name, KRS, or NIP."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Max results (default: 10, max: 50)."
    },
    "fields": {
      "type": "string",
      "enum": [
        "contacts_only",
        "summary",
        "full"
      ],
      "description": "Response size. Default summary (name, NIP, KRS, location, PKD, latest financials, email/phone/website). contacts_only: name, NIP, KRS, city, email, phone, website. full: every company_search column plus contacts — often too large for MCP clients."
    }
  }
}

Get the registry profile of one Polish company: name, legal form, address, industry (PKD), share capital, representation rules, recent registry changes, VAT status and headline financials for the latest filed period. Identify the company by name, KRS number or company tax number (NIP). For earlier years or full statements use get_financials.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name, used when the KRS or NIP is not known."
    },
    "krs": {
      "type": "string",
      "description": "KRS number of the company in the Polish National Court Register (10 digits)."
    },
    "nip": {
      "type": "string",
      "description": "Polish company tax number (NIP) of the business, 10 digits."
    }
  }
}

Get full financial statement metrics per fiscal period — all entity_financial_metrics columns. Includes cash_and_equivalents, inventories, receivables, liabilities, equity, cost breakdown, revenue lines. Identify company by name, KRS, or NIP.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name, used when the KRS or NIP is not known."
    },
    "krs": {
      "type": "string",
      "description": "KRS number of the company in the Polish National Court Register (10 digits)."
    },
    "nip": {
      "type": "string",
      "description": "Polish company tax number (NIP) of the business, 10 digits."
    },
    "year_from": {
      "type": "integer",
      "description": "Earliest fiscal year to include (e.g. 2019)."
    },
    "year_to": {
      "type": "integer",
      "description": "Latest fiscal year to include (e.g. 2023)."
    }
  }
}

Count KRS companies matching given filters. Returns a single number — no company list. Does not count JDG in this tool (full CEIDG is in Compabase; listing is RODO-gated). Sparse or zero counts in JDG-dominated PKDs include a `hint`.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name, used when the KRS or NIP is not known."
    },
    "krs": {
      "type": "string",
      "description": "KRS number of the company in the Polish National Court Register (10 digits)."
    },
    "nip": {
      "type": "string",
      "description": "Polish company tax number (NIP) of the business, 10 digits."
    },
    "city": {
      "type": "string",
      "description": "City name — KRS uses uppercase."
    },
    "county": {
      "type": "string",
      "description": "County / powiat (lowercase)."
    },
    "region": {
      "type": "string",
      "description": "Voivodeship (lowercase)."
    },
    "pkd": {
      "type": "string",
      "description": "Primary PKD code prefix, e.g. '46.90.Z' or '46'."
    },
    "all_pkd": {
      "type": "string",
      "description": "Match any PKD code in the company's activity list (not just primary)."
    },
    "legal_form": {
      "type": "string",
      "description": "Legal form fragment."
    },
    "revenue_min": {
      "type": "number",
      "description": "Minimum total revenue in PLN."
    },
    "revenue_max": {
      "type": "number",
      "description": "Maximum total revenue in PLN."
    },
    "profit_min": {
      "type": "number",
      "description": "Minimum net profit in PLN."
    },
    "profit_max": {
      "type": "number",
      "description": "Maximum net profit in PLN."
    },
    "profit_operating_min": {
      "type": "number",
      "description": "Minimum operating profit in PLN."
    },
    "profit_operating_max": {
      "type": "number",
      "description": "Maximum operating profit in PLN."
    },
    "total_assets_min": {
      "type": "number",
      "description": "Minimum total assets in PLN."
    },
    "total_assets_max": {
      "type": "number",
      "description": "Maximum total assets in PLN."
    },
    "ebitda_min": {
      "type": "number",
      "description": "Minimum EBITDA in PLN."
    },
    "ebitda_max": {
      "type": "number",
      "description": "Maximum EBITDA in PLN."
    },
    "capital_min": {
      "type": "number",
      "description": "Minimum share capital in PLN."
    },
    "capital_max": {
      "type": "number",
      "description": "Maximum share capital in PLN."
    },
    "estimated_value_min": {
      "type": "number",
      "description": "Minimum Ohlson estimated equity value in PLN."
    },
    "estimated_value_max": {
      "type": "number",
      "description": "Maximum Ohlson estimated equity value in PLN."
    },
    "registration_date_min": {
      "type": "string",
      "description": "Earliest KRS registration date, YYYY-MM-DD (inclusive). For newly registered companies use today's date for both registration_date_min and registration_date_max."
    },
    "registration_date_max": {
      "type": "string",
      "description": "Latest KRS registration date, YYYY-MM-DD (inclusive)."
    },
    "is_active": {
      "type": "boolean",
      "description": "true = active only, false = closed only. Omit for all."
    },
    "has_email": {
      "type": "boolean",
      "description": "true = only companies with email on record. Omit otherwise."
    },
    "has_website": {
      "type": "boolean",
      "description": "true = only companies with website on record. Omit otherwise."
    },
    "year": {
      "type": "integer",
      "description": "Filter to companies whose latest financial_period_to falls within this calendar year. Use only for sector/ranking browse — omit when looking up a company by name, KRS, or NIP."
    }
  }
}

Get a company's revenue rank positions within its industry (PKD), region (voivodeship), and all of Poland. Returns rows from company_financial_rankings — one row per scope (pkd_full, pkd_division, pkd_section, region, country). Use for questions like: where does company X rank in Poland / its industry / its region?

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name, used when the KRS or NIP is not known."
    },
    "krs": {
      "type": "string",
      "description": "KRS number of the company in the Polish National Court Register (10 digits)."
    },
    "nip": {
      "type": "string",
      "description": "Polish company tax number (NIP) of the business, 10 digits."
    },
    "scope_type": {
      "type": "string",
      "enum": [
        "pkd_full",
        "pkd_division",
        "pkd_section",
        "region",
        "country"
      ],
      "description": "Optional. Filter to a single scope. Omit to get all scopes."
    }
  }
}

Get precomputed aggregate financial statistics for a sector, region, PKD branch, or country. Returns median, p25/p75/p90, winsorized mean, mean, total, n_companies, min/max. Use for questions like: what is the median revenue / average profit / assets in industry X or region Y? Prefer median or winsor_mean over mean. cost_wages is PLN-only.

{
  "type": "object",
  "properties": {
    "dimension_type": {
      "type": "string",
      "enum": [
        "country",
        "pkd_section",
        "pkd_division",
        "pkd_class",
        "pkd_full",
        "region",
        "county",
        "city"
      ],
      "description": "Granularity: 'country'=Poland; 'pkd_section'=A–U; 'pkd_division'=2-digit; 'pkd_full'=full code; 'region'=voivodeship; etc."
    },
    "dimension_key": {
      "type": "string",
      "description": "Key for the dimension, e.g. 'PL', 'G', '46', '46.90.Z', 'mazowieckie'. Prefix match applied."
    },
    "metric": {
      "type": "string",
      "enum": [
        "revenue_total",
        "profit_net",
        "total_assets",
        "cost_wages"
      ],
      "description": "Financial metric. Omit to return all metrics."
    },
    "currency": {
      "type": "string",
      "enum": [
        "PLN",
        "EUR",
        "USD"
      ],
      "description": "Currency (default: PLN). cost_wages is PLN-only."
    }
  }
}

Secured liabilities from the latest financial-statement notes (period ending 2025+): mortgages (hipoteki), registered / financial pledges (zastawy), transfers of ownership, assignments — with creditor, amount, secured debt, asset and land-register (KW) numbers. Keyed by KRS; null when nothing is disclosed.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name, used when the KRS or NIP is not known."
    },
    "krs": {
      "type": "string",
      "description": "KRS number of the company in the Polish National Court Register (10 digits)."
    },
    "nip": {
      "type": "string",
      "description": "Polish company tax number (NIP) of the business, 10 digits."
    }
  }
}

Get current billing period usage and remaining quota — mcp_queries, api_requests, export_companies, ask_ai_credits, watchlist_companies. Includes limits and reset date.

{
  "type": "object",
  "properties": {}
}