Compabase MCP is a Model Context Protocol server that gives AI assistants — Claude, Cursor, Windsurf, and any other MCP-compatible client — direct access to 3 million+ Polish companies from the KRS (National Court Register) and CEIDG registries.
Ask your AI about Polish business in plain language: company financials, ownership structures, industry rankings, board members, and more — all backed by real registry data.
This is the MCP server for Polish companies data. Instead of building API integrations yourself, you connect your AI assistant to the Compabase MCP endpoint and talk to it naturally:
"Who are the top 10 manufacturing companies in Silesia by revenue?" "Show me the financial history of Orlen over the last 5 years." "How many active logistics companies are there in Mazovia?" "Who sits on the board of PKN Orlen?"
The AI handles tool selection and query construction. You get real answers from real Polish business registry data.
Sign up at compabase.com/mcp → and generate a free MCP key (mcpk_...).
Cursor — add to .cursor/mcp.json:
{
"mcpServers": {
"compabase": {
"url": "https://compabase.com/api/mcp",
"headers": {
"Authorization": "Bearer mcpk_YOUR_KEY_HERE"
}
}
}
}Claude Desktop — add to claude_desktop_config.json:
{
"mcpServers": {
"compabase": {
"url": "https://compabase.com/api/mcp",
"headers": {
"Authorization": "Bearer mcpk_YOUR_KEY_HERE"
}
}
}
}Generic MCP client
| Field | Value |
|---|---|
| Endpoint | https://compabase.com/api/mcp |
| Authentication | Authorization: Bearer <mcpk_...> |
| Protocol | MCP Streamable HTTP (JSON-RPC 2.0) |
| MCP Version | 2024-11-05 |
Once connected, just talk to your AI assistant about Polish companies:
"What were Allegro's revenues in 2022, 2023, and 2024?"
"Find active e-commerce companies in Warsaw with revenue over 50M PLN."
"Who owns and manages LPP SA?"
The Compabase MCP server exposes 6 structured tools. Your AI client selects the right tool automatically based on your question.
Search and filter Polish companies. Returns up to 50 results with key financial metrics per company.
Supports filtering by: name, KRS, NIP, city, county, voivodeship, postal code, PKD industry code (primary or any), legal form, revenue, net profit, operating profit, EBITDA, total assets, share capital, estimated value, active/inactive status, email/website presence, and fiscal year.
Monetary filters default to PLN; set currency to usd or eur to use pre-converted columns.
"Top 20 construction companies in Małopolska by revenue"
"Active spółka z o.o. companies in Poznań with EBITDA over 5M PLN"
"Companies with PKD 62.01.Z (software development) in Wrocław"
Count companies matching a filter set. Returns a single number without fetching rows — ideal for "how many" and market sizing questions.
"How many active logistics companies are registered in Poland?"
"What share of Warsaw companies have a website?"
"How many companies reported revenue over 100M PLN in 2024?"
Full company profile by KRS or NIP. Returns name, address, legal identifiers (KRS/NIP/REGON), latest financial metrics, PKD activity list, registration and closure dates.
"Give me the full profile of Allegro — KRS 0000627860"
"What is Orlen's NIP, address, and primary business activity?"
Historical financial statements for a single company. Returns all available P&L and balance sheet metrics broken down by fiscal year/period, in PLN.
Includes: revenue_total, profit_net, profit_sales, ebitda, total_assets, currency, fiscal period dates.
"Show me PKN Orlen's revenue and net profit for 2020–2024"
"What has Dino Polska's EBITDA trend been over the last 4 years?"
Board members, shareholders, and proxies for a company. Returns display names, role labels, and relationship types (management / ownership / other).
"Who is on the supervisory board of CD Projekt?"
"List all shareholders of LPP SA"
"Who are the proxies authorized to act for Allegro?"
Read-only SQL SELECT against the Compabase database. Used by the AI for complex aggregations, multi-table joins, and calculations that the structured tools cannot express.
This tool is invoked automatically by the AI when needed — you do not call it directly.
Connect Compabase MCP to turn any AI assistant into a Polish business analyst:
- Market research — find all companies in a sector, filter by size, location, and activity
- Competitive analysis — compare revenue, EBITDA, and asset growth across competitors in an industry
- Due diligence — retrieve ownership structures, management teams, and multi-year financial statements
- Lead generation — filter active companies by PKD, voivodeship, revenue range, and contact availability
- Company monitoring — check legal status, recent financials, and registry changes
Compabase MCP is built for agentic AI workflows where the model needs to query Polish company data autonomously:
- Cursor agents building business dashboards
- Claude researching Polish market opportunities
- Custom agents doing automated due diligence on target companies
- LLM pipelines that need to enrich datasets with Polish registry information
| Data Type | Source | Coverage |
|---|---|---|
| Company profiles | KRS + CEIDG | 3M+ entities |
| Financial statements | KRS e-filings (eKRS) | P&L + balance sheet, multi-year |
| Ownership structures | KRS | Shareholders, holding %, values |
| Management & roles | KRS | Board members, proxies, supervisory boards |
| PKD industry codes | GUS classification | Full PKD 2007 hierarchy |
| Geographic data | KRS + CEIDG | Voivodeship, city, postal code, county |
All requests require an MCP key sent as a Bearer token:
Authorization: Bearer mcpk_YOUR_KEY_HERE
MCP keys are separate from REST API keys. Generate them at compabase.com/mcp.
Each MCP key has a monthly query quota. Every tools/call invocation counts as one query.
10 MCP queries per month are free. For more queries, upgrade to a higher plan.
See compabase.com/pricing for details.
The Compabase MCP server implements the MCP Streamable HTTP transport over JSON-RPC 2.0.
| Property | Value |
|---|---|
| Endpoint | POST https://compabase.com/api/mcp |
| Transport | Streamable HTTP |
| Protocol version | 2024-11-05 |
| Capabilities | tools |
| Server name | compabase |
| Server version | 1.0.0 |
Supported JSON-RPC methods:
| Method | Description |
|---|---|
initialize |
Handshake and capability negotiation |
tools/list |
List all available tools and their schemas |
tools/call |
Execute a tool |
ping |
Health / keep-alive |
- Compabase REST API — full REST API for Polish companies (KRS & CEIDG) with OpenAPI spec
- Interactive API Docs — try the REST endpoints in the browser
- compabase.com — browse Polish companies, search by sector, region, and financials, chat with AI about Polish business
MIT