Polish Company Financials

Official8 tools

by ContentWriterco

Polish company financial statements for AI agents: revenue, profit, assets, rankings, benchmarks.

io.github.ContentWriterco/polish-company-financials — MCP Server

This MCP server provides access to Polish company financial statements for AI agents. The content focuses on revenue, profit, assets, rankings, and benchmarks, enabling retrieval of structured financial information related to Polish companies for downstream analysis.

🛠️ Key Features

Financial statements data for Polish companies
Includes revenue and profit metrics
Includes assets information
Provides rankings
Provides benchmarks

🚀 Use Cases

Collect revenue, profit, and assets data for AI agent workflows
Compare companies using rankings
Evaluate performance using benchmarks

⚡ Developer Benefits

Grounded dataset scope (revenue, profit, assets, rankings, benchmarks)
Intended for AI agents that need financial statement inputs

⚠️ Limitations

Description only specifies the categories of financial data (no additional tools or fields provided beyond those topics).

Topics

company-datafinancial-statementsmcpmcp-servermodel-context-protocolpolandgemini-cli-extension

Captured live from the server via tools/list.

search_companies

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.

Parameters35

name	string	optional	Company name, used when the KRS or NIP is not known.
krs	string	optional	KRS number of the company in the Polish National Court Register (10 digits).
nip	string	optional	Polish company tax number (NIP) of the business, 10 digits.
city	string	optional	City name — KRS records use uppercase, e.g. 'WARSZAWA', 'POZNAŃ'.
county	string	optional	County / powiat (lowercase).
region	string	optional	Voivodeship (lowercase), e.g. 'mazowieckie', 'wielkopolskie'.
postal_code	string	optional	Postal code prefix, e.g. '00-9' or '61-'.
pkd	string	optional	Primary PKD code prefix, e.g. '46.90.Z' or '46'.
all_pkd	string	optional	Match any PKD code in the company's activity list (not just primary).
legal_form	string	optional	Legal form fragment, e.g. 'spółka z o.o.' or 'akcyjna'.
currency	string	optional	Currency for monetary filters. Default: pln.
revenue_min	number	optional	Minimum total revenue.
revenue_max	number	optional	Maximum total revenue.
profit_min	number	optional	Minimum net profit.
profit_max	number	optional	Maximum net profit.
profit_operating_min	number	optional	Minimum operating profit (PLN). Negative allowed. Omit if unused.
profit_operating_max	number	optional	Maximum operating profit (PLN). Omit if unused.
total_assets_min	number	optional	Minimum total assets.
total_assets_max	number	optional	Maximum total assets.
ebitda_min	number	optional	Minimum EBITDA.
ebitda_max	number	optional	Maximum EBITDA.
capital_min	number	optional	Minimum share capital.
capital_max	number	optional	Maximum share capital.
estimated_value_min	number	optional	Minimum Ohlson estimated equity value in PLN.
estimated_value_max	number	optional	Maximum Ohlson estimated equity value in PLN.
registration_date_min	string	optional	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	string	optional	Latest KRS registration date, YYYY-MM-DD (inclusive).
is_active	boolean	optional	true = active only, false = closed only. Omit for all.
has_email	boolean	optional	true = only companies with email on record. Matching rows include contacts.email. Omit otherwise.
has_website	boolean	optional	true = only companies with website on record. Matching rows include contacts.website. Omit otherwise.
sort_by	string	optional	Sort field (default: revenue_total). registration_date + sort_dir=desc lists the newest registrations first.
sort_dir	string	optional	Sort direction (default: desc).
year	integer	optional	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	integer	optional	Max results (default: 10, max: 50).
fields	string	optional	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.

Raw schema

{
  "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_company

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.

Parameters3

name	string	optional	Company name, used when the KRS or NIP is not known.
krs	string	optional	KRS number of the company in the Polish National Court Register (10 digits).
nip	string	optional	Polish company tax number (NIP) of the business, 10 digits.

Raw schema

{
  "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_financials

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.

Parameters5

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

Raw schema

{
  "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_companies

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

Parameters29

name	string	optional	Company name, used when the KRS or NIP is not known.
krs	string	optional	KRS number of the company in the Polish National Court Register (10 digits).
nip	string	optional	Polish company tax number (NIP) of the business, 10 digits.
city	string	optional	City name — KRS uses uppercase.
county	string	optional	County / powiat (lowercase).
region	string	optional	Voivodeship (lowercase).
pkd	string	optional	Primary PKD code prefix, e.g. '46.90.Z' or '46'.
all_pkd	string	optional	Match any PKD code in the company's activity list (not just primary).
legal_form	string	optional	Legal form fragment.
revenue_min	number	optional	Minimum total revenue in PLN.
revenue_max	number	optional	Maximum total revenue in PLN.
profit_min	number	optional	Minimum net profit in PLN.
profit_max	number	optional	Maximum net profit in PLN.
profit_operating_min	number	optional	Minimum operating profit in PLN.
profit_operating_max	number	optional	Maximum operating profit in PLN.
total_assets_min	number	optional	Minimum total assets in PLN.
total_assets_max	number	optional	Maximum total assets in PLN.
ebitda_min	number	optional	Minimum EBITDA in PLN.
ebitda_max	number	optional	Maximum EBITDA in PLN.
capital_min	number	optional	Minimum share capital in PLN.
capital_max	number	optional	Maximum share capital in PLN.
estimated_value_min	number	optional	Minimum Ohlson estimated equity value in PLN.
estimated_value_max	number	optional	Maximum Ohlson estimated equity value in PLN.
registration_date_min	string	optional	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	string	optional	Latest KRS registration date, YYYY-MM-DD (inclusive).
is_active	boolean	optional	true = active only, false = closed only. Omit for all.
has_email	boolean	optional	true = only companies with email on record. Omit otherwise.
has_website	boolean	optional	true = only companies with website on record. Omit otherwise.
year	integer	optional	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.

Raw schema

{
  "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_company_rankings

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?

Parameters4

name	string	optional	Company name, used when the KRS or NIP is not known.
krs	string	optional	KRS number of the company in the Polish National Court Register (10 digits).
nip	string	optional	Polish company tax number (NIP) of the business, 10 digits.
scope_type	string	optional	Optional. Filter to a single scope. Omit to get all scopes.

Raw schema

{
  "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_financial_stats

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.

Parameters4

dimension_type	string	optional	Granularity: 'country'=Poland; 'pkd_section'=A–U; 'pkd_division'=2-digit; 'pkd_full'=full code; 'region'=voivodeship; etc.
dimension_key	string	optional	Key for the dimension, e.g. 'PL', 'G', '46', '46.90.Z', 'mazowieckie'. Prefix match applied.
metric	string	optional	Financial metric. Omit to return all metrics.
currency	string	optional	Currency (default: PLN). cost_wages is PLN-only.

Raw schema

{
  "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."
    }
  }
}

get_company_secured_liabilities

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.

Parameters3

name	string	optional	Company name, used when the KRS or NIP is not known.
krs	string	optional	KRS number of the company in the Polish National Court Register (10 digits).
nip	string	optional	Polish company tax number (NIP) of the business, 10 digits.

Raw schema

{
  "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_usage

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

Parameters

No parameters.

Raw schema

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

README.md2 KBView on GitHub

Polish Company Financials MCP Server

Read multi-year financial statements filed with the Polish KRS, rank companies in their industry and region, and compare them with sector benchmarks.

Remote MCP server (Streamable HTTP), read-only, hosted by Compabase.

code

https://compabase.com/api/mcp/financials

Tools

Tool	What it does
`search_companies / count_companies`	Filter companies by revenue, profit, assets, EBITDA, PKD and region.
`get_financials`	Full financial statements by fiscal year.
`get_company_rankings`	Revenue rank in industry, region and country.
`get_financial_stats`	Sector and regional benchmarks.
`get_company / get_company_secured_liabilities`	Headline figures and secured liabilities.

Example prompts

Show revenue and net profit of Orlen for the last three years.
List the 10 largest software companies in Gdańsk by revenue.
How does this company's margin compare with its industry?

Authentication

Sign in with your Compabase account (OAuth) in clients that support it, or send an MCP key: create one at https://compabase.com/integrations?tab=mcp and pass it as Authorization: Bearer mcpk_… or append ?apiKey=mcpk_… to the URL. Queries count toward your Compabase plan.

Setup

Claude (claude.ai, Desktop): Settings → Connectors → Add custom connector → paste the URL above (add ?apiKey=mcpk_… if you use a key).

Cursor / VS Code / Windsurf (mcp.json):

json

{
  "mcpServers": {
    "polish-company-financials": {
      "url": "https://compabase.com/api/mcp/financials",
      "headers": { "Authorization": "Bearer mcpk_YOUR_KEY" }
    }
  }
}

ChatGPT: Settings → Apps → Developer mode → Create → paste the URL.

About

Part of the Compabase MCP family. Full Compabase MCP (all Polish company data tools): https://compabase.com/api/mcp.

Questions: contact@compabase.com

Gemini CLI

bash

gemini extensions install https://github.com/ContentWriterco/Polish-Company-Financials-MCP

Gemini CLI asks for your Compabase MCP key during installation (create one at https://compabase.com/integrations?tab=mcp).

Setup guides

Step-by-step setup guides for Claude, ChatGPT, Gemini, Grok, Le Chat, Perplexity, Cursor, VS Code and Claude Code: https://compabase.com/docs/mcp/connect/

Install

Tools (8)

search_companiesget_companyget_financialscount_companiesget_company_rankingsget_financial_statsget_company_secured_liabilitiesget_usage

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://compabase.com/api/mcp/financials

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "polish-company-financials": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://compabase.com/api/mcp/financials"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.ContentWriterco/polish-company-financials — MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

search_companies

get_company

get_financials

count_companies

get_company_rankings

get_financial_stats

get_company_secured_liabilities

get_usage

Polish Company Financials MCP Server

Tools

Example prompts

Authentication

Setup

About

Gemini CLI

Setup guides

Install

Remote endpoint

Related servers