# Polish KYB

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

- name: io.github.ContentWriterco/polish-kyb
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 97/100
- quality: 86/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.ContentWriterco%2Fpolish-kyb
- tools: https://api.protogrid.dev/v1/servers/io.github.ContentWriterco%2Fpolish-kyb/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "polish-kyb": {
      "type": "http",
      "url": "https://compabase.com/api/mcp/kyb",
      "headers": {
        "Authorization": "Bearer ${POLISH_KYB_TOKEN}"
      }
    }
  }
}
```

Placeholders to fill: `${POLISH_KYB_TOKEN}`.

## Trust

- hygiene: 100
- liveness: 99
- freshness: 100
- provenance: 90
- drivers: +repository +namespace-matches-repo +website +reachable +uptime-98% +updated-11d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 86/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 12 of 12 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 3,395 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 75 (weight 15)

- warn `stability.changes`: 25 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 12, about 3,395 tokens to load them all
- tool set hash: 9b46a3769399755137b8b14916a5ddc0
- tools last changed: 2026-10-18T23:24:33.668Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.ContentWriterco/polish-kyb.svg)](https://protogrid.dev/servers/io.github.ContentWriterco/polish-kyb)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-18 `get_usage` added
  - Get current billing period usage and remaining quota — mcp_queries, api_requests, export_companies, ask_ai_credits, watchlist_companies. Includes limits and reset date.
- 2026-10-18 `get_company_articles_of_association` added
  - 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).
- 2026-10-18 `get_company_beneficiaries` added
  - 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.
- 2026-10-18 `get_company_secured_liabilities` added
  - 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.
- 2026-10-18 `get_company_financial_supervision` added
  - 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.
- 2026-10-18 `get_company_debt_registry` added
  - 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).
- 2026-10-18 `get_company_sanctions` added
  - 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.
- 2026-10-18 `get_company_court_gazette` added
  - 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).
- 2026-10-18 `get_company_stock_market` added
  - 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.
- 2026-10-18 `get_company_people` added
  - 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.

Full history: https://api.protogrid.dev/v1/servers/io.github.ContentWriterco%2Fpolish-kyb/changes

## Remotes

- https://compabase.com/api/mcp/kyb (streamable-http, auth none, reachable true, uptime30d 0.9767442)

## Packages

_none_

## Tools (12)

- `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.
- `get_company_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).
- `get_company_beneficiaries`: 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.
- `get_company_court_gazette`: 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).
- `get_company_debt_registry`: 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).
- `get_company_financial_supervision`: 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.
- `get_company_people`: 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.
- `get_company_sanctions`: 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.
- `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.
- `get_company_stock_market`: 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.
- `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.
- `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.