Repository avatar
Other Tools
v1.6.2
active

compabase

io.github.ContentWriterco/compabase

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

Documentation

🇵🇱 Polish Companies MCP Server – Compabase

MCP Protocol License Compabase Docs Free Tier

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

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


Quick Start

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

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

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

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

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

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

Claude.ai (Web / Mobile Connectors):

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

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

FieldValue
EndpointPOST https://compabase.com/api/mcp or https://compabase.com/mcp
AuthenticationAuthorization: Bearer mcpk_…, X-API-Key: mcpk_…, or ?apiKey=mcpk_…
ProtocolMCP Streamable HTTP (JSON-RPC 2.0)
MCP version2024-11-05
Servercompabase 1.6.2

Example prompts

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

Available tools

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

Full schemas: mcp.yaml · interactive docs.

55 tools on the full server (generated from the live tools/list).

Onboarding (no key)

ToolPurpose
request_signupStart Compabase account setup for an email
check_signupPoll a request_signup session
list_plansList Compabase billing plans and limits

Company data

ToolPurpose
search_companiesSearch and filter Polish KRS companies (spółki)
get_companyGet company registry profile and headline financials for one latest filed period (financials.period_to / financial_period_to): revenue, profit, costs…
get_financialsGet full financial statement metrics per fiscal period
get_company_peopleGet people associated with a company
count_companiesCount KRS companies matching given filters
execute_sqlExecute a read-only SQL SELECT query against the Compabase database
get_company_rankingsGet a company's revenue rank positions within its industry (PKD), region (voivodeship), and all of Poland
get_financial_statsGet precomputed aggregate financial statistics for a sector, region, PKD branch, or country

Register enrichments

ToolPurpose
get_company_public_aidGet SUDOP public aid / grants for a company
get_company_eu_fundsGet European Funds (Fundusze Europejskie) projects for a company
get_company_procurementGet European Commission FTS awards for a company
get_company_public_tendersGet BZP public procurement data
get_company_energy_licensesGet URE energy concessions for a company
get_company_public_contractsGet contracts from Poland's Central Register of Contracts (CRU JSFP, Ministry of Finance) where the company is the contractor of a public-sector unit…
get_company_nfz_contractsGet contracts between the company (as a healthcare provider) and Poland's National Health Fund (NFZ)
get_company_groupGet the corporate group of a Polish company from the global LEI register (GLEIF), supplemented with foreign corporate shareholders from KRS matched to it…
get_company_nfz_queuesGet NFZ (National Health Fund) waiting lists of a healthcare provider
get_company_trademarksGet Polish Patent Office (UPRP) trademarks owned or applied for by the company
get_company_procurement_disputesGet National Appeal Chamber (Krajowa Izba Odwoławcza, KIO) rulings in public procurement disputes involving the company
get_company_waste_registryGet BDO waste and packaging register data
get_company_stock_marketGet Warsaw Stock Exchange listing for a company
get_company_eu_tendersGet TED EU-threshold public procurement
get_company_court_gazetteGet Court and Commercial Gazette (MSiG) notices for one company
get_company_sanctionsOfficial MSWiA sanctions listing for one company
get_company_debt_registryGet KRZ insolvency / restructuring proceedings
get_company_financial_supervisionKNF register (Polish Financial Supervision Authority): licences and entries of a financial company
get_company_website_factsFacts read from the company's own website: opening hours (per weekday), branches/locations with addresses, offer (CPV divisions plus short product/service…
get_company_procurement_counterpartiesPublic procurement counterparties of a company from BZP, TED and CRU: the buyers it most often wins contracts from, the contractors it most often awards…
get_company_filing_timelinessFinancial statement filing timeliness from KRS register entries (date each annual statement was filed) and the Financial Document Repository: for each recent…
get_company_secured_liabilitiesSecured liabilities from the latest financial-statement notes (period ending 2025+): mortgages (hipoteki), registered / financial pledges (zastawy)…
get_company_real_estateCompany real estate from the latest financial statement (period ending 2025+): land incl. perpetual usufruct, buildings and premises, investment property…
get_company_beneficiariesGet CRBR beneficial owners for a KRS company
get_company_articlesGet full text of the company's articles of association or statute (umowa spółki / statut) from RAR (Repozytorium Akt Rejestrowych)

Account (skip mcp_queries)

ToolPurpose
get_usageGet current billing period usage and remaining quota
get_planGet the user's active billing plan details
list_watchlistList companies on the user's watchlist with company data (name, KRS, NIP, revenue, city)
add_to_watchlistAdd a company to the user's watchlist
remove_from_watchlistRemove a company from the user's watchlist
list_api_keysList all active REST API keys (cb_…) for the user's account
create_api_keyCreate a new REST API key (cb_…)
delete_api_keyRevoke (deactivate) a REST API key by its ID
list_mcp_keysList all active MCP keys (mcpk_…) for the user's account
create_mcp_keyCreate a new MCP key (mcpk_…)
delete_mcp_keyRevoke (deactivate) an MCP key by its ID
export_companiesBulk file export of companies matching filters (CSV / XLSX / JSON)
upgrade_planCreate a Stripe Checkout session for a plan upgrade
set_webhook_urlConfigure, view, or remove webhook for watchlist event notifications
get_byok_keysList configured Bring-Your-Own-Key (BYOK) provider keys status
set_byok_keyAdd or update a BYOK provider API key
delete_byok_keyRemove a configured BYOK provider key
add_watchlist_batchAdd multiple companies to watchlist in one call
set_notification_preferencesGet or update email notification preferences for watchlist changes

Quota

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

Account tools skip mcp_queries. export_companies consumes export_companies instead.

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

PlanMCP queries / monthAPI requestsExports
Free1010050
Pro505 0001 000
Scale1 000100 00020 000
EnterpriseCustomCustomCustom

See compabase.com/pricing.


Protocol

PropertyValue
EndpointPOST https://compabase.com/api/mcp
TransportStreamable HTTP
Protocol version2024-11-05
Capabilitiestools
Server namecompabase
Server version1.6.2
MethodDescription
initializeHandshake
tools/listTools and schemas
tools/callExecute a tool
pingKeep-alive
notifications/initializedClient ready

Related


License

MIT

Gemini CLI

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

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

Claude Code plugin

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

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

Setup guides

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