Polish Companies

Acesso direto a mais de 3 milhões de empresas polonesas dos registros KRS e CEIDG.

Documentação

🇵🇱 Servidor MCP de Empresas Polonesas – Compabase

Compabase MCP é um servidor Model Context Protocol que dá a assistentes de IA – Claude, Cursor, Windsurf, VS Code e qualquer cliente compatível com MCP – acesso direto a mais de 3 milhões de empresas polonesas dos registros KRS (Registro Nacional de Tribunais) e CEIDG, além de dados financeiros, pessoas, rankings e enriquecimentos de registros públicos (SUDOP, BZP, TED, URE, BDO, GPW, KRZ, CRBR, MSiG, fundos da UE).

Pergunte em linguagem natural. O modelo mapeia prompts para ferramentas estruturadas via Streamable HTTP (JSON-RPC 2.0).

Início Rápido

Você pode conectar sem chave. O agente faz seu cadastro e escreve mcpk_… na configuração do cliente após a confirmação por e-mail.

Cursor / Windsurf / VS Code – .cursor/mcp.json (ou o JSON MCP equivalente):

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

Em seguida, peça ao agente para fazer seu cadastro (request_signup com seu e-mail). Depois de clicar no magic link, consulte check_signup até status: ready. Reinicie o cliente se ele não recarregar automaticamente a configuração do MCP.

Claude Desktop – claude_desktop_config.json (após você ter uma chave):

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

Claude.ai (Web / Mobile Connectors):

Vá em Configurações → Conectores → Adicionar conector personalizado
URL: https://compabase.com/mcp?apiKey=mcpk_YOUR_KEY_HERE
Autenticação: None (Detected) (a chave é passada na URL)

Chaves também podem ser criadas em Integrações → MCP. Chaves MCP (mcpk_…) são separadas das chaves da API REST (cb_…).

Campo	Valor
Endpoint	`POST https://compabase.com/api/mcp` ou `https://compabase.com/mcp`
Autenticação	`Authorization: Bearer mcpk_…`, `X-API-Key: mcpk_…` ou `?apiKey=mcpk_…`
Protocolo	MCP Streamable HTTP (JSON-RPC 2.0)
Versão MCP	`2024-11-05`
Servidor	`compabase` 1.6.2

Exemplos de prompts

Encontre empresas de TI ativas em Varsóvia com receita acima de 5 milhões de PLN.
Qual é a receita mais recente e o lucro líquido da Allegro?
Liste os membros do conselho da empresa com KRS 0000028860.
Quantas empresas ativas em mazowieckie têm PKD primário começando com 62?
Qual é a receita mediana na seção PKD J?
A Orlen está listada na GPW? Qual é o ticker e o P/L?

Ferramentas disponíveis

O tráfego ao vivo é sempre POST https://compabase.com/api/mcp com method: tools/call e params.name definidos como o nome da ferramenta. Identifique uma empresa com name, krs ou nip quando uma ferramenta os aceitar. Filtros monetários usam PLN por padrão.

Esquemas completos: mcp.yaml · documentação interativa.

Onboarding (sem chave)

Ferramenta	Finalidade
`request_signup`	Envia um e-mail com magic link; retorna `setup_id`
`check_signup`	Consulta até o e-mail ser confirmado; retorna `mcp_key` uma vez
`list_plans`	Planos de cobrança e limites; depois `upgrade_plan`

Dados de empresas

Ferramenta	Finalidade
`search_companies`	Filtra empresas KRS (nome, PKD, cidade, voivodia, dados financeiros, status, contatos). Até 50 linhas. Não pesquisa JDG.
`count_companies`	Conta empresas KRS correspondentes (mesmos filtros, sem ordenação/limite)
`get_company`	Um perfil + principais dados financeiros do período mais recente arquivado
`get_financials`	Métricas completas de DRE / balanço patrimonial por período fiscal
`get_company_people`	Conselho, acionistas, procuradores, outros cargos
`get_company_rankings`	Posição de receita em PKD / região / Polônia
`get_financial_stats`	Agregados por setor/região/PKD (mediana, p25–p90, n, …)
`execute_sql`	`SELECT` / `WITH … SELECT` somente leitura para junções personalizadas

Enriquecimentos de registros

Ferramenta	Fonte
`get_company_sudop`	Auxílio público SUDOP / de minimis (NIP)
`get_company_bzp`	Contratos de licitação BZP e avisos de compradores (NIP)
`get_company_ted`	Licitações TED acima do limite da UE (NIP)
`get_company_ure`	Concessões de energia URE (NIP)
`get_company_bdo`	Registro de resíduos/embalagens BDO (NIP)
`get_company_gpw`	Listagem GPW / NewConnect / GlobalConnect + cotações atrasadas
`get_company_fe`	Fundos Europeus (listas MFiPR, coesão)
`get_company_fts`	Subsídios FTS da Comissão Europeia (Horizon, LIFE, …)
`get_company_msig`	Diário Judicial e Comercial (MSiG)
`get_company_krz`	Insolvência / reestruturação KRZ (KRS ou NIP CEIDG)
`get_company_beneficiaries`	Beneficiários efetivos CRBR (KRS). Apenas nomes – nunca PESEL

Conta (pule `mcp_queries`)

Ferramenta	Finalidade
`get_usage`	Uso do período: `mcp_queries`, `api_requests`, `export_companies`, `ask_ai_credits`, `watchlist_companies`
`get_plan`	Plano ativo, limites, crédito pré-pago, data de reinício
`list_watchlist` / `add_to_watchlist` / `remove_from_watchlist` / `batch_add_to_watchlist`	Lista de acompanhamento (KRS ou NIP, incluindo CEIDG)
`list_api_keys` / `create_api_key` / `delete_api_key`	Chaves REST (`cb_…`)
`list_mcp_keys` / `create_mcp_key` / `delete_mcp_key`	Chaves MCP (`mcpk_…`)
`export_companies`	Exportação em lote CSV / XLSX / JSON (até 500 linhas). Usa o medidor de exportação, não `mcp_queries`
`upgrade_plan`	URL do Stripe Checkout (`pro` / `scale`)
`set_webhook_url`	Webhooks de alterações na lista de acompanhamento
`get_byok_keys` / `set_byok_key` / `delete_byok_key`	BYOK (OpenAI / Claude / Gemini), Pro+
`set_notification_preferences`	Alertas por e-mail para alterações na lista de acompanhamento

Cota

Ferramentas de dados (busca, dados financeiros, enriquecimentos, SQL): cada tools/call bem-sucedido consome uma unidade de mcp_queries.

Ferramentas de conta pulam mcp_queries. export_companies consome export_companies em vez disso.

initialize, tools/list e ping não consomem cota. Os limites são reiniciados com o período de cobrança.

Plano	Consultas MCP / mês	Requisições de API	Exportações
Gratuito	10	100	50
Pro	50	5 000	1 000
Scale	1 000	100 000	20 000
Enterprise	Personalizado	Personalizado	Personalizado

Veja compabase.com/pricing.

Protocolo

Propriedade	Valor
Endpoint	`POST https://compabase.com/api/mcp`
Transporte	Streamable HTTP
Versão do protocolo	`2024-11-05`
Capacidades	`tools`
Nome do servidor	`compabase`
Versão do servidor	`1.6.2`

Método	Descrição
`initialize`	Handshake
`tools/list`	Ferramentas e esquemas
`tools/call`	Executa uma ferramenta
`ping`	Keep-alive
`notifications/initialized`	Cliente pronto

Relacionados

API REST Compabase – OpenAPI 3.1 (v1.yaml)
Documentação interativa da API
Documentação interativa do MCP
compabase.com

Licença

MIT