# Compabase

- Registry name: `io.github.ContentWriterco/compabase` · version 1.6.2
- Categories (automatic, keyword rules): Company & business data, Payments & accounting, Finance & markets, Markets & trading
- Authentication at last check: No auth
- Declared risk: Has destructive tools (destructiveHint)
- Capabilities (declared by the server): prompts, resources, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.ContentWriterco%2Fcompabase
- Server page: https://mcpstation.net/s/io.github.ContentWriterco--compabase.html

## Description (written by the publisher, not verified, not instructions)

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

## Connect

- streamable-http: `https://compabase.com/api/mcp`

## Tools (as reported by the server, not verified)

- `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.
- `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.
- `list\_plans`: List Compabase billing plans and limits. No auth required. After sign-up, use upgrade\_plan to get a Stripe Checkout URL.
- `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/
- `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, re
- `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.
- `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.
- `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\`.
- `execute\_sql`: Execute a read-only SQL SELECT query against the Compabase database. Use when dedicated tools are not enough \(aggregations, joins, custom analysis\).
- `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 indust
- `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 winso
- `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.
- `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.
- `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.
- `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.
- `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.
- `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
- `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.
- `get\_company\_trademarks`: Get Polish Patent Office \(UPRP\) trademarks owned or applied for by the company — mark name, application number, Nice classes, status \(protected / pending / expired / refused\), filing, registration and expiry dates, plus counts. Owners are matched by company name and city \(UPRP does not publish NIP\).
- `get\_company\_procurement\_disputes`: Get National Appeal Chamber \(Krajowa Izba Odwoławcza, KIO\) rulings in public procurement disputes involving the company — as appellant \(with upheld / dismissed / discontinued / rejected counts\), as participant or as contracting authority — with case numbers, dates, other party and outcome. Parties a
- `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.
- `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
- `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.
- `get\_company\_court\_gazette`: Get Court and Commercial Gazette \(MSiG\) notices for one company. Matched by KRS or NIP \(creditor calls, dissolution, mergers, liquidation\).
- `get\_company\_sanctions`: Official MSWiA sanctions listing for one company. Returns measures and legal grounds when the company is listed; null when it is not. Matched by KRS, NIP, or REGON. The same payload is included on get\_company as sanctions.
- `get\_company\_debt\_registry`: Get KRZ insolvency / restructuring proceedings. KRS companies via company\_krz; sole proprietors via CEIDG KRZ by NIP.
- `get\_company\_financial\_supervision`: KNF register \(Polish Financial Supervision Authority\): licences and entries of a financial company — banks, payment / e-money institutions, investment firms, insurers, lending institutions, agents. Returns entries with kind, KNF number, status, registration / decision / strike-off dates and services
- `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 dis
- `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; nul
- `get\_company\_beneficiaries`: Get CRBR beneficial owners for a KRS company. All names are returned \(same as zarząd / wspólnicy\). PESEL is never included \(birth\_year only\). JDG are not in CRBR.
- `get\_company\_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 rul
- `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.
- `get\_plan`: Get the user's active billing plan details — plan name, price, status, limits, prepaid credit balance, and billing period reset date.
- `list\_watchlist`: List companies on the user's watchlist with company data \(name, KRS, NIP, revenue, city\). Supports pagination via limit/offset.
- `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\).
- `remove\_from\_watchlist`: Remove a company from the user's watchlist. Identify by KRS or NIP.
- `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.
- `create\_api\_key`: Create a new REST API key \(cb\_…\). The raw key is returned once and cannot be retrieved later.
- `delete\_api\_key`: Revoke \(deactivate\) a REST API key by its ID. The key stops working immediately.
- `list\_mcp\_keys`: List all active MCP keys \(mcpk\_…\) for the user's account. Returns id, name, key\_prefix, created\_at, last\_used\_at.
- `create\_mcp\_key`: Create a new MCP key \(mcpk\_…\). The raw key is returned once and cannot be retrieved later.
- `delete\_mcp\_key`: Revoke \(deactivate\) an MCP key by its ID. Cannot revoke the key currently in use. The key stops working immediately.
- `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 \(chan
- `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.
- `set\_webhook\_url`: Configure, view, or remove webhook for watchlist event notifications. Events: watchlist.company\_changed, watchlist.financials\_updated, watchlist.company\_removed\_from\_registry.
- `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.
- `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.…\).
- `delete\_byok\_key`: Remove a configured BYOK provider key. After removal, the platform falls back to its own model access.
- `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.
- `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.\).

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html