About Polish KYB
Polish KYB is a read-only remote MCP server for due diligence on Polish businesses. It brings registry, ownership, insolvency, sanctions, court-gazette, and financial-supervision information together for teams checking business partners.
Key features
- 01Search companies and view KRS profiles and VAT status
- 02Review management, shareholders, and beneficial owners
- 03Check insolvency and restructuring proceedings
- 04Retrieve court gazette notices
- 05Check sanctions and financial supervision registers
- 06View secured liabilities and articles of association
Use cases
- 01Check a prospective Polish business partner
- 02Identify a company’s beneficial owners
- 03Review insolvency and sanctions status
MCP support
Exposes read-only Polish company due-diligence tools through a hosted Streamable HTTP MCP server at `https://compabase.com/api/mcp/kyb`. 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/kybclaude mcp add --transport http contentwriterco-polish-kyb https://compabase.com/api/mcp/kyb{"mcpServers":{"contentwriterco-polish-kyb":{"type":"http","url":"https://compabase.com/api/mcp/kyb"}}}Open in Cursor{"servers":{"contentwriterco-polish-kyb":{"type":"http","url":"https://compabase.com/api/mcp/kyb"}}}Open in VS Code{"mcpServers":{"contentwriterco-polish-kyb":{"type":"http","url":"https://compabase.com/api/mcp/kyb"}}}{"mcpServers":{"contentwriterco-polish-kyb":{"serverUrl":"https://compabase.com/api/mcp/kyb"}}}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/kybAuth requiredTools
12| 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 KYB MCP Server
Verify Polish business partners in one place: registry profile, management and shareholders, beneficial owners, insolvency and restructuring, court gazette notices, sanctions lists and financial supervision licences.
Remote MCP server (Streamable HTTP), read-only, hosted by Compabase.
https://compabase.com/api/mcp/kyb
Tools
| Tool | What it does |
|---|---|
search_companies / get_company | Find the company and read its KRS registry profile and VAT status. |
get_company_people / get_company_beneficiaries | Management board, supervisory board, shareholders and beneficial owners (CRBR). |
get_company_debt_registry | Insolvency and restructuring proceedings (KRZ). |
get_company_court_gazette | Court and Commercial Gazette (MSiG) notices. |
get_company_sanctions / get_company_financial_supervision | Sanctions lists and KNF financial supervision register. |
get_company_secured_liabilities / get_company_articles | Secured liabilities and articles of association. |
Example prompts
- Run a KYB check on the company with NIP 5260250995.
- Who are the beneficial owners of KRS 0000028860?
- Is this company in insolvency proceedings or on a sanctions list?
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-kyb": {
"url": "https://compabase.com/api/mcp/kyb",
"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-KYB-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.