MCP server

Compabase

io.github.ContentWriterco/compabase

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

51

Token cost

About 10,551 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http compabase https://compabase.com/api/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.compabase]
url = "https://compabase.com/api/mcp"

Gemini CLI

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

Cursor

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

VS Code

{"servers":{"compabase":{"type":"http","url":"https://compabase.com/api/mcp"}}}

Antigravity

agy mcp add compabase https://compabase.com/api/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"compabase","server_url":"https://compabase.com/api/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"compabase","server_url":"https://compabase.com/api/mcp"}

Tools

• add_to_watchlist ~124 tokens
  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).
• add_watchlist_batch ~123 tokens
  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.
• check_signup ~154 tokens
  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.
• count_companies ~891 tokens
  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`.
• create_api_key Changes accounts · ~84 tokens
  Create a new REST API key (cb_…). The raw key is returned once and cannot be retrieved later.
• create_mcp_key ~84 tokens
  Create a new MCP key (mcpk_…). The raw key is returned once and cannot be retrieved later.
• delete_api_key Deletes data · ~82 tokens
  Revoke (deactivate) a REST API key by its ID. The key stops working immediately.
• delete_byok_key Deletes data · ~94 tokens
  Remove a configured BYOK provider key. After removal, the platform falls back to its own model access.
• delete_mcp_key Deletes data · ~93 tokens
  Revoke (deactivate) an MCP key by its ID. Cannot revoke the key currently in use. The key stops working immediately.
• execute_sql ~100 tokens
  Execute a read-only SQL SELECT query against the Compabase database. Use when dedicated tools are not enough (aggregations, joins, custom analysis).
• export_companies ~667 tokens
  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
• get_byok_keys ~82 tokens
  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.
• get_company ~321 tokens
  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_company_articles ~243 tokens
  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_company_beneficiaries ~145 tokens
  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_court_gazette ~130 tokens
  Get Court and Commercial Gazette (MSiG) notices for one company. Matched by KRS or NIP (creditor calls, dissolution, mergers, liquidation).
• get_company_debt_registry ~123 tokens
  Get KRZ insolvency / restructuring proceedings. KRS companies via company_krz; sole proprietors via CEIDG KRZ by NIP.
• get_company_energy_licenses ~148 tokens
  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_eu_funds ~171 tokens
  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_eu_tenders ~131 tokens
  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_financial_supervision ~186 tokens
  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_nfz_contracts ~204 tokens
  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_nfz_queues ~344 tokens
  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 waitin
• get_company_people ~200 tokens
  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.
• get_company_procurement ~156 tokens
  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_procurement_disputes ~196 tokens
  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_public_aid ~135 tokens
  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_public_contracts ~219 tokens
  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_public_tenders ~135 tokens
  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_rankings ~240 tokens
  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_company_real_estate ~195 tokens
  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_sanctions ~148 tokens
  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_secured_liabilities ~172 tokens
  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_stock_market ~218 tokens
  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_trademarks ~185 tokens
  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_waste_registry ~150 tokens
  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_financial_stats ~322 tokens
  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_financials ~211 tokens
  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_plan ~63 tokens
  Get the user's active billing plan details — plan name, price, status, limits, prepaid credit balance, and billing period reset date.
• get_usage ~73 tokens
  Get current billing period usage and remaining quota — mcp_queries, api_requests, export_companies, ask_ai_credits, watchlist_companies. Includes limits and reset date.
• list_api_keys ~59 tokens
  List all active REST API keys (cb_…) for the user's account. Returns id, name, key_prefix, created_at, last_used_at.
• list_mcp_keys ~58 tokens
  List all active MCP keys (mcpk_…) for the user's account. Returns id, name, key_prefix, created_at, last_used_at.
• list_plans ~60 tokens
  List Compabase billing plans and limits. No auth required. After sign-up, use upgrade_plan to get a Stripe Checkout URL.
• list_watchlist ~118 tokens
  List companies on the user's watchlist with company data (name, KRS, NIP, revenue, city). Supports pagination via limit/offset.
• remove_from_watchlist ~91 tokens
  Remove a company from the user's watchlist. Identify by KRS or NIP.
• request_signup ~204 tokens
  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.
• search_companies ~1471 tokens
  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/
• set_byok_key ~134 tokens
  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.…).
• set_notification_preferences ~212 tokens
  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.).
• set_webhook_url ~188 tokens
  Configure, view, or remove webhook for watchlist event notifications. Events: watchlist.company_changed, watchlist.financials_updated, watchlist.company_removed_from_registry.
• upgrade_plan ~214 tokens
  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.

Browse

• Claude tools
• GitHub tools
• Spreadsheets
• Email
• Legal research
• GitHub and code hosting

Related MCP servers

• Polish Company Financials
  Polish company financial statements for AI agents: revenue, profit, assets, rankings, benchmarks.
• Polish Public Tenders
  Polish public procurement for AI agents: BZP and TED tenders, awards, buyers and contractors.
• skanfirmy.pl
  Verify Polish companies by NIP/KRS/REGON + EU VAT (VIES). 14 MCP tools (9 no-key).
• Sirenic
  Official French and European company data for AI agents, paid per call (x402) or by API key.
• msza.ai — Polish Catholic Sermons ✝
  Search public Polish Catholic sermons, transcripts, Scripture, prayers, churches and daily content.
• Przetargowy Janusz — Polish public tenders
  Polish tenders: search, AI summaries. Trial/paid: matched tenders, pipeline, archive, doc filling
• Polish KYB
  Know-your-business checks for Polish companies: KRS, owners, insolvency, sanctions, gazette notices.
• nimistu — Estonian Business Register
  Estonian Business Register: companies, people, beneficial owners, trademarks. Free, no API key.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.ContentWriterco/compabase.svg)](https://aptlynx.net/servers/io.github.ContentWriterco/compabase)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents