Polish KYB

io.github.ContentWritercoPublished by GitHub account ContentWritercov1.0.0Updated Oct 24, 2026

Know-your-business checks for Polish companies: KRS, owners, insolvency, sanctions, gazette notices.

VerifiedStreamable HTTPWeb executableFinanceSecurity & MonitoringBusiness & Commerce

Overview

AI-generated overview

A read-only remote MCP server for Polish company due diligence, letting an assistant look up KRS registry profiles, owners, insolvency, sanctions and court gaz.

What you can do
Search and read Polish KRS company profiles, including VAT status and headline financials, by name, KRS or NIP number, with compact or detailed fields and earlier periods available. Look up people tied to a company: management board, supervisory board, shareholders, proxies and CRBR beneficial owners. Check risk signals: insolvency and restructuring proceedings from the National Debtors Register, MSWiA sanctions listings, and Court and Commercial Gazette notices. Review financial supervision entries from the KNF register and secured liabilities from financial-statement notes. Read a company's articles of association or statute, and check Warsaw Stock Exchange listing data and current billing
When to use it
Useful when an assistant needs to vet a Polish business partner or supplier: confirming registry identity, ownership and beneficial owners, or checking insolvency, sanctions, gazette notices and financial supervision licences before a deal.
Requirements
A remote Streamable HTTP endpoint hosted by Compabase; no local runtime. A Compabase account, either via OAuth sign-in in clients that support it or an MCP key passed as the Authorization Bearer header or as an apiKey query parameter. Network access to the endpoint.
Before you install
The Authorization MCP key is a secret and should be kept private; the README also allows passing it in the URL query string, which can leak into logs. Queries count toward a paid Compabase plan, and the get_usage tool exposes quota and billing-period data. The server is described as read-only, but it sends company identifiers to a third party, Compabase.

Installation

In SourceWeft

  1. Open Polish KYB in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.ContentWriterco%2Fpolish-kyb/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "polish-kyb": {
      "type": "http",
      "url": "https://compabase.com/api/mcp/kyb"
    }
  }
}

README

Polish 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

ToolWhat it does
search_companies / get_companyFind the company and read its KRS registry profile and VAT status.
get_company_people / get_company_beneficiariesManagement board, supervisory board, shareholders and beneficial owners (CRBR).
get_company_debt_registryInsolvency and restructuring proceedings (KRZ).
get_company_court_gazetteCourt and Commercial Gazette (MSiG) notices.
get_company_sanctions / get_company_financial_supervisionSanctions lists and KNF financial supervision register.
get_company_secured_liabilities / get_company_articlesSecured 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):

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

bash
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/

Source: README.md at commit 73e6ecc

Tools

12

search_companies

Search Polish 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.

Parameterskrsnippkdcitynameyearlimitcountyfieldsregionall_pkdsort_by+23 more

get_company

Get Company Profile

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.

Parameterskrsnipname

get_company_people

Get Company People & Management

Get people associated with a company — management board, supervisory board, shareholders, proxies. Returns display names, role labels, and relationship types (management, supervisory, ownership, procuration). Identify by name, KRS, or NIP.

Parameterskrsnipnamerelationship_type

get_company_stock_market

Get Warsaw Stock Exchange Data (GPW)

Get Warsaw Stock Exchange listing for a company — ticker, ISIN, market (GPW main / NewConnect / GlobalConnect), last close and change, market cap, shares outstanding, TTM EPS, TTM P/E (falls back to last annual filing), last quarterly results, next earnings date, dividend per share and yield. Quotes delayed ~15 minutes, in PLN. Snapshot plus a few recent daily bars — not full OHLCV history. Keyed by NIP. Identify company by name, KRS, or NIP.

Parameterskrsnipname

get_company_court_gazette

Get Court and Commercial Gazette (MSiG)

Get notices about a Polish company published in the Court and Commercial Gazette (Monitor Sądowy i Gospodarczy): calls to creditors, liquidation, mergers and transformations. Identify the company by name, KRS number or company tax number (NIP).

Parameterskrsnipname

get_company_sanctions

Get sanctions listing (MSWiA)

Official MSWiA sanctions listing for one company. Returns measures and legal grounds when the company is listed; null when it is not. Matched by KRS, NIP, or REGON. The same payload is included on get_company as sanctions.

Parameterskrsnipname

get_company_debt_registry

Get National Debt Register (KRZ)

Get insolvency and restructuring proceedings of a Polish company from the National Debtors Register (KRZ). Identify the company by name, KRS number or company tax number (NIP).

Parameterskrsnipname

get_company_financial_supervision

Get KNF Financial Supervision Register

KNF register (Polish Financial Supervision Authority): licences and entries of a financial company — banks, payment / e-money institutions, investment firms, insurers, lending institutions, agents. Returns entries with kind, KNF number, status, registration / decision / strike-off dates and services. Keyed by NIP; null when the company has no KNF entry.

Parameterskrsnipname

get_company_secured_liabilities

Get Secured Liabilities (Mortgages, Pledges)

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.

Parameterskrsnipname

get_company_beneficiaries

Get Ultimate Beneficial Owners (CRBR)

Get CRBR beneficial owners for a KRS company. All names are returned (same as zarząd / wspólnicy). PESEL is never included (birth_year only). JDG are not in CRBR.

Parameterskrsnipname

get_company_articles_of_association

Get Articles of Association

Get the text of a Polish company's articles of association or statute from the court register document repository. Use for questions about share transfers, pre-emption rights, voting rights, management board powers or company duration. Identify the company by name, KRS number or company tax number (NIP).

Parameterskrsnipnamedoc_id

get_usage

Get Account Usage & Quota

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

Takes no parameters.

Version history

1
  1. v1.0.0LatestOct 9, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts