{
  "markdown": "# 🇵🇱 Polish Companies MCP Server – Compabase\n\n[![MCP Protocol](https://img.shields.io/badge/MCP-2024--11--05-blue)](https://modelcontextprotocol.io)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![Compabase](https://img.shields.io/badge/Powered_by-Compabase-orange)](https://compabase.com)\n[![Docs](https://img.shields.io/badge/Docs-Interactive_Redoc-blue)](https://compabase.com/docs/mcp/)\n[![Free Tier](https://img.shields.io/badge/Free_Tier-Available-brightgreen)](https://compabase.com/mcp)\n\n**Compabase MCP** is a [Model Context Protocol](https://modelcontextprotocol.io) 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).\n\nAsk in plain language. The model maps prompts to structured tools over Streamable HTTP (JSON-RPC 2.0).\n\n---\n\n## Quick Start\n\nYou can connect **without a key**. The agent signs you up and writes `mcpk_…` into the client config after email confirmation.\n\n**Cursor / Windsurf / VS Code** – `.cursor/mcp.json` (or the equivalent MCP JSON):\n\n```json\n{\n  \"mcpServers\": {\n    \"compabase\": {\n      \"url\": \"https://compabase.com/api/mcp\"\n    }\n  }\n}\n```\n\nThen 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.\n\n**Claude Desktop** – `claude_desktop_config.json` (after you have a key):\n\n```json\n{\n  \"mcpServers\": {\n    \"compabase\": {\n      \"url\": \"https://compabase.com/api/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer mcpk_YOUR_KEY_HERE\"\n      }\n    }\n  }\n}\n```\n\nKeys can also be created in [Integrations → MCP](https://compabase.com/integrations?tab=mcp). MCP keys (`mcpk_…`) are separate from REST API keys (`cb_…`).\n\n| Field | Value |\n|-------|-------|\n| Endpoint | `POST https://compabase.com/api/mcp` |\n| Authentication | `Authorization: Bearer mcpk_…` or `X-API-Key: mcpk_…` (optional until after signup) |\n| Protocol | MCP Streamable HTTP (JSON-RPC 2.0) |\n| MCP version | `2024-11-05` |\n| Server | `compabase` **1.6.2** |\n\n---\n\n## Example prompts\n\n- Find active IT companies in Warsaw with revenue over 5 million PLN.\n- What is the latest revenue and net profit of Allegro?\n- List board members of the company with KRS 0000028860.\n- How many active companies in mazowieckie have primary PKD starting with 62?\n- What is the median revenue in PKD section J?\n- Is Orlen listed on GPW? What is the ticker and P/E?\n\n---\n\n## Available tools\n\nLive 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.\n\nFull schemas: [`mcp.yaml`](mcp.yaml) · [interactive docs](https://compabase.com/docs/mcp/).\n\n### Onboarding (no key)\n\n| Tool | Purpose |\n|------|---------|\n| `request_signup` | Send a magic-link email; returns `setup_id` |\n| `check_signup` | Poll until email confirmed; returns `mcp_key` **once** |\n| `list_plans` | Billing plans and limits; then `upgrade_plan` |\n\n### Company data\n\n| Tool | Purpose |\n|------|---------|\n| `search_companies` | Filter KRS companies (name, PKD, city, voivodeship, financials, status, contacts). Up to 50 rows. Does not browse JDG. |\n| `count_companies` | Count matching KRS companies (same filters, no sort/limit) |\n| `get_company` | One profile + headline financials for the **latest** filed period |\n| `get_financials` | Full P&L / balance-sheet metrics per fiscal period |\n| `get_company_people` | Board, shareholders, proxies, other roles |\n| `get_company_rankings` | Revenue rank in PKD / region / Poland |\n| `get_financial_stats` | Sector/region/PKD aggregates (median, p25–p90, n, …) |\n| `execute_sql` | Read-only `SELECT` / `WITH … SELECT` for custom joins |\n\n### Register enrichments\n\n| Tool | Source |\n|------|--------|\n| `get_company_sudop` | SUDOP public aid / de minimis (NIP) |\n| `get_company_bzp` | BZP procurement awards and buyer notices (NIP) |\n| `get_company_ted` | TED EU-threshold tenders (NIP) |\n| `get_company_ure` | URE energy concessions (NIP) |\n| `get_company_bdo` | BDO waste / packaging register (NIP) |\n| `get_company_gpw` | GPW / NewConnect / GlobalConnect listing + delayed quotes |\n| `get_company_fe` | European Funds (MFiPR lists, cohesion) |\n| `get_company_fts` | European Commission FTS grants (Horizon, LIFE, …) |\n| `get_company_msig` | Court and Commercial Gazette (MSiG) |\n| `get_company_krz` | KRZ insolvency / restructuring (KRS or CEIDG NIP) |\n| `get_company_beneficiaries` | CRBR beneficial owners (KRS). Names only – **never PESEL** |\n\n### Account (skip `mcp_queries`)\n\n| Tool | Purpose |\n|------|---------|\n| `get_usage` | Period usage: `mcp_queries`, `api_requests`, `export_companies`, `ask_ai_credits`, `watchlist_companies` |\n| `get_plan` | Active plan, limits, prepaid credit, reset date |\n| `list_watchlist` / `add_to_watchlist` / `remove_from_watchlist` / `batch_add_to_watchlist` | Watchlist (KRS or NIP, including CEIDG) |\n| `list_api_keys` / `create_api_key` / `delete_api_key` | REST keys (`cb_…`) |\n| `list_mcp_keys` / `create_mcp_key` / `delete_mcp_key` | MCP keys (`mcpk_…`) |\n| `export_companies` | Bulk CSV / XLSX / JSON (up to 500 rows). Uses the **export** meter, not `mcp_queries` |\n| `upgrade_plan` | Stripe Checkout URL (`pro` / `scale`) |\n| `set_webhook_url` | Watchlist change webhooks |\n| `get_byok_keys` / `set_byok_key` / `delete_byok_key` | BYOK (OpenAI / Claude / Gemini), Pro+ |\n| `set_notification_preferences` | Email alerts for watchlist changes |\n\n---\n\n## Quota\n\n**Data tools** (search, financials, enrichments, SQL): each successful `tools/call` consumes one `mcp_queries` unit.\n\n**Account tools** skip `mcp_queries`. `export_companies` consumes `export_companies` instead.\n\n`initialize`, `tools/list`, and `ping` do not consume quota. Limits reset with the billing period.\n\n| Plan | MCP queries / month | API requests | Exports |\n|------|---------------------|--------------|---------|\n| Free | 10 | 100 | 50 |\n| Pro | 50 | 5 000 | 1 000 |\n| Scale | 1 000 | 100 000 | 20 000 |\n| Enterprise | Custom | Custom | Custom |\n\nSee [compabase.com/pricing](https://compabase.com/pricing).\n\n---\n\n## Protocol\n\n| Property | Value |\n|----------|-------|\n| Endpoint | `POST https://compabase.com/api/mcp` |\n| Transport | Streamable HTTP |\n| Protocol version | `2024-11-05` |\n| Capabilities | `tools` |\n| Server name | `compabase` |\n| Server version | `1.6.2` |\n\n| Method | Description |\n|--------|-------------|\n| `initialize` | Handshake |\n| `tools/list` | Tools and schemas |\n| `tools/call` | Execute a tool |\n| `ping` | Keep-alive |\n| `notifications/initialized` | Client ready |\n\n---\n\n## Related\n\n- **[Compabase REST API](https://github.com/ContentWriterco/compabase-api)** – OpenAPI 3.1 (`v1.yaml`)\n- **[Interactive API docs](https://compabase.com/docs/)**\n- **[Interactive MCP docs](https://compabase.com/docs/mcp/)**\n- **[compabase.com](https://compabase.com)**\n\n---\n\n## License\n\nMIT\n",
  "bytes": 7272,
  "sha": "595e761e81b273d1608732dbd602ac0c2abcd4f43089e2006992d7c1cbc9c10c",
  "repo_slug": "contentwriterco/compabase-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_contentwriterco_compabase_fbe1e5ea/readme"
}