Compabase

Official48 tools

by ContentWriterco

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

io.github.ContentWriterco/compabase — Polish Companies MCP Server

This MCP server provides access to 3M+ Polish companies data, focused on KRS & CEIDG financials, ownership, and industry search. It is powered by Compabase and exposes an MCP interface for interactive use via Compabase’s documentation.

🛠️ Key Features

3M+ Polish companies coverage
KRS & CEIDG financials
Ownership data
Industry search

🚀 Use Cases

Query financial information associated with Polish entities
Retrieve ownership details for companies
Search companies by industry classification

⚡ Developer Benefits

Uses the Model Context Protocol (MCP)
Interactive documentation available via Compabase (Redoc)
Free tier is available

⚠️ Limitations

Server description provided focuses on KRS & CEIDG financials, ownership, and industry search; other data types are not specified

Topics

business-intelligenceceidgclaudecompany-datacursorkrsmcpmcp-servermodel-context-protocolpolandremote-mcpgemini-cli-extensionclaude-code-pluginclaude-plugin

Captured live from the server via tools/list.

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.

Parameters3

email	string	required	User email to create or sign in to a Compabase account.
locale	string	optional	Email language (default en).
client	string	optional	AI client, used to label the generated MCP key.

Raw schema

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "User email to create or sign in to a Compabase account."
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "pl",
        "de"
      ],
      "description": "Email language (default en)."
    },
    "client": {
      "type": "string",
      "enum": [
        "cursor",
        "claude",
        "vscode",
        "other"
      ],
      "description": "AI client, used to label the generated MCP key."
    }
  },
  "required": [
    "email"
  ]
}

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.

Parameters2

setup_id	string	required	setup_id from request_signup.
client	string	optional	Optional client hint for the key name.

Raw schema

{
  "type": "object",
  "properties": {
    "setup_id": {
      "type": "string",
      "description": "setup_id from request_signup."
    },
    "client": {
      "type": "string",
      "enum": [
        "cursor",
        "claude",
        "vscode",
        "other"
      ],
      "description": "Optional client hint for the key name."
    }
  },
  "required": [
    "setup_id"
  ]
}

list_plans

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

Parameters

No parameters.

Raw schema

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

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.

Parameters35

name	string	optional	Company name fragment (case-insensitive). Matches display name and full KRS name; legal-form suffixes like 'sp. z o.o.' are ignored.
krs	string	optional	KRS registry number (10 digits, zero-padded, e.g. '0000028860').
nip	string	optional	NIP tax number (10 digits, no dashes).
city	string	optional	City name — KRS records use uppercase, e.g. 'WARSZAWA', 'POZNAŃ'.
county	string	optional	County / powiat (lowercase).
region	string	optional	Voivodeship (lowercase), e.g. 'mazowieckie', 'wielkopolskie'.
postal_code	string	optional	Postal code prefix, e.g. '00-9' or '61-'.
pkd	string	optional	Primary PKD code prefix, e.g. '46.90.Z' or '46'.
all_pkd	string	optional	Match any PKD code in the company's activity list (not just primary).
legal_form	string	optional	Legal form fragment, e.g. 'spółka z o.o.' or 'akcyjna'.
currency	string	optional	Currency for monetary filters. Default: pln.
revenue_min	number	optional	Minimum total revenue.
revenue_max	number	optional	Maximum total revenue.
profit_min	number	optional	Minimum net profit.
profit_max	number	optional	Maximum net profit.
profit_operating_min	number	optional	Minimum operating profit (PLN). Negative allowed. Omit if unused.
profit_operating_max	number	optional	Maximum operating profit (PLN). Omit if unused.
total_assets_min	number	optional	Minimum total assets.
total_assets_max	number	optional	Maximum total assets.
ebitda_min	number	optional	Minimum EBITDA.
ebitda_max	number	optional	Maximum EBITDA.
capital_min	number	optional	Minimum share capital.
capital_max	number	optional	Maximum share capital.
estimated_value_min	number	optional	Minimum Ohlson estimated equity value in PLN.
estimated_value_max	number	optional	Maximum Ohlson estimated equity value in PLN.
registration_date_min	string	optional	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.
registration_date_max	string	optional	Latest KRS registration date, YYYY-MM-DD (inclusive).
is_active	boolean	optional	true = active only, false = closed only. Omit for all.
has_email	boolean	optional	true = only companies with email on record. Matching rows include contacts.email. Omit otherwise.
has_website	boolean	optional	true = only companies with website on record. Matching rows include contacts.website. Omit otherwise.
sort_by	string	optional	Sort field (default: revenue_total). registration_date + sort_dir=desc lists the newest registrations first.
sort_dir	string	optional	Sort direction (default: desc).
year	integer	optional	Filter to companies whose latest financial_period_to falls within this calendar year (e.g. 2024). Use only for sector/ranking browse — omit when looking up a company by name, KRS, or NIP.
limit	integer	optional	Max results (default: 10, max: 50).
fields	string	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "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."
    },
    "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)."
    },
    "city": {
      "type": "string",
      "description": "City name — KRS records use uppercase, e.g. 'WARSZAWA', 'POZNAŃ'."
    },
    "county": {
      "type": "string",
      "description": "County / powiat (lowercase)."
    },
    "region": {
      "type": "string",
      "description": "Voivodeship (lowercase), e.g. 'mazowieckie', 'wielkopolskie'."
    },
    "postal_code": {
      "type": "string",
      "description": "Postal code prefix, e.g. '00-9' or '61-'."
    },
    "pkd": {
      "type": "string",
      "description": "Primary PKD code prefix, e.g. '46.90.Z' or '46'."
    },
    "all_pkd": {
      "type": "string",
      "description": "Match any PKD code in the company's activity list (not just primary)."
    },
    "legal_form": {
      "type": "string",
      "description": "Legal form fragment, e.g. 'spółka z o.o.' or 'akcyjna'."
    },
    "currency": {
      "type": "string",
      "enum": [
        "pln",
        "usd",
        "eur"
      ],
      "description": "Currency for monetary filters. Default: pln."
    },
    "revenue_min": {
      "type": "number",
      "description": "Minimum total revenue."
    },
    "revenue_max": {
      "type": "number",
      "description": "Maximum total revenue."
    },
    "profit_min": {
      "type": "number",
      "description": "Minimum net profit."
    },
    "profit_max": {
      "type": "number",
      "description": "Maximum net profit."
    },
    "profit_operating_min": {
      "type": "number",
      "description": "Minimum operating profit (PLN). Negative allowed. Omit if unused."
    },
    "profit_operating_max": {
      "type": "number",
      "description": "Maximum operating profit (PLN). Omit if unused."
    },
    "total_assets_min": {
      "type": "number",
      "description": "Minimum total assets."
    },
    "total_assets_max": {
      "type": "number",
      "description": "Maximum total assets."
    },
    "ebitda_min": {
      "type": "number",
      "description": "Minimum EBITDA."
    },
    "ebitda_max": {
      "type": "number",
      "description": "Maximum EBITDA."
    },
    "capital_min": {
      "type": "number",
      "description": "Minimum share capital."
    },
    "capital_max": {
      "type": "number",
      "description": "Maximum share capital."
    },
    "estimated_value_min": {
      "type": "number",
      "description": "Minimum Ohlson estimated equity value in PLN."
    },
    "estimated_value_max": {
      "type": "number",
      "description": "Maximum Ohlson estimated equity value in PLN."
    },
    "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."
    },
    "registration_date_max": {
      "type": "string",
      "description": "Latest KRS registration date, YYYY-MM-DD (inclusive)."
    },
    "is_active": {
      "type": "boolean",
      "description": "true = active only, false = closed only. Omit for all."
    },
    "has_email": {
      "type": "boolean",
      "description": "true = only companies with email on record. Matching rows include contacts.email. Omit otherwise."
    },
    "has_website": {
      "type": "boolean",
      "description": "true = only companies with website on record. Matching rows include contacts.website. Omit otherwise."
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "revenue_total",
        "profit_net",
        "total_assets",
        "profit_operating",
        "ebitda",
        "capital_total",
        "estimated_value",
        "registration_date"
      ],
      "description": "Sort field (default: revenue_total). registration_date + sort_dir=desc lists the newest registrations first."
    },
    "sort_dir": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort direction (default: desc)."
    },
    "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",
      "minimum": 1,
      "maximum": 50,
      "description": "Max results (default: 10, max: 50)."
    },
    "fields": {
      "type": "string",
      "enum": [
        "contacts_only",
        "summary",
        "full"
      ],
      "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."
    }
  }
}

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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown (legal-form suffix optional)."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number (10 digits, zero-padded)."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (10 digits, dashes optional)."
    }
  }
}

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.

Parameters5

name	string	optional	Company name when KRS/NIP is unknown (legal-form suffix optional).
krs	string	optional	KRS registry number.
nip	string	optional	NIP tax number.
year_from	integer	optional	Earliest fiscal year to include (e.g. 2019).
year_to	integer	optional	Latest fiscal year to include (e.g. 2023).

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown (legal-form suffix optional)."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number."
    },
    "year_from": {
      "type": "integer",
      "description": "Earliest fiscal year to include (e.g. 2019)."
    },
    "year_to": {
      "type": "integer",
      "description": "Latest fiscal year to include (e.g. 2023)."
    }
  }
}

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.

Parameters4

name	string	optional	Company name when KRS/NIP is unknown (legal-form suffix optional).
krs	string	optional	KRS registry number.
nip	string	optional	NIP tax number.
relationship_type	string	optional	Filter: management, supervisory (rada nadzorcza), ownership, procuration. Omit for all.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown (legal-form suffix optional)."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number."
    },
    "relationship_type": {
      "type": "string",
      "description": "Filter: management, supervisory (rada nadzorcza), ownership, procuration. Omit for all."
    }
  }
}

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

Parameters29

name	string	optional	Company name fragment (case-insensitive). Matches display name and full KRS name; legal-form suffixes like 'sp. z o.o.' are ignored.
krs	string	optional	KRS registry number.
nip	string	optional	NIP tax number.
city	string	optional	City name — KRS uses uppercase.
county	string	optional	County / powiat (lowercase).
region	string	optional	Voivodeship (lowercase).
pkd	string	optional	Primary PKD code prefix, e.g. '46.90.Z' or '46'.
all_pkd	string	optional	Match any PKD code in the company's activity list (not just primary).
legal_form	string	optional	Legal form fragment.
revenue_min	number	optional	Minimum total revenue in PLN.
revenue_max	number	optional	Maximum total revenue in PLN.
profit_min	number	optional	Minimum net profit in PLN.
profit_max	number	optional	Maximum net profit in PLN.
profit_operating_min	number	optional	Minimum operating profit in PLN.
profit_operating_max	number	optional	Maximum operating profit in PLN.
total_assets_min	number	optional	Minimum total assets in PLN.
total_assets_max	number	optional	Maximum total assets in PLN.
ebitda_min	number	optional	Minimum EBITDA in PLN.
ebitda_max	number	optional	Maximum EBITDA in PLN.
capital_min	number	optional	Minimum share capital in PLN.
capital_max	number	optional	Maximum share capital in PLN.
estimated_value_min	number	optional	Minimum Ohlson estimated equity value in PLN.
estimated_value_max	number	optional	Maximum Ohlson estimated equity value in PLN.
registration_date_min	string	optional	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.
registration_date_max	string	optional	Latest KRS registration date, YYYY-MM-DD (inclusive).
is_active	boolean	optional	true = active only, false = closed only. Omit for all.
has_email	boolean	optional	true = only companies with email on record. Omit otherwise.
has_website	boolean	optional	true = only companies with website on record. Omit otherwise.
year	integer	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "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."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number."
    },
    "city": {
      "type": "string",
      "description": "City name — KRS uses uppercase."
    },
    "county": {
      "type": "string",
      "description": "County / powiat (lowercase)."
    },
    "region": {
      "type": "string",
      "description": "Voivodeship (lowercase)."
    },
    "pkd": {
      "type": "string",
      "description": "Primary PKD code prefix, e.g. '46.90.Z' or '46'."
    },
    "all_pkd": {
      "type": "string",
      "description": "Match any PKD code in the company's activity list (not just primary)."
    },
    "legal_form": {
      "type": "string",
      "description": "Legal form fragment."
    },
    "revenue_min": {
      "type": "number",
      "description": "Minimum total revenue in PLN."
    },
    "revenue_max": {
      "type": "number",
      "description": "Maximum total revenue in PLN."
    },
    "profit_min": {
      "type": "number",
      "description": "Minimum net profit in PLN."
    },
    "profit_max": {
      "type": "number",
      "description": "Maximum net profit in PLN."
    },
    "profit_operating_min": {
      "type": "number",
      "description": "Minimum operating profit in PLN."
    },
    "profit_operating_max": {
      "type": "number",
      "description": "Maximum operating profit in PLN."
    },
    "total_assets_min": {
      "type": "number",
      "description": "Minimum total assets in PLN."
    },
    "total_assets_max": {
      "type": "number",
      "description": "Maximum total assets in PLN."
    },
    "ebitda_min": {
      "type": "number",
      "description": "Minimum EBITDA in PLN."
    },
    "ebitda_max": {
      "type": "number",
      "description": "Maximum EBITDA in PLN."
    },
    "capital_min": {
      "type": "number",
      "description": "Minimum share capital in PLN."
    },
    "capital_max": {
      "type": "number",
      "description": "Maximum share capital in PLN."
    },
    "estimated_value_min": {
      "type": "number",
      "description": "Minimum Ohlson estimated equity value in PLN."
    },
    "estimated_value_max": {
      "type": "number",
      "description": "Maximum Ohlson estimated equity value in PLN."
    },
    "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."
    },
    "registration_date_max": {
      "type": "string",
      "description": "Latest KRS registration date, YYYY-MM-DD (inclusive)."
    },
    "is_active": {
      "type": "boolean",
      "description": "true = active only, false = closed only. Omit for all."
    },
    "has_email": {
      "type": "boolean",
      "description": "true = only companies with email on record. Omit otherwise."
    },
    "has_website": {
      "type": "boolean",
      "description": "true = only companies with website on record. Omit otherwise."
    },
    "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."
    }
  }
}

execute_sql

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

Parameters1

query

string

required

A read-only SQL SELECT or WITH…SELECT statement.

Raw schema

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

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?

Parameters4

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

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number (10 digits, zero-padded)."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (10 digits, dashes optional)."
    },
    "scope_type": {
      "type": "string",
      "enum": [
        "pkd_full",
        "pkd_division",
        "pkd_section",
        "region",
        "country"
      ],
      "description": "Optional. Filter to a single scope. Omit to get all scopes."
    }
  }
}

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.

Parameters4

dimension_type	string	optional	Granularity: 'country'=Poland; 'pkd_section'=A–U; 'pkd_division'=2-digit; 'pkd_full'=full code; 'region'=voivodeship; etc.
dimension_key	string	optional	Key for the dimension, e.g. 'PL', 'G', '46', '46.90.Z', 'mazowieckie'. Prefix match applied.
metric	string	optional	Financial metric. Omit to return all metrics.
currency	string	optional	Currency (default: PLN). cost_wages is PLN-only.

Raw schema

{
  "type": "object",
  "properties": {
    "dimension_type": {
      "type": "string",
      "enum": [
        "country",
        "pkd_section",
        "pkd_division",
        "pkd_class",
        "pkd_full",
        "region",
        "county",
        "city"
      ],
      "description": "Granularity: 'country'=Poland; 'pkd_section'=A–U; 'pkd_division'=2-digit; 'pkd_full'=full code; 'region'=voivodeship; etc."
    },
    "dimension_key": {
      "type": "string",
      "description": "Key for the dimension, e.g. 'PL', 'G', '46', '46.90.Z', 'mazowieckie'. Prefix match applied."
    },
    "metric": {
      "type": "string",
      "enum": [
        "revenue_total",
        "profit_net",
        "total_assets",
        "cost_wages"
      ],
      "description": "Financial metric. Omit to return all metrics."
    },
    "currency": {
      "type": "string",
      "enum": [
        "PLN",
        "EUR",
        "USD"
      ],
      "description": "Currency (default: PLN). cost_wages is PLN-only."
    }
  }
}

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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred for SUDOP)."
    }
  }
}

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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred for FE)."
    }
  }
}

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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred for FTS)."
    }
  }
}

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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred for BZP)."
    }
  }
}

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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred for URE)."
    }
  }
}

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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred for CRU)."
    }
  }
}

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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred for NFZ)."
    }
  }
}

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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred for BDO)."
    }
  }
}

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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred for GPW)."
    }
  }
}

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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (preferred for TED)."
    }
  }
}

get_company_court_gazette

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

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP (CEIDG / when KRS 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.

Parameters3

name	string	optional	Company name when KRS/NIP is unknown.
krs	string	optional	KRS registry number.
nip	string	optional	NIP tax number.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number."
    }
  }
}

get_company_debt_registry

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

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP (CEIDG / when KRS 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.

Parameters3

name	string	optional	Company name when KRS/NIP is unknown.
krs	string	optional	KRS registry number.
nip	string	optional	NIP.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP."
    }
  }
}

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.

Parameters3

name	string	optional	Company name when KRS/NIP is unknown.
krs	string	optional	KRS registry number.
nip	string	optional	NIP.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP."
    }
  }
}

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

Parameters3

name	string	optional	Company name when KRS/NIP is unknown.
krs	string	optional	KRS registry number.
nip	string	optional	NIP.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP."
    }
  }
}

get_company_beneficiaries

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

Parameters3

name	string	optional	Company name when KRS/NIP is unknown.
krs	string	optional	KRS registry number (required path for CRBR).
nip	string	optional	NIP — used to resolve KRS when needed.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number (required path for CRBR)."
    },
    "nip": {
      "type": "string",
      "description": "NIP — used to resolve KRS when needed."
    }
  }
}

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.

Parameters4

name	string	optional	Company name when KRS/NIP is unknown.
krs	string	optional	KRS registry number.
nip	string	optional	NIP — used to resolve KRS when needed.
doc_id	string	optional	Optional: specific rar_doc_id. Omit for the latest articles / statute.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name when KRS/NIP is unknown."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number."
    },
    "nip": {
      "type": "string",
      "description": "NIP — used to resolve KRS when needed."
    },
    "doc_id": {
      "type": "string",
      "description": "Optional: specific rar_doc_id. Omit for the latest articles / statute."
    }
  }
}

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.

Parameters

No parameters.

Raw schema

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

get_plan

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

Parameters

No parameters.

Raw schema

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

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Max results (default: 20, max: 100)."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Pagination offset (default: 0)."
    }
  }
}

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

Parameters2

krs	string	optional	KRS registry number (10 digits, zero-padded).
nip	string	optional	NIP tax number (10 digits). Used for CEIDG if no KRS match.

Raw schema

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

remove_from_watchlist

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

Parameters2

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

Raw schema

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

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.

Parameters

No parameters.

Raw schema

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

create_api_key

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

Parameters1

name

string

required

Human-readable label for the key (max 100 chars).

Raw schema

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

delete_api_key

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

Parameters1

key_id

string

required

UUID of the API key to revoke (from list_api_keys).

Raw schema

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

list_mcp_keys

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

Parameters

No parameters.

Raw schema

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

create_mcp_key

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

Parameters1

name

string

required

Human-readable label for the key (max 100 chars).

Raw schema

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

delete_mcp_key

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

Parameters1

key_id

string

required

UUID of the MCP key to revoke (from list_mcp_keys).

Raw schema

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

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.

Parameters15

name	string	optional	Company name fragment (case-insensitive).
krs	string	optional	KRS registry number (exports that one company).
nip	string	optional	NIP tax number (exports matching companies).
city	string	optional	City name.
county	string	optional	County / powiat (lowercase). Same filter as search_companies / count_companies.
region	string	optional	Voivodeship (e.g. mazowieckie).
pkd	string	optional	Primary PKD code prefix, e.g. '80.10', '80.10.Z', or '80' (same prefix matching as search_companies).
all_pkd	string	optional	Match any PKD code in the company's activity list (not just primary).
revenue_min	number	optional	Minimum total revenue.
revenue_max	number	optional	Maximum total revenue.
is_active	boolean	optional	true = active companies only.
format	string	optional	Export format (default: csv). Column set follows `fields` (contacts_only by default).
locale	string	optional	Column/label language (default: en).
limit	integer	optional	Max rows to export (default: 50, max: 500).
fields	string	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name fragment (case-insensitive)."
    },
    "krs": {
      "type": "string",
      "description": "KRS registry number (exports that one company)."
    },
    "nip": {
      "type": "string",
      "description": "NIP tax number (exports matching companies)."
    },
    "city": {
      "type": "string",
      "description": "City name."
    },
    "county": {
      "type": "string",
      "description": "County / powiat (lowercase). Same filter as search_companies / count_companies."
    },
    "region": {
      "type": "string",
      "description": "Voivodeship (e.g. mazowieckie)."
    },
    "pkd": {
      "type": "string",
      "description": "Primary PKD code prefix, e.g. '80.10', '80.10.Z', or '80' (same prefix matching as search_companies)."
    },
    "all_pkd": {
      "type": "string",
      "description": "Match any PKD code in the company's activity list (not just primary)."
    },
    "revenue_min": {
      "type": "number",
      "description": "Minimum total revenue."
    },
    "revenue_max": {
      "type": "number",
      "description": "Maximum total revenue."
    },
    "is_active": {
      "type": "boolean",
      "description": "true = active companies only."
    },
    "format": {
      "type": "string",
      "enum": [
        "csv",
        "xlsx",
        "json"
      ],
      "description": "Export format (default: csv). Column set follows `fields` (contacts_only by default)."
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "pl",
        "de"
      ],
      "description": "Column/label language (default: en)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "description": "Max rows to export (default: 50, max: 500)."
    },
    "fields": {
      "type": "string",
      "enum": [
        "contacts_only",
        "summary",
        "full"
      ],
      "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."
    }
  }
}

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.

Parameters3

plan_id	string	optional	Target plan ID. Required to create a Stripe Checkout URL.
locale	string	optional	UI locale for the success/cancel return URLs (default en).
currency	string	optional	Checkout currency. Defaults from locale (pl → PLN, otherwise USD).

Raw schema

{
  "type": "object",
  "properties": {
    "plan_id": {
      "type": "string",
      "enum": [
        "pro",
        "scale"
      ],
      "description": "Target plan ID. Required to create a Stripe Checkout URL."
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "pl",
        "de"
      ],
      "description": "UI locale for the success/cancel return URLs (default en)."
    },
    "currency": {
      "type": "string",
      "enum": [
        "PLN",
        "USD",
        "EUR"
      ],
      "description": "Checkout currency. Defaults from locale (pl → PLN, otherwise USD)."
    }
  }
}

set_webhook_url

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

Parameters3

action	string	required	Action: 'get' to view config, 'set' to configure, 'delete' to remove.
url	string	optional	HTTPS webhook endpoint URL (required for action=set).
events	array	optional	Event types to subscribe to. Defaults to all available events.

Raw schema

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "get",
        "set",
        "delete"
      ],
      "description": "Action: 'get' to view config, 'set' to configure, 'delete' to remove."
    },
    "url": {
      "type": "string",
      "description": "HTTPS webhook endpoint URL (required for action=set)."
    },
    "events": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Event types to subscribe to. Defaults to all available events."
    }
  },
  "required": [
    "action"
  ]
}

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.

Parameters

No parameters.

Raw schema

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

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

Parameters2

provider	string	required	AI provider name.
api_key	string	required	Raw API key for the provider.

Raw schema

{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "enum": [
        "openai",
        "claude",
        "gemini"
      ],
      "description": "AI provider name."
    },
    "api_key": {
      "type": "string",
      "description": "Raw API key for the provider."
    }
  },
  "required": [
    "provider",
    "api_key"
  ]
}

delete_byok_key

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

Parameters1

provider

string

required

Provider to remove key for.

Raw schema

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

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.

Parameters1

identifiers

array

required

Array of KRS numbers (10 digits) or NIP numbers (10 digits).

Raw schema

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

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

Parameters3

action	string	required	'get' returns current preferences, 'set' updates them.
email_notifications	boolean	optional	Enable/disable email notifications for watchlist changes (required for 'set').
notification_email	string	optional	Override email address for notifications. Omit to use account email.

Raw schema

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "get",
        "set"
      ],
      "description": "'get' returns current preferences, 'set' updates them."
    },
    "email_notifications": {
      "type": "boolean",
      "description": "Enable/disable email notifications for watchlist changes (required for 'set')."
    },
    "notification_email": {
      "type": "string",
      "description": "Override email address for notifications. Omit to use account email."
    }
  },
  "required": [
    "action"
  ]
}

README.md8 KBView on GitHub

🇵🇱 Polish Companies MCP Server – Compabase

Compabase MCP is a Model Context Protocol server that gives AI assistants – Claude, Cursor, Windsurf, VS Code, and any MCP-compatible client – direct access to 3 million+ Polish companies from the KRS (National Court Register) and CEIDG registries, plus financials, people, rankings, and public-register enrichments (SUDOP, BZP, TED, URE, BDO, GPW, KRZ, CRBR, MSiG, EU funds).

Ask in plain language. The model maps prompts to structured tools over Streamable HTTP (JSON-RPC 2.0).

Quick Start

You can connect without a key. The agent signs you up and writes mcpk_… into the client config after email confirmation.

Cursor / Windsurf / VS Code – .cursor/mcp.json (or the equivalent MCP JSON):

json

{
  "mcpServers": {
    "compabase": {
      "url": "https://compabase.com/api/mcp"
    }
  }
}

Then ask the agent to sign you up (request_signup with your email). After you click the magic link, poll check_signup until status: ready. Restart the client if it does not hot-reload MCP config.

Claude Desktop – claude_desktop_config.json (after you have a key):

json

{
  "mcpServers": {
    "compabase": {
      "url": "https://compabase.com/api/mcp",
      "headers": {
        "Authorization": "Bearer mcpk_YOUR_KEY_HERE"
      }
    }
  }
}

Claude.ai (Web / Mobile Connectors):

Go to Settings → Connectors → Add Custom Connector
URL: https://compabase.com/mcp?apiKey=mcpk_YOUR_KEY_HERE
Authentication: None (Detected) (key is passed in URL)

Keys can also be created in Integrations → MCP. MCP keys (mcpk_…) are separate from REST API keys (cb_…).

Field	Value
Endpoint	`POST https://compabase.com/api/mcp` or `https://compabase.com/mcp`
Authentication	`Authorization: Bearer mcpk_…`, `X-API-Key: mcpk_…`, or `?apiKey=mcpk_…`
Protocol	MCP Streamable HTTP (JSON-RPC 2.0)
MCP version	`2024-11-05`
Server	`compabase` 1.6.2

Example prompts

Find active IT companies in Warsaw with revenue over 5 million PLN.
What is the latest revenue and net profit of Allegro?
List board members of the company with KRS 0000028860.
How many active companies in mazowieckie have primary PKD starting with 62?
What is the median revenue in PKD section J?
Is Orlen listed on GPW? What is the ticker and P/E?

Available tools

Live traffic is always POST https://compabase.com/api/mcp with method: tools/call and params.name set to the tool name. Identify a company with name, krs, or nip when a tool accepts them. Monetary filters default to PLN.

Full schemas: mcp.yaml · interactive docs.

Onboarding (no key)

Tool	Purpose
`request_signup`	Send a magic-link email; returns `setup_id`
`check_signup`	Poll until email confirmed; returns `mcp_key` once
`list_plans`	Billing plans and limits; then `upgrade_plan`

Company data

Tool	Purpose
`search_companies`	Filter KRS companies (name, PKD, city, voivodeship, financials, status, contacts). Up to 50 rows. Does not browse JDG.
`count_companies`	Count matching KRS companies (same filters, no sort/limit)
`get_company`	One profile + headline financials for the latest filed period
`get_financials`	Full P&L / balance-sheet metrics per fiscal period
`get_company_people`	Board, shareholders, proxies, other roles
`get_company_rankings`	Revenue rank in PKD / region / Poland
`get_financial_stats`	Sector/region/PKD aggregates (median, p25–p90, n, …)
`execute_sql`	Read-only `SELECT` / `WITH … SELECT` for custom joins

Register enrichments

Tool	Source
`get_company_sudop`	SUDOP public aid / de minimis (NIP)
`get_company_bzp`	BZP procurement awards and buyer notices (NIP)
`get_company_ted`	TED EU-threshold tenders (NIP)
`get_company_ure`	URE energy concessions (NIP)
`get_company_bdo`	BDO waste / packaging register (NIP)
`get_company_gpw`	GPW / NewConnect / GlobalConnect listing + delayed quotes
`get_company_fe`	European Funds (MFiPR lists, cohesion)
`get_company_fts`	European Commission FTS grants (Horizon, LIFE, …)
`get_company_msig`	Court and Commercial Gazette (MSiG)
`get_company_krz`	KRZ insolvency / restructuring (KRS or CEIDG NIP)
`get_company_beneficiaries`	CRBR beneficial owners (KRS). Names only – never PESEL

Account (skip `mcp_queries`)

Tool	Purpose
`get_usage`	Period usage: `mcp_queries`, `api_requests`, `export_companies`, `ask_ai_credits`, `watchlist_companies`
`get_plan`	Active plan, limits, prepaid credit, reset date
`list_watchlist` / `add_to_watchlist` / `remove_from_watchlist` / `batch_add_to_watchlist`	Watchlist (KRS or NIP, including CEIDG)
`list_api_keys` / `create_api_key` / `delete_api_key`	REST keys (`cb_…`)
`list_mcp_keys` / `create_mcp_key` / `delete_mcp_key`	MCP keys (`mcpk_…`)
`export_companies`	Bulk CSV / XLSX / JSON (up to 500 rows). Uses the export meter, not `mcp_queries`
`upgrade_plan`	Stripe Checkout URL (`pro` / `scale`)
`set_webhook_url`	Watchlist change webhooks
`get_byok_keys` / `set_byok_key` / `delete_byok_key`	BYOK (OpenAI / Claude / Gemini), Pro+
`set_notification_preferences`	Email alerts for watchlist changes

Quota

Data tools (search, financials, enrichments, SQL): each successful tools/call consumes one mcp_queries unit.

Account tools skip mcp_queries. export_companies consumes export_companies instead.

initialize, tools/list, and ping do not consume quota. Limits reset with the billing period.

Plan	MCP queries / month	API requests	Exports
Free	10	100	50
Pro	50	5 000	1 000
Scale	1 000	100 000	20 000
Enterprise	Custom	Custom	Custom

See compabase.com/pricing.

Protocol

Property	Value
Endpoint	`POST https://compabase.com/api/mcp`
Transport	Streamable HTTP
Protocol version	`2024-11-05`
Capabilities	`tools`
Server name	`compabase`
Server version	`1.6.2`

Method	Description
`initialize`	Handshake
`tools/list`	Tools and schemas
`tools/call`	Execute a tool
`ping`	Keep-alive
`notifications/initialized`	Client ready

Compabase REST API – OpenAPI 3.1 (v1.yaml)
Interactive API docs
Interactive MCP docs
compabase.com

License

MIT

Gemini CLI

bash

gemini extensions install https://github.com/ContentWriterco/Compabase-MCP

On first use Gemini CLI opens the Compabase sign-in page (OAuth). Run /mcp auth compabase if it does not.

Claude Code plugin

This repository is also a Claude Code plugin (MCP server + skill):

code

/plugin marketplace add ContentWriterco/Compabase-MCP
/plugin install compabase@compabase-plugins

Setup guides

Step-by-step setup guides for Claude, ChatGPT, Gemini, Grok, Le Chat, Perplexity, Cursor, VS Code and Claude Code: https://compabase.com/docs/mcp/connect/

Install

Tools (48)

request_signupcheck_signuplist_planssearch_companiesget_companyget_financialsget_company_peoplecount_companies

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://compabase.com/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "compabase": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://compabase.com/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.ContentWriterco/compabase — Polish Companies MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

request_signup

check_signup

list_plans

search_companies

get_company

get_financials

get_company_people

count_companies

execute_sql

get_company_rankings

get_financial_stats

get_company_public_aid

get_company_eu_funds

get_company_procurement

get_company_public_tenders

get_company_energy_licenses

get_company_public_contracts

get_company_nfz_contracts

get_company_waste_registry

get_company_stock_market

get_company_eu_tenders

get_company_court_gazette

get_company_sanctions

get_company_debt_registry

get_company_financial_supervision

get_company_secured_liabilities

get_company_real_estate

get_company_beneficiaries

get_company_articles

get_usage

get_plan

list_watchlist

add_to_watchlist

remove_from_watchlist

list_api_keys

create_api_key

delete_api_key

list_mcp_keys

create_mcp_key

delete_mcp_key

export_companies

upgrade_plan

set_webhook_url

get_byok_keys

set_byok_key

delete_byok_key

add_watchlist_batch

set_notification_preferences

🇵🇱 Polish Companies MCP Server – Compabase

Quick Start

Example prompts

Available tools

Onboarding (no key)

Company data

Register enrichments

Account (skip mcp_queries)

Quota

Protocol

Related

License

Gemini CLI

Claude Code plugin

Setup guides

Install

Remote endpoint

Related servers

Account (skip `mcp_queries`)