Polish Companies

Acceso directo a más de 3 millones de empresas polacas de los registros KRS y CEIDG.

Documentación

🇵🇱 Servidor MCP de Empresas Polacas – Compabase

Compabase MCP es un servidor de Protocolo de Contexto de Modelo que brinda a los asistentes de IA – Claude, Cursor, Windsurf, VS Code y cualquier cliente compatible con MCP – acceso directo a más de 3 millones de empresas polacas de los registros KRS (Registro Nacional de Tribunales) y CEIDG, además de datos financieros, personas, rankings y enriquecimientos de registros públicos (SUDOP, BZP, TED, URE, BDO, GPW, KRZ, CRBR, MSiG, fondos de la UE).

Pregunta en lenguaje natural. El modelo asigna las solicitudes a herramientas estructuradas a través de HTTP Streamable (JSON-RPC 2.0).

Inicio rápido

Puedes conectarte sin una clave. El agente te registra y escribe mcpk_… en la configuración del cliente después de la confirmación por correo electrónico.

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

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

Luego pide al agente que te registre (request_signup con tu correo electrónico). Después de hacer clic en el enlace mágico, consulta check_signup hasta que status: ready. Reinicia el cliente si no recarga automáticamente la configuración de MCP.

Claude Desktop – claude_desktop_config.json (después de tener una clave):

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

Claude.ai (Conectores Web / Móviles):

Ve a Configuración → Conectores → Agregar conector personalizado
URL: https://compabase.com/mcp?apiKey=mcpk_YOUR_KEY_HERE
Autenticación: None (Detected) (la clave se pasa en la URL)

También se pueden crear claves en Integraciones → MCP. Las claves MCP (mcpk_…) son diferentes de las claves de API REST (cb_…).

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

Ejemplos de solicitudes

Encuentra empresas de TI activas en Varsovia con ingresos superiores a 5 millones de PLN.
¿Cuáles son los últimos ingresos y el beneficio neto de Allegro?
Enumera los miembros del consejo de administración de la empresa con KRS 0000028860.
¿Cuántas empresas activas en mazowieckie tienen PKD principal que comience con 62?
¿Cuál es la mediana de ingresos en la sección PKD J?
¿Orlen cotiza en GPW? ¿Cuál es el ticker y el P/E?

Herramientas disponibles

El tráfico en vivo siempre es POST https://compabase.com/api/mcp con method: tools/call y params.name establecidos en el nombre de la herramienta. Identifica una empresa con name, krs o nip cuando una herramienta los acepte. Los filtros monetarios tienen como valor predeterminado PLN.

Esquemas completos: mcp.yaml · documentación interactiva.

Incorporación (sin clave)

Herramienta	Propósito
`request_signup`	Envía un correo electrónico con enlace mágico; devuelve `setup_id`
`check_signup`	Consulta hasta que el correo sea confirmado; devuelve `mcp_key` una vez
`list_plans`	Planes de facturación y límites; luego `upgrade_plan`

Datos de empresas

Herramienta	Propósito
`search_companies`	Filtra empresas KRS (nombre, PKD, ciudad, voivodato, datos financieros, estado, contactos). Hasta 50 filas. No navega por JDG.
`count_companies`	Cuenta empresas KRS que coinciden (mismos filtros, sin ordenar/límite)
`get_company`	Un perfil + datos financieros principales para el período presentado más reciente
`get_financials`	Métricas completas de P&L / balance por período fiscal
`get_company_people`	Consejo de administración, accionistas, apoderados, otros roles
`get_company_rankings`	Ranking de ingresos en PKD / región / Polonia
`get_financial_stats`	Agregados por sector/región/PKD (mediana, p25–p90, n, …)
`execute_sql`	`SELECT` / `WITH … SELECT` de solo lectura para uniones personalizadas

Enriquecimientos de registros

Herramienta	Fuente
`get_company_sudop`	Ayuda pública SUDOP / de minimis (NIP)
`get_company_bzp`	Adjudicaciones de contratación BZP y avisos de compradores (NIP)
`get_company_ted`	Licitaciones TED por encima del umbral de la UE (NIP)
`get_company_ure`	Concesiones de energía URE (NIP)
`get_company_bdo`	Registro de residuos / envases BDO (NIP)
`get_company_gpw`	Cotización en GPW / NewConnect / GlobalConnect + cotizaciones diferidas
`get_company_fe`	Fondos Europeos (listas MFiPR, cohesión)
`get_company_fts`	Subvenciones FTS de la Comisión Europea (Horizon, LIFE, …)
`get_company_msig`	Gaceta Judicial y Comercial (MSiG)
`get_company_krz`	Insolvencia / reestructuración KRZ (KRS o NIP de CEIDG)
`get_company_beneficiaries`	Beneficiarios finales CRBR (KRS). Solo nombres – nunca PESEL

Cuenta (omitir `mcp_queries`)

Herramienta	Propósito
`get_usage`	Uso del período: `mcp_queries`, `api_requests`, `export_companies`, `ask_ai_credits`, `watchlist_companies`
`get_plan`	Plan activo, límites, crédito prepagado, fecha de reinicio
`list_watchlist` / `add_to_watchlist` / `remove_from_watchlist` / `batch_add_to_watchlist`	Lista de seguimiento (KRS o NIP, incluido CEIDG)
`list_api_keys` / `create_api_key` / `delete_api_key`	Claves REST (`cb_…`)
`list_mcp_keys` / `create_mcp_key` / `delete_mcp_key`	Claves MCP (`mcpk_…`)
`export_companies`	CSV / XLSX / JSON masivo (hasta 500 filas). Usa el medidor de exportación, no `mcp_queries`
`upgrade_plan`	URL de Stripe Checkout (`pro` / `scale`)
`set_webhook_url`	Webhooks de cambios en la lista de seguimiento
`get_byok_keys` / `set_byok_key` / `delete_byok_key`	BYOK (OpenAI / Claude / Gemini), Pro+
`set_notification_preferences`	Alertas por correo electrónico para cambios en la lista de seguimiento

Cuota

Herramientas de datos (búsqueda, datos financieros, enriquecimientos, SQL): cada tools/call exitoso consume una unidad de mcp_queries.

Herramientas de cuenta omiten mcp_queries. export_companies consume export_companies en su lugar.

initialize, tools/list y ping no consumen cuota. Los límites se restablecen con el período de facturación.

Plan	Consultas MCP / mes	Solicitudes API	Exportaciones
Gratis	10	100	50
Pro	50	5 000	1 000
Escala	1 000	100 000	20 000
Empresa	Personalizado	Personalizado	Personalizado

Consulta compabase.com/pricing.

Protocolo

Propiedad	Valor
Endpoint	`POST https://compabase.com/api/mcp`
Transporte	HTTP Streamable
Versión del protocolo	`2024-11-05`
Capacidades	`tools`
Nombre del servidor	`compabase`
Versión del servidor	`1.6.2`

Método	Descripción
`initialize`	Protocolo de enlace
`tools/list`	Herramientas y esquemas
`tools/call`	Ejecutar una herramienta
`ping`	Mantener activa la conexión
`notifications/initialized`	Cliente listo

Relacionado

API REST de Compabase – OpenAPI 3.1 (v1.yaml)
Documentación interactiva de API
Documentación interactiva de MCP
compabase.com

Licencia

MIT