Compabase

The 54 tools it listed

"Read only" and "Changes data" are the server's own marks. Underlined parameters are required.

1. add_to_watchlist

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

   krs nip

2. add_watchlist_batch

   Batch Add Companies to Watchlist

   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.

   identifiers

3. check_signup

   Check Compabase Signup Status

   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.

   setup_id client

4. count_companiesRead only

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

   name krs nip city county region pkd all_pkd legal_form revenue_min revenue_max profit_min profit_max profit_operating_min profit_operating_max total_assets_min total_assets_max ebitda_min ebitda_max capital_min capital_max estimated_value_min estimated_value_max registration_date_min registration_date_max is_active has_email has_website year

5. create_api_key

   Create REST API Key

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

   name

6. create_mcp_key

   Create MCP Key

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

   name

7. delete_api_keyChanges data

   Revoke REST API Key

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

   key_id

8. delete_byok_keyChanges data

   Remove Bring-Your-Own-Key Provider

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

   provider

9. delete_mcp_keyChanges data

   Revoke MCP Key

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

   key_id

10. execute_sqlRead only

    Execute Read-Only SQL

    Execute a read-only SQL SELECT query against the Compabase database. Use when dedicated tools are not enough (aggregations, joins, custom analysis). Returns at most row_limit rows per call depending on the plan (Free 100, Pro 500, Scale 1000); if truncated is true, aggregate inside SQL (GROUP BY, COUNT, AVG, percentile_cont) instead of listing raw rows.

    query

11. export_companies

    Export Companies to CSV

    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 krs nip city county region pkd all_pkd revenue_min revenue_max is_active format locale limit fields

12. get_byok_keysRead only

    Get Bring-Your-Own-Key Providers

    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.

13. get_companyRead only

    Get Company Profile

    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.

    name krs nip

14. get_company_articlesRead only

    Get Articles of Association

    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 krs nip doc_id

15. get_company_beneficiariesRead only

    Get Ultimate Beneficial Owners (CRBR)

    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 krs nip

16. get_company_court_gazetteRead only

    Get Court and Commercial Gazette (MSiG)

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

    name krs nip

17. get_company_debt_registryRead only

    Get National Debt Register (KRZ)

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

    name krs nip

18. get_company_energy_licensesRead only

    Get Energy Regulatory Office Licenses (URE)

    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 krs nip

19. get_company_eu_fundsRead only

    Get EU Funds Projects

    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 krs nip

20. get_company_eu_tendersRead only

    Get EU Tenders Daily (TED)

    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 krs nip

21. get_company_filing_timelinessRead only

    Get Financial Statement Filing Timeliness

    Financial statement filing timeliness from KRS register entries (date each annual statement was filed) and the Financial Document Repository: for each recent financial year the period end, filing date, statutory deadline (year end + 6 months + 15 days), days late or not filed, and whether a statutory auditor's report was filed. Also overdue_year when the latest statement is past its deadline and missing, and late_last_5y. Keyed by KRS; null when the company has never filed.

    name krs nip

22. get_company_financial_supervisionRead only

    Get KNF Financial Supervision Register

    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.

    name krs nip

23. get_company_nfz_contractsRead only

    Get National Health Fund Contracts (NFZ)

    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.

    name krs nip

24. get_company_nfz_queuesRead only

    Get NFZ Waiting Lists (Terminy leczenia)

    Get NFZ (National Health Fund) waiting lists of a healthcare provider — every NFZ-funded service (specialist clinics, diagnostics such as MRI/CT, procedures, rehabilitation, hospital wards) it runs a waiting list for, per location: NFZ forecast waiting time for stable and urgent cases, people waiting, average wait, address, phone, whether children are seen and accessibility. Sorted by shortest wait. Optional filters: service (e.g. 'okulist', 'rezonans') and town. Data from the NFZ 'Terminy leczenia' API; the forecast is not a booking. Keyed by NIP. Identify company by name, KRS, or NIP.

    name krs nip service town limit

25. get_company_peopleRead only

    Get Company People & Management

    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 krs nip relationship_type

26. get_company_procurementRead only

    Get EU Grants (FTS)

    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 krs nip

27. get_company_procurement_counterpartiesRead only

    Get Public Procurement Counterparties

    Public procurement counterparties of a company from BZP, TED and CRU: the buyers it most often wins contracts from, the contractors it most often awards contracts to, and its consortium partners — each with KRS (when known), number of contracts, total value (PLN/EUR/USD) and years. Top 20 per role plus totals. Keyed by NIP/KRS; null when the company has no public procurement.

    name krs nip

28. get_company_procurement_disputesRead only

    Get Procurement Disputes (KIO)

    Get National Appeal Chamber (Krajowa Izba Odwoławcza, KIO) rulings in public procurement disputes involving the company — as appellant (with upheld / dismissed / discontinued / rejected counts), as participant or as contracting authority — with case numbers, dates, other party and outcome. Parties are matched by name and city. Identify company by name, KRS, or NIP.

    name krs nip

29. get_company_public_aidRead only

    Get Public Aid (SUDOP)

    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 krs nip

30. get_company_public_contractsRead only

    Get Public Sector Contracts (CRU)

    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.

    name krs nip

31. get_company_public_tendersRead only

    Get Public Procurement Bulletin (BZP)

    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 krs nip

32. get_company_rankingsRead only

    Get Company Sector 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). PKD scope keys of historical classifications are prefixed with the version: 'v2007:62.01.Z', 'v2004:50', 'v1997:74.84.B' (no prefix = PKD 2025). Use for questions like: where does company X rank in Poland / its industry / its region?

    name krs nip scope_type

33. get_company_real_estateRead only

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

    name krs nip

34. get_company_sanctionsRead only

    Get sanctions listing (MSWiA)

    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.

    name krs nip

35. get_company_secured_liabilitiesRead only

    Get Secured Liabilities (Mortgages, Pledges)

    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.

    name krs nip

36. get_company_stock_marketRead only

    Get Warsaw Stock Exchange Data (GPW)

    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 krs nip

37. get_company_trademarksRead only

    Get Trademarks (UPRP)

    Get Polish Patent Office (UPRP) trademarks owned or applied for by the company — mark name, application number, Nice classes, status (protected / pending / expired / refused), filing, registration and expiry dates, plus counts. Owners are matched by company name and city (UPRP does not publish NIP). Identify company by name, KRS, or NIP.

    name krs nip

38. get_company_waste_registryRead only

    Get Waste Management Registry (BDO)

    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 krs nip

39. get_company_website_factsRead only

    Get Company Website Facts

    Facts read from the company's own website: opening hours (per weekday), branches/locations with addresses, offer (CPV divisions plus short product/service names in PL/EN/DE), certifications found on the site (ISO 9001, HACCP, FSC…), website technology (CMS, e-commerce platform, payments, analytics) and clients/partners linked from the site that match KRS companies. Keyed by KRS or NIP (sole proprietors with a public profile); null when the website has not been read or shows none of these.

    name krs nip

40. get_financial_statsRead only

    Get Sector Financial Statistics

    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.

    dimension_type dimension_key metric currency

41. get_financialsRead only

    Get Full Financial Statements

    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 krs nip year_from year_to

42. get_planRead only

    Get Current Subscription Plan

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

43. get_usageRead only

    Get Account Usage & Quota

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

44. list_api_keysRead only

    List REST API Keys

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

45. list_mcp_keysRead only

    List MCP Keys

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

46. list_plansRead only

    List Compabase Subscription Plans

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

47. list_watchlistRead only

    List Watchlist Companies

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

    limit offset

48. remove_from_watchlistChanges data

    Remove Company from Watchlist

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

    krs nip

49. request_signup

    Request Compabase 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.

    email locale client

50. search_companiesRead only

    Search Polish 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.

    name krs nip city county region postal_code pkd all_pkd legal_form currency revenue_min revenue_max profit_min profit_max profit_operating_min profit_operating_max total_assets_min total_assets_max ebitda_min ebitda_max capital_min capital_max estimated_value_min estimated_value_max registration_date_min registration_date_max is_active has_email has_website sort_by sort_dir year limit fields

51. set_byok_key

    Set Bring-Your-Own-Key Provider

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

    provider api_key

52. set_notification_preferences

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

    action email_notifications notification_email

53. set_webhook_url

    Configure Webhook URL

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

    action url events

54. upgrade_plan

    Upgrade Subscription 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.

    plan_id locale currency