Servers Playground How we check Add a server Log in

Compabase

Working · 2.8 s

io.github.ContentWriterco/compabasev1.6.2

3M+ Polish companies (KRS, CEIDG): financials, people, rankings and public registries.

Legal & Government

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://compabase.com/api/mcp

Authorization (optional)

Optional at first connect. After signup: Bearer mcpk_… from request_signup/check_signup or https://compabase.com/integrations?tab=mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

add_to_watchlist

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).

krsstring

KRS registry number (10 digits, zero-padded).

nipstring

NIP tax number (10 digits). Used for CEIDG if no KRS match.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Compabase MCP server | mcptry

Compabase

Working · 2.8 s

io.github.ContentWriterco/compabasev1.6.2

3M+ Polish companies (KRS, CEIDG): financials, people, rankings and public registries.

Legal & Government

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://compabase.com/api/mcp

Authorization (optional)

Optional at first connect. After signup: Bearer mcpk_… from request_signup/check_signup or https://compabase.com/integrations?tab=mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

add_to_watchlist

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).

krsstring

KRS registry number (10 digits, zero-padded).

nipstring

NIP tax number (10 digits). Used for CEIDG if no KRS match.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (50)

add_to_watchlist

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).

Argument	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.

Input schema (JSON)

{
  "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."
    }
  }
}

add_watchlist_batch

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.

Argument	Type	Description
identifiers*	array	Array of KRS numbers (10 digits) or NIP numbers (10 digits).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "identifiers"
  ],
  "properties": {
    "identifiers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of KRS numbers (10 digits) or NIP numbers (10 digits)."
    }
  }
}

check_signup

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.

Argument	Type	Description
client	string	Optional client hint for the key name.
setup_id*	string	setup_id from request_signup.

Input schema (JSON)

{
  "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."
    }
  }
}

count_companies

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`.

read-only

Argument	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.
county	string	County / powiat (lowercase).
region	string	Voivodeship (lowercase).
all_pkd

create_api_key

Create a new REST API key (cb_…). The raw key is returned once and cannot be retrieved later.

Argument	Type	Description
name*	string	Human-readable label for the key (max 100 chars).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Human-readable label for the key (max 100 chars)."
    }
  }
}

create_mcp_key

Create a new MCP key (mcpk_…). The raw key is returned once and cannot be retrieved later.

Argument	Type	Description
name*	string	Human-readable label for the key (max 100 chars).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Human-readable label for the key (max 100 chars)."
    }
  }
}

delete_api_key

Revoke (deactivate) a REST API key by its ID. The key stops working immediately.

destructive

Argument	Type	Description
key_id*	string	UUID of the API key to revoke (from list_api_keys).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "key_id"
  ],
  "properties": {
    "key_id": {
      "type": "string",
      "description": "UUID of the API key to revoke (from list_api_keys)."
    }
  }
}

delete_byok_key

Remove a configured BYOK provider key. After removal, the platform falls back to its own model access.

destructive

Argument	Type	Description
provider*	string	Provider to remove key for.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "provider"
  ],
  "properties": {
    "provider": {
      "enum": [
        "openai",
        "claude",
        "gemini"
      ],
      "type": "string",
      "description": "Provider to remove key for."
    }
  }
}

delete_mcp_key

Revoke (deactivate) an MCP key by its ID. Cannot revoke the key currently in use. The key stops working immediately.

destructive

Argument	Type	Description
key_id*	string	UUID of the MCP key to revoke (from list_mcp_keys).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "key_id"
  ],
  "properties": {
    "key_id": {
      "type": "string",
      "description": "UUID of the MCP key to revoke (from list_mcp_keys)."
    }
  }
}

execute_sql

Execute a read-only SQL SELECT query against the Compabase database. Use when dedicated tools are not enough (aggregations, joins, custom analysis).

read-only

Argument	Type	Description
query*	string	A read-only SQL SELECT or WITH…SELECT statement.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "A read-only SQL SELECT or WITH…SELECT statement."
    }
  }
}

export_companies

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. For a short list of emails after search_companies, use search with fields=contacts_only instead.

Argument	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.

get_byok_keys

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

get_company

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 `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.

read-only

Argument	Type	Description
krs	string	KRS registry number (10 digits, zero-padded).
nip	string	NIP tax number (10 digits, dashes optional).
name	string	Company name when KRS/NIP is unknown (legal-form suffix optional).

Input schema (JSON)

{
  "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)."
    },
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown (legal-form suffix optional)."
    }
  }
}

get_company_articles

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.

read-only

Argument	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.

Input schema (JSON)

{
  "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."
    }
  }
}

get_company_beneficiaries

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

read-only

Argument	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.

Input schema (JSON)

{
  "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."
    }
  }
}

get_company_court_gazette

Get Court and Commercial Gazette (MSiG) notices for one company. Matched by KRS or NIP (creditor calls, dissolution, mergers, liquidation).

read-only

Argument	Type	Description
krs	string	KRS registry number.
nip	string	NIP (CEIDG / when KRS unknown).
name	string	Company name when KRS/NIP is unknown.

Input schema (JSON)

{
  "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."
    }
  }
}

get_company_debt_registry

Get KRZ insolvency / restructuring proceedings. KRS companies via company_krz; sole proprietors via CEIDG KRZ by NIP.

read-only

Argument	Type	Description
krs	string	KRS registry number.
nip	string	NIP (CEIDG / when KRS unknown).
name	string	Company name when KRS/NIP is unknown.

Input schema (JSON)

{
  "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."
    }
  }
}

get_company_energy_licenses

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.

read-only

Argument	Type	Description
krs	string	KRS registry number.
nip	string	NIP tax number (preferred for URE).
name	string	Company name when KRS/NIP is unknown.

Input schema (JSON)

{
  "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."
    }
  }
}

get_company_eu_funds

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.

read-only

Argument	Type	Description
krs	string	KRS registry number.
nip	string	NIP tax number (preferred for FE).
name	string	Company name when KRS/NIP is unknown.

Input schema (JSON)

{
  "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."
    }
  }
}

get_company_eu_tenders

Get TED EU-threshold public procurement — full awards as contractor and notices as buyer. Keyed by NIP. Identify company by name, KRS, or NIP.

read-only

Argument	Type	Description
krs	string	KRS registry number.
nip	string	NIP tax number (preferred for TED).
name	string	Company name when KRS/NIP is unknown.

Input schema (JSON)

{
  "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."
    }
  }
}

get_company_financial_supervision

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

read-only

Argument	Type	Description
krs	string	KRS registry number.
nip	string	NIP.
name	string	Company name when KRS/NIP is unknown.

Input schema (JSON)

{
  "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."
    }
  }
}

get_company_nfz_contracts

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.

read-only

Argument	Type	Description
krs	string	KRS registry number.
nip	string	NIP tax number (preferred for NFZ).
name	string	Company name when KRS/NIP is unknown.

Input schema (JSON)

{
  "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."
    }
  }
}

get_company_people

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

read-only

Argument	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.

Input schema (JSON)

{
  "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."
    }
  }
}

get_company_procurement

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.

read-only

Argument	Type	Description
krs	string	KRS registry number.
nip	string	NIP tax number (preferred for FTS).
name	string	Company name when KRS/NIP is unknown.

Input schema (JSON)

{
  "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."
    }
  }
}

get_company_procurement_disputes

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.

read-only

Argument	Type	Description
krs	string	KRS registry number.
nip	string	NIP tax number (preferred).
name	string	Company name when KRS/NIP is unknown.

Input schema (JSON)

{
  "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."
    }
  }
}

get_company_public_aid

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.

read-only

Argument	Type	Description
krs	string	KRS registry number.
nip	string	NIP tax number (preferred for SUDOP).
name	string	Company name when KRS/NIP is unknown.

Input schema (JSON)

{
  "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."
    }
  }
}

get_company_public_contracts

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.

read-only

Argument	Type	Description
krs	string	KRS registry number.
nip	string	NIP tax number (preferred for CRU).
name	string	Company name when KRS/NIP is unknown.

Input schema (JSON)

{
  "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."
    }
  }
}

get_company_public_tenders

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.

read-only

Argument	Type	Description
krs	string	KRS registry number.
nip	string	NIP tax number (preferred for BZP).
name	string	Company name when KRS/NIP is unknown.

Input schema (JSON)

{
  "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."
    }
  }
}

get_company_rankings

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). Use for questions like: where does company X rank in Poland / its industry / its region?

read-only

Argument	Type	Description
krs	string	KRS registry number (10 digits, zero-padded).
nip	string	NIP tax number (10 digits, dashes optional).
name	string	Company name when KRS/NIP is unknown.
scope_type	string	Optional. Filter to a single scope. Omit to get all scopes.

Input schema (JSON)

{
  "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)."
    },
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "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."
    }
  }
}

get_company_real_estate

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).

read-only

Argument	Type	Description
krs	string	KRS registry number.
nip	string	NIP.
name	string	Company name when KRS/NIP is unknown.

Input schema (JSON)

{
  "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."
    }
  }
}

get_company_sanctions

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

read-only

Argument	Type	Description
krs	string	KRS registry number.
nip	string	NIP tax number.
name	string	Company name when KRS/NIP is unknown.

Input schema (JSON)

{
  "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."
    }
  }
}

get_company_secured_liabilities

Secured liabilities from the latest financial-statement notes (period ending 2025+): mortgages (hipoteki), registered / financial pledges (zastawy), transfers of ownership, assignments — with creditor, amount, secured debt, asset and land-register (KW) numbers. Keyed by KRS; null when nothing is disclosed.

read-only

Argument	Type	Description
krs	string	KRS registry number.
nip	string	NIP.
name	string	Company name when KRS/NIP is unknown.

Input schema (JSON)

{
  "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."
    }
  }
}

get_company_stock_market

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

read-only

Argument	Type	Description
krs	string	KRS registry number.
nip	string	NIP tax number (preferred for GPW).
name	string	Company name when KRS/NIP is unknown.

Input schema (JSON)

{
  "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."
    }
  }
}

get_company_trademarks

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.

read-only

Argument	Type	Description
krs	string	KRS registry number.
nip	string	NIP tax number (preferred).
name	string	Company name when KRS/NIP is unknown.

Input schema (JSON)

{
  "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."
    }
  }
}

get_company_waste_registry

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.

read-only

Argument	Type	Description
krs	string	KRS registry number.
nip	string	NIP tax number (preferred for BDO).
name	string	Company name when KRS/NIP is unknown.

Input schema (JSON)

{
  "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."
    }
  }
}

get_financial_stats

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? Prefer median or winsor_mean over mean. cost_wages is PLN-only.

read-only

Argument	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.

Input schema (JSON)

{
  "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."
    }
  }
}

get_financials

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. Identify company by name, KRS, or NIP.

read-only

Argument	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).

Input schema (JSON)

{
  "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)."
    }
  }
}

get_plan

Get the user's active billing plan details — plan name, price, status, limits, prepaid credit balance, and billing period reset date.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

get_usage

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

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_api_keys

List all active REST API keys (cb_…) for the user's account. Returns id, name, key_prefix, created_at, last_used_at.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_mcp_keys

List all active MCP keys (mcpk_…) for the user's account. Returns id, name, key_prefix, created_at, last_used_at.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_plans

List Compabase billing plans and limits. No auth required. After sign-up, use upgrade_plan to get a Stripe Checkout URL.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_watchlist

List companies on the user's watchlist with company data (name, KRS, NIP, revenue, city). Supports pagination via limit/offset.

read-only

Argument	Type	Description
limit	integer	Max results (default: 20, max: 100).
offset	integer	Pagination offset (default: 0).

Input schema (JSON)

{
  "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)."
    }
  }
}

remove_from_watchlist

Remove a company from the user's watchlist. Identify by KRS or NIP.

destructive

Argument	Type	Description
krs	string	KRS registry number (10 digits, zero-padded).
nip	string	NIP tax number (10 digits).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "krs": {
      "type": "string",
      "description": "KRS registry number (10 digits, zero-padded)."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (10 digits)."
    }
  }
}

request_signup

Start Compabase account setup for an email. Sends a magic link. After the user clicks it, poll check_signup with the returned setup_id until status is ready — then you receive an MCP key automatically. Do not ask the user to generate a key in the portal. No auth required.

Argument	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).

Input schema (JSON)

{
  "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)."
    }
  }
}

search_companies

Search and filter Polish KRS companies (spółki). Compabase also holds the full CEIDG/JDG register; this tool does not browse JDG — those without a public contact email are hidden because of RODO. Default `fields=summary` returns a compact row (name, NIP, KRS, location, PKD, latest financials, email/phone/website) — small enough for MCP clients. `fields=contacts_only` is name/NIP/KRS/city/email/phone/website only. `fields=full` returns every company_search column plus contacts and may exceed client size limits. Use for rankings, sector filters, city/county/region browsing, name search, or NIP/KRS lookup. When a PKD is mostly JDG, a sparse result includes a `hint` (full CEIDG is in the database; listing is RODO-gated). Do not call export_companies just to get a handful of emails or phones.

read-only

Argument	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.

set_byok_key

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.…).

Argument	Type	Description
api_key*	string	Raw API key for the provider.
provider*	string	AI provider name.

Input schema (JSON)

{
  "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."
    }
  }
}

set_notification_preferences

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.).

Argument	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').

Input schema (JSON)

{
  "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')."
    }
  }
}

set_webhook_url

Configure, view, or remove webhook for watchlist event notifications. Events: watchlist.company_changed, watchlist.financials_updated, watchlist.company_removed_from_registry.

Argument	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.

Input schema (JSON)

{
  "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."
    }
  }
}

upgrade_plan

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 — open it in the browser for the user to pay. Do not send the user to the marketing pricing page.

Argument	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).

Input schema (JSON)

{
  "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)."
    }
  }
}

Input schema (JSON)

{
  "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."
    },
    "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)."
    },
    "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."
    },
    "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."
    },
    "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."
    }
  }
}

Input schema (JSON)

{
  "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."
    }
  }
}

Input schema (JSON)

{
  "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)."
    },
    "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)."
    },
    "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."
    },
    "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."
    },
    "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."
    }
  }
}