Compabase is an MCP server published by io.github.ContentWriterco, hosted at compabase.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 57 tools, including request_signup, check_signup, list_plans, search_companies, get_company.
3M+ Polish companies (KRS, CEIDG): financials, people, rankings and public registries.
26 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Start Compabase account setup for an email. Sends a magic link. After the user clicks it, check_signup with the returned setup_id reports status ready and returns the MCP key automatically. No key has to be generated in the portal. No auth required.
| Parameter | Type | Description |
|---|---|---|
| email * | string | User email to create or sign in to a Compabase account. |
| client | string | AI client, used to label the generated MCP key. |
| locale | string | Email language (default en). |
{
"name": "request_signup",
"title": "Request Compabase Signup",
"description": "Start Compabase account setup for an email. Sends a magic link. After the user clicks it, check_signup with the returned setup_id reports status ready and returns the MCP key automatically. No key has to be generated in the portal. No auth required.",
"inputSchema": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "User email to create or sign in to a Compabase account."
},
"client": {
"enum": [
"cursor",
"claude",
"vscode",
"other"
],
"type": "string",
"description": "AI client, used to label the generated MCP key."
},
"locale": {
"enum": [
"en",
"pl",
"de"
],
"type": "string",
"description": "Email language (default en)."
}
}
},
"annotations": {
"title": "Request Compabase Signup",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Poll a request_signup session. When the user has confirmed email, returns mcp_key once and cursor_mcp_json to write to MCP config. Call every 3 seconds until status is ready, expired, or already_delivered. No auth required.
| Parameter | Type | Description |
|---|---|---|
| client | string | Optional client hint for the key name. |
| setup_id * | string | setup_id from request_signup. |
{
"name": "check_signup",
"title": "Check Compabase Signup Status",
"description": "Poll a request_signup session. When the user has confirmed email, returns mcp_key once and cursor_mcp_json to write to MCP config. Call every 3 seconds until status is ready, expired, or already_delivered. No auth required.",
"inputSchema": {
"type": "object",
"required": [
"setup_id"
],
"properties": {
"client": {
"enum": [
"cursor",
"claude",
"vscode",
"other"
],
"type": "string",
"description": "Optional client hint for the key name."
},
"setup_id": {
"type": "string",
"description": "setup_id from request_signup."
}
}
},
"annotations": {
"title": "Check Compabase Signup Status",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}List Compabase billing plans and limits. No auth required. After sign-up, use upgrade_plan to get a Stripe Checkout URL.
No parameters.
{
"name": "list_plans",
"title": "List Compabase Subscription Plans",
"description": "List Compabase billing plans and limits. No auth required. After sign-up, use upgrade_plan to get a Stripe Checkout URL.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "List Compabase Subscription Plans",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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). For a handful of emails or phones, fields=contacts_only here is enough; export_companies is meant for bulk files.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number (10 digits, zero-padded, e.g. '0000028860'). |
| nip | string | NIP tax number (10 digits, no dashes). |
| pkd | string | Primary PKD code prefix, e.g. '46.90.Z' or '46'. |
| city | string | City name — KRS records use uppercase, e.g. 'WARSZAWA', 'POZNAŃ'. |
| name | string | Company name fragment (case-insensitive). Matches display name and full KRS name; legal-form suffixes like 'sp. z o.o.' are ignored. |
| year | integer | 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 |
Get company registry profile and headline financials for one latest filed period (`financials.period_to` / `financial_period_to`): revenue, profit, costs, assets, estimated_value (Ohlson/RIM equity estimate), PKD, address, plus contacts when on record, full address, share capital, representation, recent KRS changes and `company_summary` (company description from the profile, language via `lang`), `logo_url`, `job_offers` (current job offers from the company career page and public job boards), `similar_companies`, `vat` (MF white list: VAT status, VAT registration date, bank accounts, removal/restoration, date Compabase checked it). All money fields in this response are that same period — there is no nested summary from a different year. NIP lookup also returns a CEIDG/JDG firm when it has a public contact email (RODO). Does NOT include balance-sheet line items (cash, receivables, inventories). For those or earlier years, use get_financials.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number (10 digits, zero-padded). |
| nip | string | NIP tax number (10 digits, dashes optional). |
| lang | string | Language of `company_summary` (default pl). Falls back to en, pl, de when missing. |
| name | string | Company name when KRS/NIP is unknown (legal-form suffix optional). |
{
"name": "get_company",
"title": "Get Company Profile",
"description": "Get company registry profile and headline financials for one latest filed period (`financials.period_to` / `financial_period_to`): revenue, profit, costs, assets, estimated_value (Ohlson/RIM equity estimate), PKD, address, plus contacts when on record, full address, share capital, representation, recent KRS changes and `company_summary` (company description from the profile, language via `lang`), `logo_url`, `job_offers` (current job offers from the company career page and public job boards), `similar_companies`, `vat` (MF white list: VAT status, VAT registration date, bank accounts, removal/restoration, date Compabase checked it). All money fields in this response are that same period — there is no nested summary from a different year. NIP lookup also returns a CEIDG/JDG firm when it has a public contact email (RODO). Does NOT include balance-sheet line items (cash, receivables, inventories). For those or earlier years, use get_financials.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number (10 digits, zero-padded)."
},
"nip": {
"type": "string",
"description": "NIP tax number (10 digits, dashes optional)."
},
"lang": {
"enum": [
"pl",
"en",
"de"
],
"type": "string",
"description": "Language of `company_summary` (default pl). Falls back to en, pl, de when missing."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown (legal-form suffix optional)."
}
}
},
"annotations": {
"title": "Get Company Profile",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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. The standalone row of the latest analysed statement also has `notes` (additional information from the statement): average employment (employees_avg, employees_avg_prev), income tax, profit distribution and dividend, parent and ultimate parent, related-party transactions, shareholdings, guarantees and contingent liabilities, loans, auditor fee, revenue split. Identify company by name, KRS, or NIP.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP tax number. |
| name | string | Company name when KRS/NIP is unknown (legal-form suffix optional). |
| year_to | integer | Latest fiscal year to include (e.g. 2023). |
| year_from | integer | Earliest fiscal year to include (e.g. 2019). |
{
"name": "get_financials",
"title": "Get Full Financial Statements",
"description": "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. The standalone row of the latest analysed statement also has `notes` (additional information from the statement): average employment (employees_avg, employees_avg_prev), income tax, profit distribution and dividend, parent and ultimate parent, related-party transactions, shareholdings, guarantees and contingent liabilities, loans, auditor fee, revenue split. Identify company by name, KRS, or NIP.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP tax number."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown (legal-form suffix optional)."
},
"year_to": {
"type": "integer",
"description": "Latest fiscal year to include (e.g. 2023)."
},
"year_from": {
"type": "integer",
"description": "Earliest fiscal year to include (e.g. 2019)."
}
}
},
"annotations": {
"title": "Get Full Financial Statements",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get people associated with a company — management board, supervisory board, shareholders, proxies. Returns display names, role labels, and relationship types (management, supervisory, ownership, procuration). `connected_companies`: other companies where these people hold roles or shares (company connections from the profile). Identify by name, KRS, or NIP.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP tax number. |
| name | string | Company name when KRS/NIP is unknown (legal-form suffix optional). |
| relationship_type | string | Filter: management, supervisory (rada nadzorcza), ownership, procuration. Omit for all. |
{
"name": "get_company_people",
"title": "Get Company People & Management",
"description": "Get people associated with a company — management board, supervisory board, shareholders, proxies. Returns display names, role labels, and relationship types (management, supervisory, ownership, procuration). `connected_companies`: other companies where these people hold roles or shares (company connections from the profile). Identify by name, KRS, or NIP.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP tax number."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown (legal-form suffix optional)."
},
"relationship_type": {
"type": "string",
"description": "Filter: management, supervisory (rada nadzorcza), ownership, procuration. Omit for all."
}
}
},
"annotations": {
"title": "Get Company People & Management",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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`.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP tax number. |
| pkd | string | Primary PKD code prefix, e.g. '46.90.Z' or '46'. |
| city | string | City name — KRS uses uppercase. |
| name | string | Company name fragment (case-insensitive). Matches display name and full KRS name; legal-form suffixes like 'sp. z o.o.' are ignored. |
| year | integer | 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. |
| naics | string | Detailed industry: NAICS 6-digit codes, comma-separated (any of them), e.g. '541511,541512'. AI classification of what the company actually does. |
| niche | string | Detailed industry in words (Polish), matched against the company's niche, e.g. 'opakowania', 'software house', 'catering'. |
| county | string |
Execute a read-only SQL SELECT query against the Compabase database. Use when dedicated tools are not enough (aggregations, joins, custom analysis). Returns at most row_limit rows per call depending on the plan (Free 100, Pro 500, Scale 1000); if truncated is true, the full result is larger and fits better as an aggregate inside SQL (GROUP BY, COUNT, AVG, percentile_cont).
| Parameter | Type | Description |
|---|---|---|
| query * | string | A read-only SQL SELECT or WITH…SELECT statement. |
{
"name": "execute_sql",
"title": "Execute Read-Only SQL",
"description": "Execute a read-only SQL SELECT query against the Compabase database. Use when dedicated tools are not enough (aggregations, joins, custom analysis). Returns at most row_limit rows per call depending on the plan (Free 100, Pro 500, Scale 1000); if truncated is true, the full result is larger and fits better as an aggregate inside SQL (GROUP BY, COUNT, AVG, percentile_cont).",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "A read-only SQL SELECT or WITH…SELECT statement."
}
}
},
"annotations": {
"title": "Execute Read-Only SQL",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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). PKD scope keys of historical classifications are prefixed with the version: 'v2007:62.01.Z', 'v2004:50', 'v1997:74.84.B' (no prefix = PKD 2025). `benchmark`: the company compared with peers (median, quartiles, mean of revenue, profit, costs, assets) in its industry, region and city, as on the profile. Use for questions like: where does company X rank in Poland / its industry / its region, how does it compare with its industry?
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number (10 digits, zero-padded). |
| nip | string | NIP tax number (10 digits, dashes optional). |
| lang | string | Language of benchmark labels (default pl). |
| name | string | Company name when KRS/NIP is unknown. |
| currency | string | Currency of `benchmark` (default PLN). |
| scope_type | string | Optional. Filter to a single scope. Omit to get all scopes. |
{
"name": "get_company_rankings",
"title": "Get Company Sector Rankings",
"description": "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). PKD scope keys of historical classifications are prefixed with the version: 'v2007:62.01.Z', 'v2004:50', 'v1997:74.84.B' (no prefix = PKD 2025). `benchmark`: the company compared with peers (median, quartiles, mean of revenue, profit, costs, assets) in its industry, region and city, as on the profile. Use for questions like: where does company X rank in Poland / its industry / its region, how does it compare with its industry?",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number (10 digits, zero-padded)."
},
"nip": {
"type": "string",
"description": "NIP tax number (10 digits, dashes optional)."
},
"lang": {
"enum": [
"pl",
"en",
"de"
],
"type": "string",
"description": "Language of benchmark labels (default pl)."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
},
"currency": {
"enum": [
"PLN",
"EUR",
"USD"
],
"type": "string",
"description": "Currency of `benchmark` (default PLN)."
},
"scope_type": {
"enum": [
"pkd_full",
"pkd_division",
"pkd_section",
"region",
"country"
],
"type": "string",
"description": "Optional. Filter to a single scope. Omit to get all scopes."
}
}
},
"annotations": {
"title": "Get Company Sector Rankings",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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? median and winsor_mean are robust to outliers; mean is not. cost_wages is PLN-only.
| Parameter | Type | Description |
|---|---|---|
| metric | string | Financial metric. Omit to return all metrics. |
| currency | string | Currency (default: PLN). cost_wages is PLN-only. |
| dimension_key | string | Key for the dimension, e.g. 'PL', 'G', '46', '46.90.Z', 'mazowieckie'. Prefix match applied. |
| dimension_type | string | Granularity: 'country'=Poland; 'pkd_section'=A–U; 'pkd_division'=2-digit; 'pkd_full'=full code; 'region'=voivodeship; etc. |
{
"name": "get_financial_stats",
"title": "Get Sector Financial Statistics",
"description": "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? median and winsor_mean are robust to outliers; mean is not. cost_wages is PLN-only.",
"inputSchema": {
"type": "object",
"properties": {
"metric": {
"enum": [
"revenue_total",
"profit_net",
"total_assets",
"cost_wages"
],
"type": "string",
"description": "Financial metric. Omit to return all metrics."
},
"currency": {
"enum": [
"PLN",
"EUR",
"USD"
],
"type": "string",
"description": "Currency (default: PLN). cost_wages is PLN-only."
},
"dimension_key": {
"type": "string",
"description": "Key for the dimension, e.g. 'PL', 'G', '46', '46.90.Z', 'mazowieckie'. Prefix match applied."
},
"dimension_type": {
"enum": [
"country",
"pkd_section",
"pkd_division",
"pkd_class",
"pkd_full",
"region",
"county",
"city"
],
"type": "string",
"description": "Granularity: 'country'=Poland; 'pkd_section'=A–U; 'pkd_division'=2-digit; 'pkd_full'=full code; 'region'=voivodeship; etc."
}
}
},
"annotations": {
"title": "Get Sector Financial Statistics",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get SUDOP public aid / grants for a company — full case list with amounts, grantor, measure, purpose. Keyed by NIP. Identify company by name, KRS, or NIP.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP tax number (preferred for SUDOP). |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_public_aid",
"title": "Get Public Aid (SUDOP)",
"description": "Get SUDOP public aid / grants for a company — full case list with amounts, grantor, measure, purpose. Keyed by NIP. Identify company by name, KRS, or NIP.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP tax number (preferred for SUDOP)."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get Public Aid (SUDOP)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get European Funds (Fundusze Europejskie) projects for a company — official MFiPR lists, EU co-financing, programme and dates. Keyed by NIP. Identify company by name, KRS, or NIP. Cohesion/shared-management funds; not TED procurement, not FTS Commission grants, and not SUDOP state aid.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP tax number (preferred for FE). |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_eu_funds",
"title": "Get EU Funds Projects",
"description": "Get European Funds (Fundusze Europejskie) projects for a company — official MFiPR lists, EU co-financing, programme and dates. Keyed by NIP. Identify company by name, KRS, or NIP. Cohesion/shared-management funds; not TED procurement, not FTS Commission grants, and not SUDOP state aid.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP tax number (preferred for FE)."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get EU Funds Projects",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get European Commission FTS awards for a company — Horizon, LIFE, Erasmus and other direct/indirect-management grants. Keyed by NIP (VAT). Identify by name, KRS, or NIP. Not cohesion funds (get_company_fe) and not TED procurement.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP tax number (preferred for FTS). |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_procurement",
"title": "Get EU Grants (FTS)",
"description": "Get European Commission FTS awards for a company — Horizon, LIFE, Erasmus and other direct/indirect-management grants. Keyed by NIP (VAT). Identify by name, KRS, or NIP. Not cohesion funds (get_company_fe) and not TED procurement.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP tax number (preferred for FTS)."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get EU Grants (FTS)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get BZP public procurement data — full awards as contractor and notices as buyer, with award values. Keyed by NIP. Identify company by name, KRS, or NIP.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP tax number (preferred for BZP). |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_public_tenders",
"title": "Get Public Procurement Bulletin (BZP)",
"description": "Get BZP public procurement data — full awards as contractor and notices as buyer, with award values. Keyed by NIP. Identify company by name, KRS, or NIP.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP tax number (preferred for BZP)."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get Public Procurement Bulletin (BZP)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get URE energy concessions for a company — full list of electricity, gas, heat, and liquid fuels, with validity dates and pending applications. Keyed by NIP. Identify company by name, KRS, or NIP.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP tax number (preferred for URE). |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_energy_licenses",
"title": "Get Energy Regulatory Office Licenses (URE)",
"description": "Get URE energy concessions for a company — full list of electricity, gas, heat, and liquid fuels, with validity dates and pending applications. Keyed by NIP. Identify company by name, KRS, or NIP.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP tax number (preferred for URE)."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get Energy Regulatory Office Licenses (URE)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get contracts from Poland's Central Register of Contracts (CRU JSFP, Ministry of Finance) where the company is the contractor of a public-sector unit (ministries, municipalities, schools, hospitals) — count, total value, top public buyers and the 50 most recent contracts (date, subject, value in PLN, buyer, link). Register live since July 2026; covers contracts below tender thresholds too. Keyed by NIP. Identify company by name, KRS, or NIP.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP tax number (preferred for CRU). |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_public_contracts",
"title": "Get Public Sector Contracts (CRU)",
"description": "Get contracts from Poland's Central Register of Contracts (CRU JSFP, Ministry of Finance) where the company is the contractor of a public-sector unit (ministries, municipalities, schools, hospitals) — count, total value, top public buyers and the 50 most recent contracts (date, subject, value in PLN, buyer, link). Register live since July 2026; covers contracts below tender thresholds too. Keyed by NIP. Identify company by name, KRS, or NIP.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP tax number (preferred for CRU)."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get Public Sector Contracts (CRU)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get contracts between the company (as a healthcare provider) and Poland's National Health Fund (NFZ) — value of NFZ contracts in the latest year and every year since 2008, types of care (hospital, outpatient, dental, rehabilitation, pharmacy etc.) with NFZ regional branch, and the largest contracts. Amounts are annual contract values in PLN. Keyed by NIP. Identify company by name, KRS, or NIP.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP tax number (preferred for NFZ). |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_nfz_contracts",
"title": "Get National Health Fund Contracts (NFZ)",
"description": "Get contracts between the company (as a healthcare provider) and Poland's National Health Fund (NFZ) — value of NFZ contracts in the latest year and every year since 2008, types of care (hospital, outpatient, dental, rehabilitation, pharmacy etc.) with NFZ regional branch, and the largest contracts. Amounts are annual contract values in PLN. Keyed by NIP. Identify company by name, KRS, or NIP.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP tax number (preferred for NFZ)."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get National Health Fund Contracts (NFZ)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get the corporate group of a Polish company from the global LEI register (GLEIF), supplemented with foreign corporate shareholders from KRS matched to it: direct parent and ultimate parent (name, country, LEI), subsidiaries and other group companies — Polish ones with KRS number, foreign ones with country — and group size. Answers 'who owns this company', 'which concern does it belong to', 'other companies of the group in Poland and abroad'. Keyed by KRS. Identify company by name, KRS, or NIP.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP tax number. |
| name | string | Company name when KRS/NIP is unknown. |
| limit | integer | Max group companies per list (default 50, max 200). |
{
"name": "get_company_group",
"title": "Get Corporate Group (GLEIF LEI register)",
"description": "Get the corporate group of a Polish company from the global LEI register (GLEIF), supplemented with foreign corporate shareholders from KRS matched to it: direct parent and ultimate parent (name, country, LEI), subsidiaries and other group companies — Polish ones with KRS number, foreign ones with country — and group size. Answers 'who owns this company', 'which concern does it belong to', 'other companies of the group in Poland and abroad'. Keyed by KRS. Identify company by name, KRS, or NIP.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP tax number."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
},
"limit": {
"type": "integer",
"description": "Max group companies per list (default 50, max 200)."
}
}
},
"annotations": {
"title": "Get Corporate Group",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get NFZ (National Health Fund) waiting lists of a healthcare provider — every NFZ-funded service (specialist clinics, diagnostics such as MRI/CT, procedures, rehabilitation, hospital wards) it runs a waiting list for, per location: NFZ forecast waiting time for stable and urgent cases, people waiting, average wait, address, phone, whether children are seen and accessibility. Sorted by shortest wait. Optional filters: service (e.g. 'okulist', 'rezonans') and town. Data from the NFZ 'Terminy leczenia' API; the forecast is not a booking. Keyed by NIP. Identify company by name, KRS, or NIP.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP tax number (preferred for NFZ). |
| name | string | Company name when KRS/NIP is unknown. |
| town | string | Optional filter: town or district, e.g. 'Poznań'. |
| limit | integer | Max rows (default 50, max 400). |
| service | string | Optional filter: fragment of the service name, e.g. 'okulist', 'ortoped', 'rezonans'. |
{
"name": "get_company_nfz_queues",
"title": "Get NFZ Waiting Lists (Terminy leczenia)",
"description": "Get NFZ (National Health Fund) waiting lists of a healthcare provider — every NFZ-funded service (specialist clinics, diagnostics such as MRI/CT, procedures, rehabilitation, hospital wards) it runs a waiting list for, per location: NFZ forecast waiting time for stable and urgent cases, people waiting, average wait, address, phone, whether children are seen and accessibility. Sorted by shortest wait. Optional filters: service (e.g. 'okulist', 'rezonans') and town. Data from the NFZ 'Terminy leczenia' API; the forecast is not a booking. Keyed by NIP. Identify company by name, KRS, or NIP.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP tax number (preferred for NFZ)."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
},
"town": {
"type": "string",
"description": "Optional filter: town or district, e.g. 'Poznań'."
},
"limit": {
"type": "integer",
"description": "Max rows (default 50, max 400)."
},
"service": {
"type": "string",
"description": "Optional filter: fragment of the service name, e.g. 'okulist', 'ortoped', 'rezonans'."
}
}
},
"annotations": {
"title": "Get NFZ Waiting Lists",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get Polish Patent Office (UPRP) trademarks owned or applied for by the company — mark name, application number, Nice classes, status (protected / pending / expired / refused), filing, registration and expiry dates, plus counts. Owners are matched by company name and city (UPRP does not publish NIP). Identify company by name, KRS, or NIP.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP tax number (preferred). |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_trademarks",
"title": "Get Trademarks (UPRP)",
"description": "Get Polish Patent Office (UPRP) trademarks owned or applied for by the company — mark name, application number, Nice classes, status (protected / pending / expired / refused), filing, registration and expiry dates, plus counts. Owners are matched by company name and city (UPRP does not publish NIP). Identify company by name, KRS, or NIP.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP tax number (preferred)."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get Trademarks (UPRP)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get corporate income tax (CIT) return data published by the Polish Ministry of Finance for the largest taxpayers (revenue above EUR 50 million), tax capital groups and real estate companies — revenue, tax-deductible costs, income, loss, tax base, tax due and effective rate for each year since 2020, plus national rank by tax due. These are tax-return categories (art. 12/15 CIT Act), not accounting figures: revenue and income differ from the financial statement (use get_financials for accounting revenue and income tax). Identify company by name, KRS, or NIP.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP tax number (preferred). |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_corporate_tax",
"title": "Get Corporate Income Tax (CIT)",
"description": "Get corporate income tax (CIT) return data published by the Polish Ministry of Finance for the largest taxpayers (revenue above EUR 50 million), tax capital groups and real estate companies — revenue, tax-deductible costs, income, loss, tax base, tax due and effective rate for each year since 2020, plus national rank by tax due. These are tax-return categories (art. 12/15 CIT Act), not accounting figures: revenue and income differ from the financial statement (use get_financials for accounting revenue and income tax). Identify company by name, KRS, or NIP.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP tax number (preferred)."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get Corporate Income Tax (CIT)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get public benefit organisation (OPP) status of a foundation or association — whether it is on the NIW list eligible for 1.5% of personal income tax, and the amounts it received from taxpayers' 1%/1.5% allocations each year since 2019 with approximate donor counts and national / regional rank. Identify by name or KRS.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP tax number. |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_public_benefit",
"title": "Get Public Benefit Status (OPP, 1.5% of tax)",
"description": "Get public benefit organisation (OPP) status of a foundation or association — whether it is on the NIW list eligible for 1.5% of personal income tax, and the amounts it received from taxpayers' 1%/1.5% allocations each year since 2019 with approximate donor counts and national / regional rank. Identify by name or KRS.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP tax number."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get Public Benefit Status (OPP, 1.5% of tax)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get National Appeal Chamber (Krajowa Izba Odwoławcza, KIO) rulings in public procurement disputes involving the company — as appellant (with upheld / dismissed / discontinued / rejected counts), as participant or as contracting authority — with case numbers, dates, other party and outcome. Parties are matched by name and city. Identify company by name, KRS, or NIP.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP tax number (preferred). |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_procurement_disputes",
"title": "Get Procurement Disputes (KIO)",
"description": "Get National Appeal Chamber (Krajowa Izba Odwoławcza, KIO) rulings in public procurement disputes involving the company — as appellant (with upheld / dismissed / discontinued / rejected counts), as participant or as contracting authority — with case numbers, dates, other party and outcome. Parties are matched by name and city. Identify company by name, KRS, or NIP.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP tax number (preferred)."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get Procurement Disputes (KIO)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get BDO waste and packaging register data — registration number, EUP site count, activity flags, and headquarters decisions with issue and validity dates. Keyed by NIP. Identify company by name, KRS, or NIP.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP tax number (preferred for BDO). |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_waste_registry",
"title": "Get Waste Management Registry (BDO)",
"description": "Get BDO waste and packaging register data — registration number, EUP site count, activity flags, and headquarters decisions with issue and validity dates. Keyed by NIP. Identify company by name, KRS, or NIP.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP tax number (preferred for BDO)."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get Waste Management Registry (BDO)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP tax number (preferred for GPW). |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_stock_market",
"title": "Get Warsaw Stock Exchange Data (GPW)",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP tax number (preferred for GPW)."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get Warsaw Stock Exchange Data (GPW)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get TED EU-threshold public procurement — full awards as contractor and notices as buyer. Keyed by NIP. Identify company by name, KRS, or NIP.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP tax number (preferred for TED). |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_eu_tenders",
"title": "Get EU Tenders Daily (TED)",
"description": "Get TED EU-threshold public procurement — full awards as contractor and notices as buyer. Keyed by NIP. Identify company by name, KRS, or NIP.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP tax number (preferred for TED)."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get EU Tenders Daily (TED)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get Court and Commercial Gazette (MSiG) notices for one company. Matched by KRS or NIP (creditor calls, dissolution, mergers, liquidation).
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP (CEIDG / when KRS unknown). |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_court_gazette",
"title": "Get Court and Commercial Gazette (MSiG)",
"description": "Get Court and Commercial Gazette (MSiG) notices for one company. Matched by KRS or NIP (creditor calls, dissolution, mergers, liquidation).",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP (CEIDG / when KRS unknown)."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get Court and Commercial Gazette (MSiG)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP tax number. |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_sanctions",
"title": "Get sanctions listing (MSWiA)",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP tax number."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get sanctions listing (MSWiA)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get KRZ insolvency / restructuring proceedings. KRS companies via company_krz; sole proprietors via CEIDG KRZ by NIP.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP (CEIDG / when KRS unknown). |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_debt_registry",
"title": "Get National Debt Register (KRZ)",
"description": "Get KRZ insolvency / restructuring proceedings. KRS companies via company_krz; sole proprietors via CEIDG KRZ by NIP.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP (CEIDG / when KRS unknown)."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get National Debt Register (KRZ)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP. |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_financial_supervision",
"title": "Get KNF Financial Supervision Register",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get KNF Financial Supervision Register",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Facts read from the company's own website: opening hours (per weekday), branches/locations with addresses, offer (CPV divisions plus short product/service names in PL/EN/DE), certifications found on the site (ISO 9001, HACCP, FSC…), website technology (CMS, e-commerce platform, payments, analytics) and clients/partners linked from the site that match KRS companies. Keyed by KRS or NIP (sole proprietors with a public profile); null when the website has not been read or shows none of these.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP. |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_website_facts",
"title": "Get Company Website Facts",
"description": "Facts read from the company's own website: opening hours (per weekday), branches/locations with addresses, offer (CPV divisions plus short product/service names in PL/EN/DE), certifications found on the site (ISO 9001, HACCP, FSC…), website technology (CMS, e-commerce platform, payments, analytics) and clients/partners linked from the site that match KRS companies. Keyed by KRS or NIP (sole proprietors with a public profile); null when the website has not been read or shows none of these.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get Company Website Facts",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Public procurement counterparties of a company from BZP, TED and CRU: the buyers it most often wins contracts from, the contractors it most often awards contracts to, and its consortium partners — each with KRS (when known), number of contracts, total value (PLN/EUR/USD) and years. Top 20 per role plus totals. Keyed by NIP/KRS; null when the company has no public procurement.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP. |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_procurement_counterparties",
"title": "Get Public Procurement Counterparties",
"description": "Public procurement counterparties of a company from BZP, TED and CRU: the buyers it most often wins contracts from, the contractors it most often awards contracts to, and its consortium partners — each with KRS (when known), number of contracts, total value (PLN/EUR/USD) and years. Top 20 per role plus totals. Keyed by NIP/KRS; null when the company has no public procurement.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get Public Procurement Counterparties",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Financial statement filing timeliness from KRS register entries (date each annual statement was filed) and the Financial Document Repository: for each recent financial year the period end, filing date, statutory deadline (year end + 6 months + 15 days), days late or not filed, and whether a statutory auditor's report was filed. Also overdue_year when the latest statement is past its deadline and missing, and late_last_5y. Keyed by KRS; null when the company has never filed.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP. |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_filing_timeliness",
"title": "Get Financial Statement Filing Timeliness",
"description": "Financial statement filing timeliness from KRS register entries (date each annual statement was filed) and the Financial Document Repository: for each recent financial year the period end, filing date, statutory deadline (year end + 6 months + 15 days), days late or not filed, and whether a statutory auditor's report was filed. Also overdue_year when the latest statement is past its deadline and missing, and late_last_5y. Keyed by KRS; null when the company has never filed.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get Financial Statement Filing Timeliness",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP. |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_secured_liabilities",
"title": "Get Secured Liabilities (Mortgages, Pledges)",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get Secured Liabilities (Mortgages, Pledges)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Company real estate from the latest financial statement (period ending 2025+): land incl. perpetual usufruct, buildings and premises, investment property (book values in PLN/EUR/USD) plus property locations named as mortgage collateral (address, land-register KW numbers, creditor). Keyed by KRS; null when the balance sheet shows no real estate (micro and small entities have no such breakdown).
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP. |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_real_estate",
"title": "Get Company Real Estate",
"description": "Company real estate from the latest financial statement (period ending 2025+): land incl. perpetual usufruct, buildings and premises, investment property (book values in PLN/EUR/USD) plus property locations named as mortgage collateral (address, land-register KW numbers, creditor). Keyed by KRS; null when the balance sheet shows no real estate (micro and small entities have no such breakdown).",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get Company Real Estate",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number (required path for CRBR). |
| nip | string | NIP — used to resolve KRS when needed. |
| name | string | Company name when KRS/NIP is unknown. |
{
"name": "get_company_beneficiaries",
"title": "Get Ultimate Beneficial Owners (CRBR)",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number (required path for CRBR)."
},
"nip": {
"type": "string",
"description": "NIP — used to resolve KRS when needed."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
}
}
},
"annotations": {
"title": "Get Ultimate Beneficial Owners (CRBR)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get full text of the company's articles of association or statute (umowa spółki / statut) from RAR (Repozytorium Akt Rejestrowych). Use when the user asks about: share transfer consent, preemption rights, non-compete clauses, company duration, voting rights, special share classes, representation rules from the deed, or any clause in the founding document. Returns doc metadata + full extracted text. KRS companies only.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number. |
| nip | string | NIP — used to resolve KRS when needed. |
| name | string | Company name when KRS/NIP is unknown. |
| doc_id | string | Optional: specific rar_doc_id. Omit for the latest articles / statute. |
{
"name": "get_company_articles",
"title": "Get Articles of Association",
"description": "Get full text of the company's articles of association or statute (umowa spółki / statut) from RAR (Repozytorium Akt Rejestrowych). Use when the user asks about: share transfer consent, preemption rights, non-compete clauses, company duration, voting rights, special share classes, representation rules from the deed, or any clause in the founding document. Returns doc metadata + full extracted text. KRS companies only.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP — used to resolve KRS when needed."
},
"name": {
"type": "string",
"description": "Company name when KRS/NIP is unknown."
},
"doc_id": {
"type": "string",
"description": "Optional: specific rar_doc_id. Omit for the latest articles / statute."
}
}
},
"annotations": {
"title": "Get Articles of Association",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get current billing period usage and remaining quota — mcp_queries, api_requests, export_companies, ask_ai_credits, watchlist_companies. Includes limits and reset date.
No parameters.
{
"name": "get_usage",
"title": "Get Account Usage & Quota",
"description": "Get current billing period usage and remaining quota — mcp_queries, api_requests, export_companies, ask_ai_credits, watchlist_companies. Includes limits and reset date.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "Get Account Usage & Quota",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Get the user's active billing plan details — plan name, price, status, limits, prepaid credit balance, and billing period reset date.
No parameters.
{
"name": "get_plan",
"title": "Get Current Subscription Plan",
"description": "Get the user's active billing plan details — plan name, price, status, limits, prepaid credit balance, and billing period reset date.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "Get Current Subscription Plan",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List companies on the user's watchlist with company data (name, KRS, NIP, revenue, city). Supports pagination via limit/offset.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max results (default: 20, max: 100). |
| offset | integer | Pagination offset (default: 0). |
{
"name": "list_watchlist",
"title": "List Watchlist Companies",
"description": "List companies on the user's watchlist with company data (name, KRS, NIP, revenue, city). Supports pagination via limit/offset.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max results (default: 20, max: 100)."
},
"offset": {
"type": "integer",
"minimum": 0,
"description": "Pagination offset (default: 0)."
}
}
},
"annotations": {
"title": "List Watchlist Companies",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Add a company to the user's watchlist. Identify by KRS (10-digit) or NIP (10-digit). Supports both KRS companies and CEIDG sole proprietorships (via NIP).
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number (10 digits, zero-padded). |
| nip | string | NIP tax number (10 digits). Used for CEIDG if no KRS match. |
{
"name": "add_to_watchlist",
"title": "Add Company to Watchlist",
"description": "Add a company to the user's watchlist. Identify by KRS (10-digit) or NIP (10-digit). Supports both KRS companies and CEIDG sole proprietorships (via NIP).",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number (10 digits, zero-padded)."
},
"nip": {
"type": "string",
"description": "NIP tax number (10 digits). Used for CEIDG if no KRS match."
}
}
},
"annotations": {
"title": "Add Company to Watchlist",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Remove a company from the user's watchlist. Identify by KRS or NIP.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number (10 digits, zero-padded). |
| nip | string | NIP tax number (10 digits). |
{
"name": "remove_from_watchlist",
"title": "Remove Company from Watchlist",
"description": "Remove a company from the user's watchlist. Identify by KRS or NIP.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number (10 digits, zero-padded)."
},
"nip": {
"type": "string",
"description": "NIP tax number (10 digits)."
}
}
},
"annotations": {
"title": "Remove Company from Watchlist",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}List all active REST API keys (cb_…) for the user's account. Returns id, name, key_prefix, created_at, last_used_at.
No parameters.
{
"name": "list_api_keys",
"title": "List REST API Keys",
"description": "List all active REST API keys (cb_…) for the user's account. Returns id, name, key_prefix, created_at, last_used_at.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "List REST API Keys",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Create a new REST API key (cb_…). The raw key is returned once and cannot be retrieved later.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Human-readable label for the key (max 100 chars). |
{
"name": "create_api_key",
"title": "Create REST API Key",
"description": "Create a new REST API key (cb_…). The raw key is returned once and cannot be retrieved later.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Human-readable label for the key (max 100 chars)."
}
}
},
"annotations": {
"title": "Create REST API Key",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Revoke (deactivate) a REST API key by its ID. The key stops working immediately.
| Parameter | Type | Description |
|---|---|---|
| key_id * | string | UUID of the API key to revoke (from list_api_keys). |
{
"name": "delete_api_key",
"title": "Revoke REST API Key",
"description": "Revoke (deactivate) a REST API key by its ID. The key stops working immediately.",
"inputSchema": {
"type": "object",
"required": [
"key_id"
],
"properties": {
"key_id": {
"type": "string",
"description": "UUID of the API key to revoke (from list_api_keys)."
}
}
},
"annotations": {
"title": "Revoke REST API Key",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}List all active MCP keys (mcpk_…) for the user's account. Returns id, name, key_prefix, created_at, last_used_at.
No parameters.
{
"name": "list_mcp_keys",
"title": "List MCP Keys",
"description": "List all active MCP keys (mcpk_…) for the user's account. Returns id, name, key_prefix, created_at, last_used_at.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "List MCP Keys",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Create a new MCP key (mcpk_…). The raw key is returned once and cannot be retrieved later.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Human-readable label for the key (max 100 chars). |
{
"name": "create_mcp_key",
"title": "Create MCP Key",
"description": "Create a new MCP key (mcpk_…). The raw key is returned once and cannot be retrieved later.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Human-readable label for the key (max 100 chars)."
}
}
},
"annotations": {
"title": "Create MCP Key",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Revoke (deactivate) an MCP key by its ID. Cannot revoke the key currently in use. The key stops working immediately.
| Parameter | Type | Description |
|---|---|---|
| key_id * | string | UUID of the MCP key to revoke (from list_mcp_keys). |
{
"name": "delete_mcp_key",
"title": "Revoke MCP Key",
"description": "Revoke (deactivate) an MCP key by its ID. Cannot revoke the key currently in use. The key stops working immediately.",
"inputSchema": {
"type": "object",
"required": [
"key_id"
],
"properties": {
"key_id": {
"type": "string",
"description": "UUID of the MCP key to revoke (from list_mcp_keys)."
}
}
},
"annotations": {
"title": "Revoke MCP Key",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Bulk file export of companies matching filters (CSV / XLSX / JSON). Up to 500 rows per call. Default `fields=contacts_only`: name, NIP, KRS, city, email, phone, website — small enough to use in-chat. `fields=summary` adds location, PKD, latest revenue/profit. `fields=full` is the complete dump (change history, rankings, people, enrichments, CSV twins) and often exceeds MCP client limits. Consumes export quota only after the file is built successfully. A short list of emails is also available directly from search_companies with fields=contacts_only.
| Parameter | Type | Description |
|---|---|---|
| krs | string | KRS registry number (exports that one company). |
| nip | string | NIP tax number (exports matching companies). |
| pkd | string | Primary PKD code prefix, e.g. '80.10', '80.10.Z', or '80' (same prefix matching as search_companies). |
| city | string | City name. |
| name | string | Company name fragment (case-insensitive). |
| limit | integer | Max rows to export (default: 50, max: 500). |
| county | string | County / powiat (lowercase). Same filter as search_companies / count_companies. |
| fields | string | Payload size. Default contacts_only (name, NIP, KRS, city, email, phone, website). summary adds county/region, PKD, latest revenue/profit. full is the complete profile dump — often too large for MCP clients; use only when asked for the full file. |
Create a Stripe Checkout session for a plan upgrade. Shows current plan and available upgrades. Pass plan_id ('pro' or 'scale') to get a checkout_url on checkout.stripe.com — the user pays there in the browser. The checkout_url is the direct payment page for the selected plan.
| Parameter | Type | Description |
|---|---|---|
| locale | string | UI locale for the success/cancel return URLs (default en). |
| plan_id | string | Target plan ID. Required to create a Stripe Checkout URL. |
| currency | string | Checkout currency. Defaults from locale (pl → PLN, otherwise USD). |
{
"name": "upgrade_plan",
"title": "Upgrade Subscription Plan",
"description": "Create a Stripe Checkout session for a plan upgrade. Shows current plan and available upgrades. Pass plan_id ('pro' or 'scale') to get a checkout_url on checkout.stripe.com — the user pays there in the browser. The checkout_url is the direct payment page for the selected plan.",
"inputSchema": {
"type": "object",
"properties": {
"locale": {
"enum": [
"en",
"pl",
"de"
],
"type": "string",
"description": "UI locale for the success/cancel return URLs (default en)."
},
"plan_id": {
"enum": [
"pro",
"scale"
],
"type": "string",
"description": "Target plan ID. Required to create a Stripe Checkout URL."
},
"currency": {
"enum": [
"PLN",
"USD",
"EUR"
],
"type": "string",
"description": "Checkout currency. Defaults from locale (pl → PLN, otherwise USD)."
}
}
},
"annotations": {
"title": "Upgrade Subscription Plan",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Configure, view, or remove webhook for watchlist event notifications. Events (default: all): watchlist.company_changed, watchlist.board_changed, watchlist.ownership_changed, watchlist.status_changed, watchlist.company_removed_from_registry, watchlist.financials_updated, watchlist.filing_overdue, watchlist.insolvency, watchlist.court_gazette, watchlist.secured_liabilities, watchlist.sanctions, watchlist.public_tenders, watchlist.public_aid, watchlist.licenses, watchlist.nfz, watchlist.trademarks, watchlist.job_offers.
| Parameter | Type | Description |
|---|---|---|
| url | string | HTTPS webhook endpoint URL (required for action=set). |
| action * | string | Action: 'get' to view config, 'set' to configure, 'delete' to remove. |
| events | array | Event types to subscribe to. Defaults to all available events. |
{
"name": "set_webhook_url",
"title": "Configure Webhook URL",
"description": "Configure, view, or remove webhook for watchlist event notifications. Events (default: all): watchlist.company_changed, watchlist.board_changed, watchlist.ownership_changed, watchlist.status_changed, watchlist.company_removed_from_registry, watchlist.financials_updated, watchlist.filing_overdue, watchlist.insolvency, watchlist.court_gazette, watchlist.secured_liabilities, watchlist.sanctions, watchlist.public_tenders, watchlist.public_aid, watchlist.licenses, watchlist.nfz, watchlist.trademarks, watchlist.job_offers.",
"inputSchema": {
"type": "object",
"required": [
"action"
],
"properties": {
"url": {
"type": "string",
"description": "HTTPS webhook endpoint URL (required for action=set)."
},
"action": {
"enum": [
"get",
"set",
"delete"
],
"type": "string",
"description": "Action: 'get' to view config, 'set' to configure, 'delete' to remove."
},
"events": {
"type": "array",
"items": {
"type": "string"
},
"description": "Event types to subscribe to. Defaults to all available events."
}
}
},
"annotations": {
"title": "Configure Webhook URL",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List configured Bring-Your-Own-Key (BYOK) provider keys status. Shows which providers (openai, claude, gemini) have keys configured, with prefix and last-used date. Never returns the actual key.
No parameters.
{
"name": "get_byok_keys",
"title": "Get Bring-Your-Own-Key Providers",
"description": "List configured Bring-Your-Own-Key (BYOK) provider keys status. Shows which providers (openai, claude, gemini) have keys configured, with prefix and last-used date. Never returns the actual key.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "Get Bring-Your-Own-Key Providers",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Add or update a BYOK provider API key. Key is encrypted at rest (AES-256-GCM). Requires paid plan (Pro+). Providers: openai (sk-…), claude (sk-ant-…), gemini (AIza… or AQ.…).
| Parameter | Type | Description |
|---|---|---|
| api_key * | string | Raw API key for the provider. |
| provider * | string | AI provider name. |
{
"name": "set_byok_key",
"title": "Set Bring-Your-Own-Key Provider",
"description": "Add or update a BYOK provider API key. Key is encrypted at rest (AES-256-GCM). Requires paid plan (Pro+). Providers: openai (sk-…), claude (sk-ant-…), gemini (AIza… or AQ.…).",
"inputSchema": {
"type": "object",
"required": [
"provider",
"api_key"
],
"properties": {
"api_key": {
"type": "string",
"description": "Raw API key for the provider."
},
"provider": {
"enum": [
"openai",
"claude",
"gemini"
],
"type": "string",
"description": "AI provider name."
}
}
},
"annotations": {
"title": "Set Bring-Your-Own-Key Provider",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Remove a configured BYOK provider key. After removal, the platform falls back to its own model access.
| Parameter | Type | Description |
|---|---|---|
| provider * | string | Provider to remove key for. |
{
"name": "delete_byok_key",
"title": "Remove Bring-Your-Own-Key Provider",
"description": "Remove a configured BYOK provider key. After removal, the platform falls back to its own model access.",
"inputSchema": {
"type": "object",
"required": [
"provider"
],
"properties": {
"provider": {
"enum": [
"openai",
"claude",
"gemini"
],
"type": "string",
"description": "Provider to remove key for."
}
}
},
"annotations": {
"title": "Remove Bring-Your-Own-Key Provider",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Add multiple companies to watchlist in one call. Provide an array of KRS/NIP identifiers (max 500). Resolves identifiers to companies, skips duplicates, respects plan limits.
| Parameter | Type | Description |
|---|---|---|
| identifiers * | array | Array of KRS numbers (10 digits) or NIP numbers (10 digits). |
{
"name": "add_watchlist_batch",
"title": "Batch Add Companies to Watchlist",
"description": "Add multiple companies to watchlist in one call. Provide an array of KRS/NIP identifiers (max 500). Resolves identifiers to companies, skips duplicates, respects plan limits.",
"inputSchema": {
"type": "object",
"required": [
"identifiers"
],
"properties": {
"identifiers": {
"type": "array",
"items": {
"type": "string"
},
"description": "Array of KRS numbers (10 digits) or NIP numbers (10 digits)."
}
}
},
"annotations": {
"title": "Batch Add Companies to Watchlist",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Get or update email notification preferences for watchlist changes. When email_notifications=true, you will receive an email whenever a watched company's data changes (registry updates, new financial statements, deregistration, etc.).
| Parameter | Type | Description |
|---|---|---|
| action * | string | 'get' returns current preferences, 'set' updates them. |
| notification_email | string | Override email address for notifications. Omit to use account email. |
| email_notifications | boolean | Enable/disable email notifications for watchlist changes (required for 'set'). |
{
"name": "set_notification_preferences",
"title": "Set Notification Preferences",
"description": "Get or update email notification preferences for watchlist changes. When email_notifications=true, you will receive an email whenever a watched company's data changes (registry updates, new financial statements, deregistration, etc.).",
"inputSchema": {
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"enum": [
"get",
"set"
],
"type": "string",
"description": "'get' returns current preferences, 'set' updates them."
},
"notification_email": {
"type": "string",
"description": "Override email address for notifications. Omit to use account email."
},
"email_notifications": {
"type": "boolean",
"description": "Enable/disable email notifications for watchlist changes (required for 'set')."
}
}
},
"annotations": {
"title": "Set Notification Preferences",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}You are connected to Compabase MCP without an account key. Call request_signup with the user's email, tell them to click the Compabase link, then poll check_signup. When status is ready, save mcp_key to the user's MCP config and ask them to reload this server. Do not ask the user to generate an MCP key in the portal. list_plans shows pricing. Data tools require a key after sign-up.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| integer |
| Max results (default: 10, max: 50). |
| naics | string | Detailed industry: NAICS 6-digit codes, comma-separated (any of them), e.g. '541511,541512'. AI classification of what the company actually does. |
| niche | string | Detailed industry in words (Polish), matched against the company's niche, e.g. 'opakowania', 'software house', 'catering'. |
| county | string | County / powiat (lowercase). |
| fields | string | 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. |
| region | string | Voivodeship (lowercase), e.g. 'mazowieckie', 'wielkopolskie'. |
| all_pkd | string | Match any PKD code in the company's activity list (not just primary). |
| service | string | Service the company offers (Compabase services dictionary, from company websites): service name in Polish/English/German, e.g. 'księgowość', 'heat pumps', or slugs from compabase.com/services, comma-separated (any of them). |
| sort_by | string | 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). |
| currency | string | Currency for monetary filters. Default: pln. |
| sort_dir | string | Sort direction (default: desc). |
| has_email | boolean | true = only companies with email on record. Matching rows include contacts.email. Omit otherwise. |
| is_active | boolean | true = active only, false = closed only. Omit for all. |
| ebitda_max | number | Maximum EBITDA. |
| ebitda_min | number | Minimum EBITDA. |
| legal_form | string | Legal form fragment, e.g. 'spółka z o.o.' or 'akcyjna'. |
| profit_max | number | Maximum net profit. |
| profit_min | number | Minimum net profit. |
| capital_max | number | Maximum share capital. |
| capital_min | number | Minimum share capital. |
| has_website | boolean | true = only companies with website on record. Matching rows include contacts.website. Omit otherwise. |
| postal_code | string | Postal code prefix, e.g. '00-9' or '61-'. |
| revenue_max | number | Maximum total revenue. |
| revenue_min | number | Minimum total revenue. |
| family_business | boolean | true = family business (people with the same surname hold ≥50%). |
| total_assets_max | number | Maximum total assets. |
| total_assets_min | number | Minimum total assets. |
| estimated_value_max | number | Maximum Ohlson estimated equity value in PLN. |
| estimated_value_min | number | Minimum Ohlson estimated equity value in PLN. |
| ownership_structure | string | Ownership: pl_independent = Polish company controlled by individuals; pl_group = part of a Polish group (a Polish company holds ≥50%); foreign_group = foreign shareholders ≥50% or foreign parent (GLEIF / CRBR). |
| profit_operating_max | number | Maximum operating profit (PLN). Omit if unused. |
| profit_operating_min | number | Minimum operating profit (PLN). Negative allowed. Omit if unused. |
| registration_date_max | string | Latest KRS registration date, YYYY-MM-DD (inclusive). |
| registration_date_min | string | 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. |
{
"name": "search_companies",
"title": "Search Polish Companies",
"description": "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). For a handful of emails or phones, fields=contacts_only here is enough; export_companies is meant for bulk files.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number (10 digits, zero-padded, e.g. '0000028860')."
},
"nip": {
"type": "string",
"description": "NIP tax number (10 digits, no dashes)."
},
"pkd": {
"type": "string",
"description": "Primary PKD code prefix, e.g. '46.90.Z' or '46'."
},
"city": {
"type": "string",
"description": "City name — KRS records use uppercase, e.g. 'WARSZAWA', 'POZNAŃ'."
},
"name": {
"type": "string",
"description": "Company name fragment (case-insensitive). Matches display name and full KRS name; legal-form suffixes like 'sp. z o.o.' are ignored."
},
"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",
"maximum": 50,
"minimum": 1,
"description": "Max results (default: 10, max: 50)."
},
"naics": {
"type": "string",
"description": "Detailed industry: NAICS 6-digit codes, comma-separated (any of them), e.g. '541511,541512'. AI classification of what the company actually does."
},
"niche": {
"type": "string",
"description": "Detailed industry in words (Polish), matched against the company's niche, e.g. 'opakowania', 'software house', 'catering'."
},
"county": {
"type": "string",
"description": "County / powiat (lowercase)."
},
"fields": {
"enum": [
"contacts_only",
"summary",
"full"
],
"type": "string",
"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."
},
"region": {
"type": "string",
"description": "Voivodeship (lowercase), e.g. 'mazowieckie', 'wielkopolskie'."
},
"all_pkd": {
"type": "string",
"description": "Match any PKD code in the company's activity list (not just primary)."
},
"service": {
"type": "string",
"description": "Service the company offers (Compabase services dictionary, from company websites): service name in Polish/English/German, e.g. 'księgowość', 'heat pumps', or slugs from compabase.com/services, comma-separated (any of them)."
},
"sort_by": {
"enum": [
"revenue_total",
"profit_net",
"total_assets",
"profit_operating",
"ebitda",
"capital_total",
"estimated_value",
"registration_date",
"revenue_growth_pct"
],
"type": "string",
"description": "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)."
},
"currency": {
"enum": [
"pln",
"usd",
"eur"
],
"type": "string",
"description": "Currency for monetary filters. Default: pln."
},
"sort_dir": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction (default: desc)."
},
"has_email": {
"type": "boolean",
"description": "true = only companies with email on record. Matching rows include contacts.email. Omit otherwise."
},
"is_active": {
"type": "boolean",
"description": "true = active only, false = closed only. Omit for all."
},
"ebitda_max": {
"type": "number",
"description": "Maximum EBITDA."
},
"ebitda_min": {
"type": "number",
"description": "Minimum EBITDA."
},
"legal_form": {
"type": "string",
"description": "Legal form fragment, e.g. 'spółka z o.o.' or 'akcyjna'."
},
"profit_max": {
"type": "number",
"description": "Maximum net profit."
},
"profit_min": {
"type": "number",
"description": "Minimum net profit."
},
"capital_max": {
"type": "number",
"description": "Maximum share capital."
},
"capital_min": {
"type": "number",
"description": "Minimum share capital."
},
"has_website": {
"type": "boolean",
"description": "true = only companies with website on record. Matching rows include contacts.website. Omit otherwise."
},
"postal_code": {
"type": "string",
"description": "Postal code prefix, e.g. '00-9' or '61-'."
},
"revenue_max": {
"type": "number",
"description": "Maximum total revenue."
},
"revenue_min": {
"type": "number",
"description": "Minimum total revenue."
},
"family_business": {
"type": "boolean",
"description": "true = family business (people with the same surname hold ≥50%)."
},
"total_assets_max": {
"type": "number",
"description": "Maximum total assets."
},
"total_assets_min": {
"type": "number",
"description": "Minimum total assets."
},
"estimated_value_max": {
"type": "number",
"description": "Maximum Ohlson estimated equity value in PLN."
},
"estimated_value_min": {
"type": "number",
"description": "Minimum Ohlson estimated equity value in PLN."
},
"ownership_structure": {
"enum": [
"pl_independent",
"pl_group",
"foreign_group"
],
"type": "string",
"description": "Ownership: pl_independent = Polish company controlled by individuals; pl_group = part of a Polish group (a Polish company holds ≥50%); foreign_group = foreign shareholders ≥50% or foreign parent (GLEIF / CRBR)."
},
"profit_operating_max": {
"type": "number",
"description": "Maximum operating profit (PLN). Omit if unused."
},
"profit_operating_min": {
"type": "number",
"description": "Minimum operating profit (PLN). Negative allowed. Omit if unused."
},
"registration_date_max": {
"type": "string",
"description": "Latest KRS registration date, YYYY-MM-DD (inclusive)."
},
"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."
}
}
},
"annotations": {
"title": "Search Polish Companies",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}| County / powiat (lowercase). |
| region | string | Voivodeship (lowercase). |
| all_pkd | string | Match any PKD code in the company's activity list (not just primary). |
| service | string | Service the company offers (Compabase services dictionary, from company websites): service name in Polish/English/German, e.g. 'księgowość', 'heat pumps', or slugs from compabase.com/services, comma-separated (any of them). |
| has_email | boolean | true = only companies with email on record. Omit otherwise. |
| is_active | boolean | true = active only, false = closed only. Omit for all. |
| ebitda_max | number | Maximum EBITDA in PLN. |
| ebitda_min | number | Minimum EBITDA in PLN. |
| legal_form | string | Legal form fragment. |
| profit_max | number | Maximum net profit in PLN. |
| profit_min | number | Minimum net profit in PLN. |
| capital_max | number | Maximum share capital in PLN. |
| capital_min | number | Minimum share capital in PLN. |
| has_website | boolean | true = only companies with website on record. Omit otherwise. |
| revenue_max | number | Maximum total revenue in PLN. |
| revenue_min | number | Minimum total revenue in PLN. |
| family_business | boolean | true = family business (people with the same surname hold ≥50%). |
| total_assets_max | number | Maximum total assets in PLN. |
| total_assets_min | number | Minimum total assets in PLN. |
| estimated_value_max | number | Maximum Ohlson estimated equity value in PLN. |
| estimated_value_min | number | Minimum Ohlson estimated equity value in PLN. |
| ownership_structure | string | Ownership: pl_independent = Polish company controlled by individuals; pl_group = part of a Polish group (a Polish company holds ≥50%); foreign_group = foreign shareholders ≥50% or foreign parent (GLEIF / CRBR). |
| profit_operating_max | number | Maximum operating profit in PLN. |
| profit_operating_min | number | Minimum operating profit in PLN. |
| registration_date_max | string | Latest KRS registration date, YYYY-MM-DD (inclusive). |
| registration_date_min | string | 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. |
{
"name": "count_companies",
"title": "Count Polish Companies",
"description": "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`.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number."
},
"nip": {
"type": "string",
"description": "NIP tax number."
},
"pkd": {
"type": "string",
"description": "Primary PKD code prefix, e.g. '46.90.Z' or '46'."
},
"city": {
"type": "string",
"description": "City name — KRS uses uppercase."
},
"name": {
"type": "string",
"description": "Company name fragment (case-insensitive). Matches display name and full KRS name; legal-form suffixes like 'sp. z o.o.' are ignored."
},
"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."
},
"naics": {
"type": "string",
"description": "Detailed industry: NAICS 6-digit codes, comma-separated (any of them), e.g. '541511,541512'. AI classification of what the company actually does."
},
"niche": {
"type": "string",
"description": "Detailed industry in words (Polish), matched against the company's niche, e.g. 'opakowania', 'software house', 'catering'."
},
"county": {
"type": "string",
"description": "County / powiat (lowercase)."
},
"region": {
"type": "string",
"description": "Voivodeship (lowercase)."
},
"all_pkd": {
"type": "string",
"description": "Match any PKD code in the company's activity list (not just primary)."
},
"service": {
"type": "string",
"description": "Service the company offers (Compabase services dictionary, from company websites): service name in Polish/English/German, e.g. 'księgowość', 'heat pumps', or slugs from compabase.com/services, comma-separated (any of them)."
},
"has_email": {
"type": "boolean",
"description": "true = only companies with email on record. Omit otherwise."
},
"is_active": {
"type": "boolean",
"description": "true = active only, false = closed only. Omit for all."
},
"ebitda_max": {
"type": "number",
"description": "Maximum EBITDA in PLN."
},
"ebitda_min": {
"type": "number",
"description": "Minimum EBITDA in PLN."
},
"legal_form": {
"type": "string",
"description": "Legal form fragment."
},
"profit_max": {
"type": "number",
"description": "Maximum net profit in PLN."
},
"profit_min": {
"type": "number",
"description": "Minimum net profit in PLN."
},
"capital_max": {
"type": "number",
"description": "Maximum share capital in PLN."
},
"capital_min": {
"type": "number",
"description": "Minimum share capital in PLN."
},
"has_website": {
"type": "boolean",
"description": "true = only companies with website on record. Omit otherwise."
},
"revenue_max": {
"type": "number",
"description": "Maximum total revenue in PLN."
},
"revenue_min": {
"type": "number",
"description": "Minimum total revenue in PLN."
},
"family_business": {
"type": "boolean",
"description": "true = family business (people with the same surname hold ≥50%)."
},
"total_assets_max": {
"type": "number",
"description": "Maximum total assets in PLN."
},
"total_assets_min": {
"type": "number",
"description": "Minimum total assets in PLN."
},
"estimated_value_max": {
"type": "number",
"description": "Maximum Ohlson estimated equity value in PLN."
},
"estimated_value_min": {
"type": "number",
"description": "Minimum Ohlson estimated equity value in PLN."
},
"ownership_structure": {
"enum": [
"pl_independent",
"pl_group",
"foreign_group"
],
"type": "string",
"description": "Ownership: pl_independent = Polish company controlled by individuals; pl_group = part of a Polish group (a Polish company holds ≥50%); foreign_group = foreign shareholders ≥50% or foreign parent (GLEIF / CRBR)."
},
"profit_operating_max": {
"type": "number",
"description": "Maximum operating profit in PLN."
},
"profit_operating_min": {
"type": "number",
"description": "Minimum operating profit in PLN."
},
"registration_date_max": {
"type": "string",
"description": "Latest KRS registration date, YYYY-MM-DD (inclusive)."
},
"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."
}
}
},
"annotations": {
"title": "Count Polish Companies",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}| format | string | Export format (default: csv). Column set follows `fields` (contacts_only by default). |
| locale | string | Column/label language (default: en). |
| region | string | Voivodeship (e.g. mazowieckie). |
| all_pkd | string | Match any PKD code in the company's activity list (not just primary). |
| is_active | boolean | true = active companies only. |
| revenue_max | number | Maximum total revenue. |
| revenue_min | number | Minimum total revenue. |
{
"name": "export_companies",
"title": "Export Companies to CSV",
"description": "Bulk file export of companies matching filters (CSV / XLSX / JSON). Up to 500 rows per call. Default `fields=contacts_only`: name, NIP, KRS, city, email, phone, website — small enough to use in-chat. `fields=summary` adds location, PKD, latest revenue/profit. `fields=full` is the complete dump (change history, rankings, people, enrichments, CSV twins) and often exceeds MCP client limits. Consumes export quota only after the file is built successfully. A short list of emails is also available directly from search_companies with fields=contacts_only.",
"inputSchema": {
"type": "object",
"properties": {
"krs": {
"type": "string",
"description": "KRS registry number (exports that one company)."
},
"nip": {
"type": "string",
"description": "NIP tax number (exports matching companies)."
},
"pkd": {
"type": "string",
"description": "Primary PKD code prefix, e.g. '80.10', '80.10.Z', or '80' (same prefix matching as search_companies)."
},
"city": {
"type": "string",
"description": "City name."
},
"name": {
"type": "string",
"description": "Company name fragment (case-insensitive)."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Max rows to export (default: 50, max: 500)."
},
"county": {
"type": "string",
"description": "County / powiat (lowercase). Same filter as search_companies / count_companies."
},
"fields": {
"enum": [
"contacts_only",
"summary",
"full"
],
"type": "string",
"description": "Payload size. Default contacts_only (name, NIP, KRS, city, email, phone, website). summary adds county/region, PKD, latest revenue/profit. full is the complete profile dump — often too large for MCP clients; use only when asked for the full file."
},
"format": {
"enum": [
"csv",
"xlsx",
"json"
],
"type": "string",
"description": "Export format (default: csv). Column set follows `fields` (contacts_only by default)."
},
"locale": {
"enum": [
"en",
"pl",
"de"
],
"type": "string",
"description": "Column/label language (default: en)."
},
"region": {
"type": "string",
"description": "Voivodeship (e.g. mazowieckie)."
},
"all_pkd": {
"type": "string",
"description": "Match any PKD code in the company's activity list (not just primary)."
},
"is_active": {
"type": "boolean",
"description": "true = active companies only."
},
"revenue_max": {
"type": "number",
"description": "Maximum total revenue."
},
"revenue_min": {
"type": "number",
"description": "Minimum total revenue."
}
}
},
"annotations": {
"title": "Export Companies to CSV",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}