About Polish Company Financials
Polish Company Financials is a read-only remote MCP server for exploring multi-year financial statements filed with Poland’s KRS. It helps analysts and business researchers search, rank, and compare Polish companies using financial figures and sector or regional benchmarks.
Key features
- 01Search and count companies by financial and regional filters
- 02Retrieve annual financial statements
- 03Rank companies by industry, region, and country
- 04Compare sector and regional benchmarks
- 05View headline figures and secured liabilities
Use cases
- 01Compare a Polish company’s margin with its sector
- 02Find top-revenue software companies in a city
- 03Review a company’s financial statements across years
MCP support
Exposes read-only company search, financial statements, rankings, and benchmark tools through a hosted Streamable HTTP MCP server at `https://compabase.com/api/mcp/financials`. Authentication is available through Compabase OAuth or an MCP key.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://compabase.com/api/mcp/financialsclaude mcp add --transport http contentwriterco-polish-company-financials https://compabase.com/api/mcp/financials{"mcpServers":{"contentwriterco-polish-company-financials":{"type":"http","url":"https://compabase.com/api/mcp/financials"}}}Open in Cursor{"servers":{"contentwriterco-polish-company-financials":{"type":"http","url":"https://compabase.com/api/mcp/financials"}}}Open in VS Code{"mcpServers":{"contentwriterco-polish-company-financials":{"type":"http","url":"https://compabase.com/api/mcp/financials"}}}{"mcpServers":{"contentwriterco-polish-company-financials":{"serverUrl":"https://compabase.com/api/mcp/financials"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://compabase.com/api/mcp/financialsAuth requiredTools
8| Parameter | Type | Required | Description |
|---|---|---|---|
| krs | string | No | KRS number of the company in the Polish National Court Register (10 digits). |
| nip | string | No | Polish company tax number (NIP) of the business, 10 digits. |
| pkd | string | No | Primary PKD code prefix, e.g. '46.90.Z' or '46'. |
| city | string | No | City name — KRS records use uppercase, e.g. 'WARSZAWA', 'POZNAŃ'. |
| name | string | No | Company name, used when the KRS or NIP is not known. |
| year | integer | No | 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 | No | Max results (default: 10, max: 50). |
| county | string | No | County / powiat (lowercase). |
| fields | enum | No | 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.contacts_only | summary | full |
| region | string | No | Voivodeship (lowercase), e.g. 'mazowieckie', 'wielkopolskie'. |
| all_pkd | string | No | Match any PKD code in the company's activity list (not just primary). |
| sort_by | enum | No | Sort field (default: revenue_total). registration_date + sort_dir=desc lists the newest registrations first. revenue_growth_pct + sort_dir=desc lists the fastest-growing companies (y/y revenue growth from KRS financial statements; combine with revenue_min to skip small companies).revenue_total | profit_net | total_assets | profit_operating | ebitda | capital_total | estimated_value | registration_date | revenue_growth_pct |
| currency | enum | No | Currency for monetary filters. Default: pln.pln | usd | eur |
| sort_dir | enum | No | Sort direction (default: desc).asc | desc |
| has_email | boolean | No | true = only companies with email on record. Matching rows include contacts.email. Omit otherwise. |
| is_active | boolean | No | true = active only, false = closed only. Omit for all. |
| ebitda_max | number | No | Maximum EBITDA. |
| ebitda_min | number | No | Minimum EBITDA. |
| legal_form | string | No | Legal form fragment, e.g. 'spółka z o.o.' or 'akcyjna'. |
| profit_max | number | No | Maximum net profit. |
| profit_min | number | No | Minimum net profit. |
| capital_max | number | No | Maximum share capital. |
| capital_min | number | No | Minimum share capital. |
| has_website | boolean | No | true = only companies with website on record. Matching rows include contacts.website. Omit otherwise. |
| postal_code | string | No | Postal code prefix, e.g. '00-9' or '61-'. |
| revenue_max | number | No | Maximum total revenue. |
| revenue_min | number | No | Minimum total revenue. |
| total_assets_max | number | No | Maximum total assets. |
| total_assets_min | number | No | Minimum total assets. |
| estimated_value_max | number | No | Maximum Ohlson estimated equity value in PLN. |
| estimated_value_min | number | No | Minimum Ohlson estimated equity value in PLN. |
| profit_operating_max | number | No | Maximum operating profit (PLN). Omit if unused. |
| profit_operating_min | number | No | Minimum operating profit (PLN). Negative allowed. Omit if unused. |
| registration_date_max | string | No | Latest KRS registration date, YYYY-MM-DD (inclusive). |
| registration_date_min | string | No | 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. |
Details
From the project READMEPolish 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.
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):
{
"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: [email protected]
Gemini CLI
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/
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.