Compabase
REMOTE · COMPABASE.COM · SCANNED SEP 24
MCP server for 3M+ Polish companies — KRS & CEIDG financials, ownership, and industry search.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security57
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation not fully verified: this server exposes a tool marked destructive (remove_from_watchlist) and its handshake is open, but we could not confirm whether a tool call is gated, so we do not assert it is callable unauthenticated. View diagnostics → Unverified
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability76
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 5686 tokens (~135/item across 42 items; 42 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management90
- Stability observed for 27 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety95
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 4 of 5 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "execute_sql" implies "execute" and declares readOnlyHint instead, contradicting what its own name says it does. See how to fix → Partial
- An AI judge read all 43 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
How do I install the Compabase MCP server?
Compabase is a hosted endpoint at https://compabase.com/api/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · compabase.com
claude mcp add --transport http contentwriterco-compabase 'https://compabase.com/api/mcp'
{
"mcpServers": {
"contentwriterco-compabase": {
"url": "https://compabase.com/api/mcp"
}
}
} {
"servers": {
"contentwriterco-compabase": {
"type": "http",
"url": "https://compabase.com/api/mcp"
}
}
} [mcp_servers.contentwriterco-compabase] url = "https://compabase.com/api/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"contentwriterco-compabase": {
"type": "remote",
"url": "https://compabase.com/api/mcp",
"enabled": true
}
}
} openclaw mcp add contentwriterco-compabase --url 'https://compabase.com/api/mcp' --transport streamable-http
mcp_servers:
contentwriterco-compabase:
url: "https://compabase.com/api/mcp" {
"McpServers": {
"contentwriterco-compabase": {
"Transport": "http",
"Url": "https://compabase.com/api/mcp"
}
}
} assistant mcp add contentwriterco-compabase -t streamable-http -u 'https://compabase.com/api/mcp'
{
"mcpServers": {
"contentwriterco-compabase": {
"type": "http",
"url": "https://compabase.com/api/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 24 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.
- 22 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.
- 20 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 73 to 77. That category is still filling its 30-day observation window: 22 days of observed history at the previous scan, 23 at this one. The score rises as the window fills, whether or not the server changes.
- 17 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 63 to 67. That category is still filling its 30-day observation window: 19 days of observed history at the previous scan, 20 at this one. The score rises as the window fills, whether or not the server changes.
- 16 Sept 26 0
- Tool “get_company” rewrote its description, which is the text the model reads security
- Tool “get_company_stock_market” rewrote its description, which is the text the model reads security
- “export_companies” added an optional parameter “all_pkd” cosmetic
- “count_companies” reworded the description of “estimated_value_max” cosmetic
- “count_companies” reworded the description of “estimated_value_min” cosmetic
- “export_companies” reworded the description of “pkd” cosmetic
- “search_companies” reworded the description of “estimated_value_max” cosmetic
- “search_companies” reworded the description of “estimated_value_min” cosmetic
- 15 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 57 to 60. That category is still filling its 30-day observation window: 17 days of observed history at the previous scan, 18 at this one. The score rises as the window fills, whether or not the server changes.
- 13 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 50 to 53. That category is still filling its 30-day observation window: 15 days of observed history at the previous scan, 16 at this one. The score rises as the window fills, whether or not the server changes.
- 11 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 43 to 47. That category is still filling its 30-day observation window: 13 days of observed history at the previous scan, 14 at this one. The score rises as the window fills, whether or not the server changes.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 24 Sept 2026 · Probed https://compabase.com/api/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=compabase.com | CN=WE1,O=Google Trust Services,C=US | 10 Sept 2026 | 9 Dec 2026 | ECDSA 256 | ECDSA-SHA256 | 6c4c56ba0f027d00137eb387c2b0e95c |
| SANs: compabase.com, *.compabase.com | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of compabase.com. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| com. | present | 19718 | 13 | Verified |
| compabase.com. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://compabase.com/api/mcp | Verified | 200 | |
| http (plaintext) | http://compabase.com/api/mcp | HTTPS enforced | 308 | https://compabase.com/api/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
add_to_watchlist Add Company to Watchlist ~96
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).
| Name | Type | Req | Description |
|---|---|---|---|
| krs | string | – | KRS registry number (10 digits, zero-padded). |
| nip | string | – | NIP tax number (10 digits). Used for CEIDG if no KRS match. |
| Name | Type | Req | Description |
|---|---|---|---|
| company | object | – | Watchlist entry created. |
| status | string | yes | Operation status (added or already_watched). |
No examples provided.
add_watchlist_batch Batch Add Companies to Watchlist ~70
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.
| Name | Type | Req | Description |
|---|---|---|---|
| identifiers | array | yes | Array of KRS numbers (10 digits) or NIP numbers (10 digits). |
| Name | Type | Req | Description |
|---|---|---|---|
| added | number | yes | Number of companies successfully added. |
| total | number | yes | Total requested companies. |
No examples provided.
check_signup Check Compabase Signup Status ~85
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.
| Name | Type | Req | Description |
|---|---|---|---|
| client | string | – | Optional client hint for the key name. |
| setup_id | string | yes | setup_id from request_signup. |
| Name | Type | Req | Description |
|---|---|---|---|
| cursor_mcp_json | object | – | Suggested MCP configuration snippet for Cursor / Claude Desktop. |
| string | – | User email address if confirmed. | |
| key_name | string | – | Display name of the generated key. |
| key_prefix | string | – | First 9 characters of the key. |
| mcp_key | string | – | Generated Compabase MCP key (mcpk_...). |
| message | string | yes | Status message or next step guidance. |
| poll_after_seconds | number | – | Seconds to wait before polling again if pending. |
| status | string | yes | Setup session status: pending, ready, expired, already_delivered, or not_found. |
No examples provided.
count_companies Count Polish Companies ~537
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`.
| Name | Type | Req | Description |
|---|---|---|---|
| all_pkd | string | – | Match any PKD code in the company's activity list (not just primary). |
| capital_max | number | – | Maximum share capital in PLN. |
| capital_min | number | – | Minimum share capital in PLN. |
| city | string | – | City name — KRS uses uppercase. |
| county | string | – | County / powiat (lowercase). |
| ebitda_max | number | – | Maximum EBITDA in PLN. |
| ebitda_min | number | – | Minimum EBITDA in PLN. |
| estimated_value_max | number | – | Maximum Ohlson estimated equity value in PLN. |
| estimated_value_min | number | – | Minimum Ohlson estimated equity value in PLN. |
| has_email | boolean | – | true = only companies with email on record. Omit otherwise. |
| has_website | boolean | – | true = only companies with website on record. Omit otherwise. |
| is_active | boolean | – | true = active only, false = closed only. Omit for all. |
| krs | string | – | KRS registry number. |
| legal_form | string | – | Legal form fragment. |
| name | string | – | Company name fragment (case-insensitive). Matches display name and full KRS name; legal-form suffixes like 'sp. z o.o.' are ignored. |
| nip | string | – | NIP tax number. |
| pkd | string | – | Primary PKD code prefix, e.g. '46.90.Z' or '46'. |
| profit_max | number | – | Maximum net profit in PLN. |
| profit_min | number | – | Minimum net profit in PLN. |
| profit_operating_max | number | – | Maximum operating profit in PLN. |
| profit_operating_min | number | – | Minimum operating profit in PLN. |
| region | string | – | Voivodeship (lowercase). |
| revenue_max | number | – | Maximum total revenue in PLN. |
| revenue_min | number | – | Minimum total revenue in PLN. |
| total_assets_max | number | – | Maximum total assets in PLN. |
| total_assets_min | number | – | Minimum total assets in PLN. |
| 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| count | number | yes | Total count of KRS companies matching filters. |
| hint | string | – | Optional guidance regarding filters or CEIDG. |
No examples provided.
create_api_key Create REST API Key ~49
Create a new REST API key (cb_…). The raw key is returned once and cannot be retrieved later.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | Human-readable label for the key (max 100 chars). |
| Name | Type | Req | Description |
|---|---|---|---|
| api_key | string | yes | Newly generated REST API key. |
| name | string | – | Label assigned to key. |
No examples provided.
create_mcp_key Create MCP Key ~51
Create a new MCP key (mcpk_…). The raw key is returned once and cannot be retrieved later.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | Human-readable label for the key (max 100 chars). |
| Name | Type | Req | Description |
|---|---|---|---|
| mcp_key | string | yes | Newly generated MCP key (mcpk_...). |
| name | string | – | Key name. |
No examples provided.
delete_api_key Revoke REST API Key ~49
Revoke (deactivate) a REST API key by its ID. The key stops working immediately.
| Name | Type | Req | Description |
|---|---|---|---|
| key_id | string | yes | UUID of the API key to revoke (from list_api_keys). |
| Name | Type | Req | Description |
|---|---|---|---|
| status | string | yes | Result status of revocation. |
No examples provided.
delete_byok_key Remove Bring-Your-Own-Key Provider ~43
Remove a configured BYOK provider key. After removal, the platform falls back to its own model access.
| Name | Type | Req | Description |
|---|---|---|---|
| provider | string | yes | Provider to remove key for. |
| Name | Type | Req | Description |
|---|---|---|---|
| status | string | yes | Removal status. |
No examples provided.
delete_mcp_key Revoke MCP Key ~58
Revoke (deactivate) an MCP key by its ID. Cannot revoke the key currently in use. The key stops working immediately.
| Name | Type | Req | Description |
|---|---|---|---|
| key_id | string | yes | UUID of the MCP key to revoke (from list_mcp_keys). |
| Name | Type | Req | Description |
|---|---|---|---|
| status | string | yes | Result status of revocation. |
No examples provided.
execute_sql Execute Read-Only SQL ~54
Execute a read-only SQL SELECT query against the Compabase database. Use when dedicated tools are not enough (aggregations, joins, custom analysis).
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | yes | A read-only SQL SELECT or WITH…SELECT statement. |
| Name | Type | Req | Description |
|---|---|---|---|
| rowCount | number | – | Number of rows returned. |
| rows | array | yes | Result rows from the read-only query. |
No examples provided.
export_companies Export Companies to CSV ~464
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.
| Name | Type | Req | Description |
|---|---|---|---|
| all_pkd | string | – | Match any PKD code in the company's activity list (not just primary). |
| city | string | – | City name. |
| 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… |
| format | string | – | Export format (default: csv). Column set follows `fields` (contacts_only by default). |
| is_active | boolean | – | true = active companies only. |
| krs | string | – | KRS registry number (exports that one company). |
| limit | integer | – | Max rows to export (default: 50, max: 500). |
| locale | string | – | Column/label language (default: en). |
| name | string | – | Company name fragment (case-insensitive). |
| 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). |
| region | string | – | Voivodeship (e.g. mazowieckie). |
| revenue_max | number | – | Maximum total revenue. |
| revenue_min | number | – | Minimum total revenue. |
| Name | Type | Req | Description |
|---|---|---|---|
| count | number | – | Number of records exported. |
| download_url | string | yes | Direct download URL for generated CSV file. |
No examples provided.
get_byok_keys Get Bring-Your-Own-Key Providers ~56
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.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| providers | array | – | Configured AI provider keys. |
No examples provided.
get_company Get Company Profile ~194
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. 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.
| Name | Type | Req | Description |
|---|---|---|---|
| krs | string | – | KRS registry number (10 digits, zero-padded). |
| name | string | – | Company name when KRS/NIP is unknown (legal-form suffix optional). |
| nip | string | – | NIP tax number (10 digits, dashes optional). |
| Name | Type | Req | Description |
|---|---|---|---|
| company | object | – | Detailed company profile. |
| contacts | object | – | Public contact details (email, phone, website) if available. |
| financials | object | – | Headline financials for latest filed period. |
No examples provided.
get_company_articles Get News Mentions ~168
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.
| Name | Type | Req | Description |
|---|---|---|---|
| doc_id | string | – | Optional: specific rar_doc_id. Omit for the latest articles / statute. |
| krs | string | – | KRS registry number. |
| name | string | – | Company name when KRS/NIP is unknown. |
| nip | string | – | NIP — used to resolve KRS when needed. |
| Name | Type | Req | Description |
|---|---|---|---|
| articles | array | – | Media mentions, press articles, and business news mentioning company. |
No examples provided.
get_company_beneficiaries Get Ultimate Beneficial Owners (CRBR) ~106
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.
| Name | Type | Req | Description |
|---|---|---|---|
| krs | string | – | KRS registry number (required path for CRBR). |
| name | string | – | Company name when KRS/NIP is unknown. |
| nip | string | – | NIP — used to resolve KRS when needed. |
| Name | Type | Req | Description |
|---|---|---|---|
| beneficiaries | array | – | Registered Ultimate Beneficial Owners (UBO) from CRBR. |
No examples provided.
get_company_court_gazette Get Court and Commercial Gazette (MSiG) ~93
Get Court and Commercial Gazette (MSiG) notices for one company. Matched by KRS or NIP (creditor calls, dissolution, mergers, liquidation).
| Name | Type | Req | Description |
|---|---|---|---|
| krs | string | – | KRS registry number. |
| name | string | – | Company name when KRS/NIP is unknown. |
| nip | string | – | NIP (CEIDG / when KRS unknown). |
| Name | Type | Req | Description |
|---|---|---|---|
| entries | array | – | Official announcements published in Monitor Sądowy i Gospodarczy. |
No examples provided.
get_company_debt_registry Get National Debt Register (KRZ) ~88
Get KRZ insolvency / restructuring proceedings. KRS companies via company_krz; sole proprietors via CEIDG KRZ by NIP.
| Name | Type | Req | Description |
|---|---|---|---|
| krs | string | – | KRS registry number. |
| name | string | – | Company name when KRS/NIP is unknown. |
| nip | string | – | NIP (CEIDG / when KRS unknown). |
| Name | Type | Req | Description |
|---|---|---|---|
| proceedings | array | – | Insolvency, restructuring, and bankruptcy proceedings on record in KRZ. |
No examples provided.
get_company_energy_licenses Get Energy Regulatory Office Licenses (URE) ~102
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.
| Name | Type | Req | Description |
|---|---|---|---|
| krs | string | – | KRS registry number. |
| name | string | – | Company name when KRS/NIP is unknown. |
| nip | string | – | NIP tax number (preferred for URE). |
| Name | Type | Req | Description |
|---|---|---|---|
| concessions | array | – | Energy regulator concessions and electricity/gas trade licenses. |
No examples provided.
get_company_eu_funds Get EU Funds Projects ~128
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.
| Name | Type | Req | Description |
|---|---|---|---|
| krs | string | – | KRS registry number. |
| name | string | – | Company name when KRS/NIP is unknown. |
| nip | string | – | NIP tax number (preferred for FE). |
| Name | Type | Req | Description |
|---|---|---|---|
| projects | array | – | EU-funded projects and subsidies co-financed by European funds. |
No examples provided.
get_company_eu_tenders Get EU Tenders Daily (TED) ~90
Get TED EU-threshold public procurement — full awards as contractor and notices as buyer. Keyed by NIP. Identify company by name, KRS, or NIP.
| Name | Type | Req | Description |
|---|---|---|---|
| krs | string | – | KRS registry number. |
| name | string | – | Company name when KRS/NIP is unknown. |
| nip | string | – | NIP tax number (preferred for TED). |
| Name | Type | Req | Description |
|---|---|---|---|
| tenders | array | – | High-value public procurement notices published on Tenders Electronic Daily. |
No examples provided.
get_company_people Get Company People & Management ~130
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.
| Name | Type | Req | Description |
|---|---|---|---|
| krs | string | – | KRS registry number. |
| name | string | – | Company name when KRS/NIP is unknown (legal-form suffix optional). |
| nip | string | – | NIP tax number. |
| relationship_type | string | – | Filter: management, supervisory (rada nadzorcza), ownership, procuration. Omit for all. |
| Name | Type | Req | Description |
|---|---|---|---|
| krs | string | – | KRS number of the company. |
| people | array | – | List of associated persons (board, supervisory, shareholders, proxies). |
No examples provided.
get_company_procurement Get Public Procurement Contracts (FTS) ~110
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.
| Name | Type | Req | Description |
|---|---|---|---|
| krs | string | – | KRS registry number. |
| name | string | – | Company name when KRS/NIP is unknown. |
| nip | string | – | NIP tax number (preferred for FTS). |
| Name | Type | Req | Description |
|---|---|---|---|
| contracts | array | – | Public procurement tenders won by the company. |
No examples provided.
get_company_public_aid Get Public Aid (SUDOP) ~99
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.
| Name | Type | Req | Description |
|---|---|---|---|
| krs | string | – | KRS registry number. |
| name | string | – | Company name when KRS/NIP is unknown. |
| nip | string | – | NIP tax number (preferred for SUDOP). |
| Name | Type | Req | Description |
|---|---|---|---|
| aid_records | array | – | Records of de minimis and state public aid granted to company. |
No examples provided.
get_company_public_tenders Get Public Procurement Bulletin (BZP) ~95
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.
| Name | Type | Req | Description |
|---|---|---|---|
| krs | string | – | KRS registry number. |
| name | string | – | Company name when KRS/NIP is unknown. |
| nip | string | – | NIP tax number (preferred for BZP). |
| Name | Type | Req | Description |
|---|---|---|---|
| notices | array | – | Public procurement bulletin tender announcements and contract awards. |
No examples provided.
get_company_rankings Get Company Sector Rankings ~160
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?
| Name | Type | Req | Description |
|---|---|---|---|
| krs | string | – | KRS registry number (10 digits, zero-padded). |
| name | string | – | Company name when KRS/NIP is unknown. |
| nip | string | – | NIP tax number (10 digits, dashes optional). |
| scope_type | string | – | Optional. Filter to a single scope. Omit to get all scopes. |
| Name | Type | Req | Description |
|---|---|---|---|
| rankings | array | – | Rankings by revenue, profit, and growth within sector and region. |
No examples provided.
get_company_stock_market Get Warsaw Stock Exchange Data (GPW) ~163
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.
| Name | Type | Req | Description |
|---|---|---|---|
| krs | string | – | KRS registry number. |
| name | string | – | Company name when KRS/NIP is unknown. |
| nip | string | – | NIP tax number (preferred for GPW). |
| Name | Type | Req | Description |
|---|---|---|---|
| market | string | – | GPW Main Market or NewConnect. |
| profile | object | – | Listed company stock and market data. |
| ticker | string | – | Stock ticker symbol. |
No examples provided.
get_company_waste_registry Get Waste Management Registry (BDO) ~102
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.
| Name | Type | Req | Description |
|---|---|---|---|
| krs | string | – | KRS registry number. |
| name | string | – | Company name when KRS/NIP is unknown. |
| nip | string | – | NIP tax number (preferred for BDO). |
| Name | Type | Req | Description |
|---|---|---|---|
| entries | array | – | BDO waste management registry registration and activity scopes. |
No examples provided.
get_financial_stats Get Sector Financial Statistics ~220
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
| metric | string | – | Financial metric. Omit to return all metrics. |
| Name | Type | Req | Description |
|---|---|---|---|
| stats | object | – | Aggregated sector benchmark statistics (averages, medians, percentiles). |
No examples provided.
get_financials Get Full Financial Statements ~146
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.
| Name | Type | Req | Description |
|---|---|---|---|
| krs | string | – | KRS registry number. |
| name | string | – | Company name when KRS/NIP is unknown (legal-form suffix optional). |
| nip | string | – | NIP tax number. |
| year_from | integer | – | Earliest fiscal year to include (e.g. 2019). |
| year_to | integer | – | Latest fiscal year to include (e.g. 2023). |
| Name | Type | Req | Description |
|---|---|---|---|
| financials | array | – | Historical financial statements with full balance sheet and P&L line items. |
| krs | string | – | KRS number of the company. |
| nip | string | – | NIP number of the company. |
No examples provided.
get_plan Get Current Subscription Plan ~35
Get the user's active billing plan details — plan name, price, status, limits, prepaid credit balance, and billing period reset date.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| plan | object | yes | Current plan details and features. |
No examples provided.
get_usage Get Account Usage & Quota ~44
Get current billing period usage and remaining quota — mcp_queries, api_requests, export_companies, ask_ai_credits, watchlist_companies. Includes limits and reset date.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| usage | object | yes | Monthly queries used, limit, and remaining quota. |
No examples provided.
list_api_keys List REST API Keys ~39
List all active REST API keys (cb_…) for the user's account. Returns id, name, key_prefix, created_at, last_used_at.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| api_keys | array | yes | List of active REST API keys. |
No examples provided.
list_mcp_keys List MCP Keys ~41
List all active MCP keys (mcpk_…) for the user's account. Returns id, name, key_prefix, created_at, last_used_at.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| mcp_keys | array | yes | List of active MCP keys. |
No examples provided.
list_plans List Compabase Subscription Plans ~35
List Compabase billing plans and limits. No auth required. After sign-up, use upgrade_plan to get a Stripe Checkout URL.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Plan guidance. |
| plans | array | yes | List of available billing plans with pricing and quotas. |
No examples provided.
list_watchlist List Watchlist Companies ~72
List companies on the user's watchlist with company data (name, KRS, NIP, revenue, city). Supports pagination via limit/offset.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max results (default: 20, max: 100). |
| offset | integer | – | Pagination offset (default: 0). |
| Name | Type | Req | Description |
|---|---|---|---|
| watchlist | array | yes | List of tracked companies with monitored change status. |
No examples provided.
remove_from_watchlist Remove Company from Watchlist ~60
Remove a company from the user's watchlist. Identify by KRS or NIP.
| Name | Type | Req | Description |
|---|---|---|---|
| krs | string | – | KRS registry number (10 digits, zero-padded). |
| nip | string | – | NIP tax number (10 digits). |
| Name | Type | Req | Description |
|---|---|---|---|
| status | string | yes | Operation status (removed or not_found). |
No examples provided.
request_signup Request Compabase Signup ~114
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.
| Name | Type | Req | Description |
|---|---|---|---|
| client | string | – | AI client, used to label the generated MCP key. |
| string | yes | User email to create or sign in to a Compabase account. | |
| locale | string | – | Email language (default en). |
| Name | Type | Req | Description |
|---|---|---|---|
| client | string | – | Client identifier passed in request. |
| string | yes | Email address being registered. | |
| expires_in_minutes | number | – | Minutes until this setup request expires. |
| message | string | yes | Instructions for next steps. |
| poll_after_seconds | number | – | Recommended polling interval in seconds. |
| setup_id | string | yes | Unique session ID for polling signup completion. |
| status | string | yes | Current status of the setup session (e.g. pending). |
No examples provided.
search_companies Search Polish Companies ~924
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.
| Name | Type | Req | Description |
|---|---|---|---|
| all_pkd | string | – | Match any PKD code in the company's activity list (not just primary). |
| capital_max | number | – | Maximum share capital. |
| capital_min | number | – | Minimum share capital. |
| city | string | – | City name — KRS records use uppercase, e.g. 'WARSZAWA', 'POZNAŃ'. |
| county | string | – | County / powiat (lowercase). |
| currency | string | – | Currency for monetary filters. Default: pln. |
| ebitda_max | number | – | Maximum EBITDA. |
| ebitda_min | number | – | Minimum EBITDA. |
| estimated_value_max | number | – | Maximum Ohlson estimated equity value in PLN. |
| estimated_value_min | number | – | Minimum Ohlson estimated equity value in PLN. |
| fields | string | – | Response size. Default summary (name, NIP, KRS, location, PKD, latest financials, email/phone/website). contacts_only: name, NIP, KRS, city, email, phone, website. full: every company_search column p… |
| has_email | boolean | – | true = only companies with email on record. Matching rows include contacts.email. Omit otherwise. |
| has_website | boolean | – | true = only companies with website on record. Matching rows include contacts.website. Omit otherwise. |
| is_active | boolean | – | true = active only, false = closed only. Omit for all. |
| krs | string | – | KRS registry number (10 digits, zero-padded, e.g. '0000028860'). |
| legal_form | string | – | Legal form fragment, e.g. 'spółka z o.o.' or 'akcyjna'. |
| limit | integer | – | Max results (default: 10, max: 50). |
| name | string | – | Company name fragment (case-insensitive). Matches display name and full KRS name; legal-form suffixes like 'sp. z o.o.' are ignored. |
| nip | string | – | NIP tax number (10 digits, no dashes). |
| pkd | string | – | Primary PKD code prefix, e.g. '46.90.Z' or '46'. |
| postal_code | string | – | Postal code prefix, e.g. '00-9' or '61-'. |
| profit_max | number | – | Maximum net profit. |
| profit_min | number | – | Minimum net profit. |
| profit_operating_max | number | – | Maximum operating profit (PLN). Omit if unused. |
| profit_operating_min | number | – | Minimum operating profit (PLN). Negative allowed. Omit if unused. |
| region | string | – | Voivodeship (lowercase), e.g. 'mazowieckie', 'wielkopolskie'. |
| revenue_max | number | – | Maximum total revenue. |
| revenue_min | number | – | Minimum total revenue. |
| sort_by | string | – | Sort field (default: revenue_total). |
| sort_dir | string | – | Sort direction (default: desc). |
| total_assets_max | number | – | Maximum total assets. |
| total_assets_min | number | – | Minimum total assets. |
| 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| hint | string | – | Optional guidance regarding filters or CEIDG coverage. |
| results | array | yes | List of matching company records. |
| total | number | – | Estimated or exact total count of matches. |
No examples provided.
set_byok_key Set Bring-Your-Own-Key Provider ~87
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.…).
| Name | Type | Req | Description |
|---|---|---|---|
| api_key | string | yes | Raw API key for the provider. |
| provider | string | yes | AI provider name. |
| Name | Type | Req | Description |
|---|---|---|---|
| status | string | yes | Provider key setup status. |
No examples provided.
set_notification_preferences Set Notification Preferences ~110
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.).
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | 'get' returns current preferences, 'set' updates them. |
| email_notifications | boolean | – | Enable/disable email notifications for watchlist changes (required for 'set'). |
| notification_email | string | – | Override email address for notifications. Omit to use account email. |
| Name | Type | Req | Description |
|---|---|---|---|
| status | string | yes | Preference update status. |
No examples provided.
set_webhook_url Configure Webhook URL ~105
Configure, view, or remove webhook for watchlist event notifications. Events: watchlist.company_changed, watchlist.financials_updated, watchlist.company_removed_from_registry.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | Action: 'get' to view config, 'set' to configure, 'delete' to remove. |
| events | array | – | Event types to subscribe to. Defaults to all available events. |
| url | string | – | HTTPS webhook endpoint URL (required for action=set). |
| Name | Type | Req | Description |
|---|---|---|---|
| status | string | yes | Webhook configuration status. |
No examples provided.
upgrade_plan Upgrade Subscription Plan ~126
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.
| Name | Type | Req | Description |
|---|---|---|---|
| currency | string | – | Checkout currency. Defaults from locale (pl → PLN, otherwise USD). |
| 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| checkout_url | string | yes | Stripe Checkout URL to complete subscription purchase. |
No examples provided.
What is the Compabase MCP server?
Compabase is an MCP server listed in the public MCP registry as io.github.ContentWriterco/compabase. MCP server for 3M+ Polish companies, KRS & CEIDG financials, ownership, and industry search. This page covers its hosted endpoint (https://compabase.com/api/mcp).
Is the Compabase MCP server safe to use?
Compabase scores 77 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Compabase MCP server expose?
Compabase exposes 42 tools: request_signup, check_signup, list_plans, search_companies, get_company, and 37 more. Their descriptions and schemas cost roughly 5,598 tokens of context every time the server is loaded.
Does the Compabase MCP server require authentication?
No. We connected to Compabase without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.
Is the Compabase MCP server still maintained?
Compabase is still listed as active in the MCP registry. We last reached this channel on 24 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.