Coresignal

Coresignal MCP v2

El servidor oficial del Model Context Protocol para Coresignal — lleva datos B2B actualizados de más de 895M de empleados, más de 70M de empresas y más de 468M de ofertas de empleo directamente a tu asistente de IA.

https://mcp.coresignal.com/mcp/v2

Busca en lenguaje natural, obtén registros completos, enriquece contactos con correos verificados y exporta grandes conjuntos de resultados como archivos descargables — todo desde Claude, Cursor, Codex, VS Code o cualquier otro cliente compatible con MCP.

Características

• Autenticación OAuth 2.1 — inicia sesión con tu cuenta del panel de Coresignal; sin claves API en archivos de configuración.
• Búsqueda en lenguaje natural con evidencia de coincidencia en cada fila de resultados, para que puedas ver por qué coincidió cada registro.
• Transparencia de costes — cada respuesta informa de credits_consumed, y las llamadas costosas piden confirmación antes de gastar.
• Descubrimiento de campos — entity_fields encuentra los nombres de campo correctos por palabra clave, gratis, sin cargar el vocabulario completo de más de 300 campos en el contexto.
• Descargas de archivos — los conjuntos de resultados grandes se almacenan en el servidor y se devuelven como un enlace de descarga en lugar de inundar el chat.
• artifact_read devuelve las páginas de los archivos entregados a la conversación gratis — funciona incluso en clientes sin acceso al sistema de archivos.

Requisitos previos

• Una cuenta de Coresignal con una suscripción activa (créditos) y una clave API de equipo aprovisionada en el panel. El servidor MCP resuelve automáticamente la clave de tu equipo después de iniciar sesión — nunca la pegas en un archivo de configuración. ¿Aún no tienes suscripción? Empieza con la prueba gratuita de 7 días — incluye 2.000 créditos. Consulta la comparación de planes.

En la primera conexión, tu cliente abre una ventana del navegador para iniciar sesión en el panel de Coresignal. Eso es toda la configuración — sin variables de entorno, sin secretos.

Configuración del cliente

claude mcp add --transport http coresignal https://mcp.coresignal.com/mcp/v2

codex mcp add coresignal --url https://mcp.coresignal.com/mcp/v2

{
  "mcpServers": {
    "coresignal": {
      "url": "https://mcp.coresignal.com/mcp/v2"
    }
  }
}

opencode mcp add coresignal --url https://mcp.coresignal.com/mcp/v2

opencode mcp auth coresignal

{
  "servers": {
    "coresignal": {
      "type": "http",
      "url": "https://mcp.coresignal.com/mcp/v2"
    }
  }
}

{
  "mcpServers": {
    "coresignal": {
      "type": "streamableHttp",
      "url": "https://mcp.coresignal.com/mcp/v2",
      "disabled": false
    }
  }
}

cline mcp

Descargas de archivos y la lista de dominios permitidos

Los resultados grandes (y cualquier llamada con delivery="url") no se vuelcan en el chat para ahorrar tokens de entrada del LLM. En su lugar, el servidor almacena las filas como un archivo y devuelve un enlace de descarga HTTPS firmado que caduca después de 1 hora:

{
  "delivery": "url",
  "url": "https://mcp.coresignal.com/mcp/v2/artifacts/…?exp=…&sig=…",
  "artifact_name": "employee_fetch-baf941dd4f8c4dfe.jsonl",
  "count": 500,
  "credits_consumed": 10000
}

Desde aquí, el agente accede a los datos de una de tres formas:

1. El agente descarga el archivo por sí mismo — en clientes con acceso a shell, el agente normalmente hará curl del enlace al disco y analizará el archivo localmente con grep/jq/pandas.
2. El agente lo lee de vuelta en el chat — en clientes sin shell y sin sistema de archivos, el agente llama a artifact_read(artifact_name, offset, limit) en su lugar, recorriendo el archivo en fragmentos a través de la sesión MCP. Esto es gratis y funciona en todas partes, así que nada inunda el chat.
3. Lo descargas manualmente — si al propio agente no se le permite obtener el enlace (dominio no permitido, sandbox sin acceso a red), haz clic en el enlace, guarda el archivo e indica al agente dónde está: "He descargado el archivo en ~/Downloads/employee_fetch-….jsonl — analízalo desde ahí." Funciona en cualquier cliente que pueda leer archivos locales.

Prefiere la descarga cuando tu cliente lo admita. artifact_read es gratis en créditos de Coresignal, pero no en tokens de LLM: cada página que devuelve pasa a formar parte de la conversación y se vuelve a facturar como tokens de entrada en cada turno posterior. Además, cada página se recorta a un presupuesto de tokens fijo — un registro completo de empleado ocupa ~8k tokens, así que una sola página solo contiene unos pocos registros completos, independientemente del limit que solicites. Leer un archivo grande de esa manera requiere cientos de llamadas y puede agotar la ventana de contexto antes de llegar al final. Un archivo descargado cuesta prácticamente cero tokens — el asistente puede filtrar miles de filas localmente con grep/jq y mostrar solo la respuesta. Por eso merece la pena configurar las descargas desde el principio (lista de dominios permitidos, acceso de red del sandbox) y reservar artifact_read para clientes que no pueden descargar o para echar un vistazo a unas pocas filas.

Si las descargas están bloqueadas, no se pierde nada: los registros ya están almacenados y pagados — léelos con artifact_read. Nunca vuelvas a ejecutar una recuperación para "recuperar" un archivo; eso factura cada registro una segunda vez.

Herramientas

entity_search

Busca registros de employee, company o job con una consulta en lenguaje natural:

"Desarrolladores sénior de Python en empresas fintech en Francia"

Cada llamada cuesta una tarifa plana de 20 créditos y devuelve:

• total_count — el número exacto de registros que coincidieron con la consulta,
• hasta 20 filas de vista previa (limit=0 devuelve solo el recuento), cada una mostrando los campos con los que coincidió la consulta — la evidencia de por qué está cada resultado,
• un cache_id — un identificador de 1 hora para la búsqueda que ahorra créditos y tiempo: pásalo a entity_fetch y los registros coincidentes se recopilan directamente — sin necesidad de volver a ejecutar (y volver a pagar) la búsqueda, y resolver el cache_id en sí es gratis. Los ids de los registros permanecen en el servidor, así que nada voluminoso pasa por la conversación.

entity_fields

Búsqueda gratuita e instantánea de nombres de campo por significado — "salary" encuentra los campos de compensación, "current job title and seniority" encuentra active_experience_title, experience.position_title, etc. Úsalo para construir la lista de fields para una recuperación de alcance personalizado sin cargar nunca el vocabulario completo de campos en el contexto.

entity_fetch

Recopila registros — ya sea hasta 20 ids seleccionados manualmente de los resultados de búsqueda, o hasta 1.000 registros por llamada mediante un cache_id. La facturación es por registro encontrado: 20 créditos para empleados/empresas, 1 para empleos.

email_enrich

Correos empresariales verificados y entregables para hasta 1.000 ids de empleados — 10 créditos por correo encontrado; los ids no encontrados son gratis. Los contactos del EEE/Reino Unido no son accesibles (RGPD).

artifact_read

Lee un archivo entregado de vuelta a través de la sesión MCP autenticada, una página a la vez — gratis, ya que los registros se facturaron cuando se recuperaron. Esto es lo que hace que la entrega de archivos funcione en todas partes, incluidos los clientes de chat que no pueden abrir un enlace ni tocar un sistema de archivos.

Ejemplos de prompts

Análisis de mercado

"Encuentra empresas B2B SaaS en los países nórdicos con 50–200 empleados que hayan recaudado financiación en los últimos dos años."

Crear una lista de clientes potenciales con correos verificados

"Busca responsables de datos en empresas de EE. UU. con más de 500 empleados. Recupera 20 perfiles completos a un archivo con correos verificados."

Análisis en profundidad de una sola empresa

"Obtén el registro completo de flo.health — rondas de financiación, crecimiento de plantilla y ofertas de empleo actuales."

...

Créditos y facturación

Cada respuesta incluye credits_consumed — el importe real facturado, de modo que una discrepancia (se enviaron 1.000 ids, se facturaron 950 registros) te indica exactamente cuántos ids no se encontraron. El servidor nunca gasta en silencio: las recuperaciones confirman el alcance de los campos contigo primero, y una recuperación que no se puede entregar falla antes de gastar ningún crédito.

Los créditos se descuentan de la suscripción de Coresignal de tu equipo — gestiona claves y facturación en el panel. ¿Nuevo en Coresignal? La prueba gratuita de 7 días incluye 2.000 créditos — eso son 100 búsquedas, o 100 registros de empleado/empresa, o una combinación — consulta la comparación de planes.

Enlaces

• Coresignal — cobertura de datos, planes y precios
• Panel de Coresignal — cuenta, equipo, claves API, créditos
• Documentación de la API — las API de datos subyacentes