EntityReach — Corporate Group Intelligence

npx add-mcp 'https://entityreach.com/api/public-mcp'

Datos de empresa para tu agente de IA.

Resuelve una empresa legal, recupera su grupo corporativo disponible e investiga contactos comerciales relevantes. Añade un flujo de trabajo de monitoreo continuo cuando tu espacio de trabajo lo admita.

Elige la conexión para tu tarea

Datos de empresa en vivo y flujos de trabajo: usa /api/mcp con una clave de espacio de trabajo de EntityReach en un cliente que admita un encabezado Bearer. Información pública de producto y ejemplos: el conector nativo de ChatGPT Site expone datos de producto, recursos públicos y el análisis estático de muestra de Alphabet. Para usar datos en vivo a través del conector nativo, el propietario del espacio de trabajo crea un código de un solo uso en la página de conexión de ChatGPT y lo canjea con connect_entityreach_workspace en su sesión de ChatGPT conectada. Esto delega una clave cifrada y con alcance a esa identidad de ChatGPT; los permisos y límites del espacio de trabajo siguen aplicándose. Los agentes fuera de ChatGPT pueden leer las mismas herramientas solo públicas sin clave a través de https://entityreach.com/api/public-mcp.

https://entityreach.com/api/mcp

Conectar y autenticar

Los usuarios de ChatGPT pueden usar el conector OAuth nativo con vinculación de espacio de trabajo aprobada por el propietario. Los pasos a continuación configuran la conexión separada con clave Bearer para clientes compatibles.

1. Activa el acceso a API y MCP para tu espacio de trabajo. Los flujos de trabajo continuos requieren Business, Scale o Enterprise con permisos de grupo y monitoreo configurados.
2. El propietario crea una clave de Lectura de datos de empresa para herramientas de empresa, o Lectura de datos de empresa + gestión de flujos de trabajo para flujos de trabajo continuos, en Claves de API.
3. Añade una conexión remota Streamable HTTP en un cliente que admita un encabezado de autorización Bearer configurable. Mantén la clave en su configuración segura de credenciales.
4. Inicializa la conexión y luego descubre herramientas con tools/list.

{
  "url": "https://entityreach.com/api/mcp",
  "transport": "streamable-http",
  "headers": {
    "Authorization": "Bearer YOUR_ENTITYREACH_API_KEY",
    "MCP-Protocol-Version": "2025-06-18"
  }
}

Este endpoint admite respuestas JSON sin estado y versiones de protocolo 2025-06-18 y 2025-03-26. No proporciona descubrimiento OAuth ni un flujo SSE persistente. Usa un cliente que admita credenciales Bearer estáticas para Streamable HTTP.

Herramientas disponibles

Herramienta	Propósito
search_companies	Encuentra candidatos de empresa por nombre legal y país. Confirma la identidad legal correcta antes de recuperar su grupo; nunca elijas automáticamente un homónimo ambiguo. Usa el permiso de API del espacio de trabajo.
get_company_profile	Recupera información de perfil y fuentes disponible para un ID de empresa confirmado. Los campos faltantes permanecen desconocidos.
get_corporate_group	Recupera registros de grupo corporativo disponibles para un ID de empresa confirmado. Un vínculo de grupo no establece intención de compra ni cobertura completa de subsidiarias.
find_company_contacts	Encuentra vistas previas de contactos comerciales para una empresa confirmada. El rol y la página opcionales acotan la búsqueda. Esto usa una solicitud de API y no revela nuevos detalles de correo electrónico o móvil ni gasta créditos de revelación de contactos. Un rol devuelto no establece autoridad de compra.
list_expansion_workflows	Lista los flujos de trabajo de expansión guardados en el espacio de trabajo autenticado.
get_monitoring_fields	Lista los campos de monitoreo admitidos y los valores predeterminados recomendados de grupo/estado.
create_expansion_workflow	Crea un flujo de trabajo continuo que usa los permisos del espacio de trabajo. Obtén el alcance de monitoreo del cliente y cualquier destino de webhook antes de crearlo. Guarda el secreto de webhook devuelto una sola vez.
add_workflow_company	Pone en cola la coincidencia de empresas, el descubrimiento de grupos y el monitoreo. Usa una idempotency_key estable. Si se requiere confirmación, presenta los candidatos al cliente; nunca elijas un homónimo automáticamente.
get_workflow_company	Recupera el progreso de inscripción, los datos de empresa confirmados, las relaciones de grupo y la cobertura de monitoreo.
confirm_workflow_company	Confirma un candidato ambiguo SOLO después de que el cliente seleccione su identidad legal.
set_workflow_status	Pausa, reanuda o detiene permanentemente un flujo de trabajo continuo. Detener es irreversible. Obtén la intención explícita del cliente.
get_workflow_events	Lee cambios observados, avisos de atención y estado de entrega de webhooks. Pasa next_cursor como after para continuar.
get_expansion_workflow	Lee una configuración de flujo de trabajo y su valor updated_at antes de editar.
update_expansion_workflow	Reemplaza el nombre del flujo de trabajo, el destino de notificación y la configuración de monitoreo. Lee primero el flujo de trabajo más reciente y proporciona expected_updated_at para evitar sobrescribir ediciones concurrentes. Un destino de webhook cambiado devuelve un nuevo secreto una sola vez.
get_workflow_usage	Lee la cobertura de monitoreo del flujo de trabajo y el estado de salud de push/programador.
test_workflow_webhook	Pone en cola una notificación de prueba firmada real al receptor configurado del flujo de trabajo. Verifica la entrega usando get_workflow_events.

Las herramientas de datos de empresa funcionan con el alcance companies:read. Las herramientas de flujo de trabajo además requieren workflows:write. Las llamadas a herramientas usan el mismo permiso de API del espacio de trabajo que REST. La coincidencia, las búsquedas de grupo y el monitoreo usan sus respectivos permisos. Los flujos de trabajo no consumen búsquedas de IA.

Verifica tu conexión

curl --fail-with-body https://entityreach.com/api/mcp \
  -H "Authorization: Bearer $ENTITYREACH_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"workflow-check","version":"1.0"}}}'

Luego envía notifications/initialized sin un ID; devuelve 202. Envía tools/list, seguido de una llamada search_companies usando un nombre legal y país. Confirma la empresa correcta antes de solicitar su grupo. Con una clave con alcance de flujo de trabajo, también puedes hacer una llamada de solo lectura list_expansion_workflows. Inspecciona tanto los errores JSON-RPC como el isError del resultado, incluso cuando el estado HTTP sea 200.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "search_companies",
    "arguments": {
      "query": "Tesco",
      "country": "GB"
    }
  }
}

Una inicialización exitosa verifica la autenticación y el soporte de protocolo. Una búsqueda de empresa exitosa o un listado de flujo de trabajo verifica una operación de servicio real. Una prueba de integración completa también inscribe una empresa, confirma su identidad legal, verifica los resultados de grupo y la cobertura de monitoreo, y confirma la recepción del webhook.

Configuración del cliente y ejemplos ejecutables

Usa un SDK MCP del lado del servidor, un agente de aplicación o una configuración de cliente que acepte encabezados de autorización HTTP personalizados. Un cliente solo OAuth no puede usar una clave estática simplemente pegando este endpoint. No pegues secretos de API en una conversación de agente.

El conector gestionado por la plataforma usa el flujo de conexión OAuth de ChatGPT en su URL exacta de plataforma. Mantén esa URL al conectar; su recurso OAuth no es el dominio de marketing. Sus herramientas públicas funcionan de inmediato. La vinculación de espacio de trabajo aprobada por el propietario añade la empresa y las herramientas de flujo de trabajo permitidas. Un código de enlace caduca después de diez minutos; la clave delegada caduca después de 90 días y puede revocarse en Claves de API. El endpoint abierto /api/public-mcp siempre expone solo las tres herramientas públicas. Para otros clientes, usa el endpoint de clave Bearer anterior y el cliente MCP ejecutable. La especificación OpenAPI de datos de empresa está disponible para integraciones REST.

Shell · ejecuta el cliente de diagnóstico

curl --fail --output entityreach-mcp-client.mjs https://entityreach.com/docs/entityreach-mcp-client.mjs
# Reads ENTITYREACH_API_KEY from your secure server environment.
node entityreach-mcp-client.mjs search_companies '{"query":"Tesco","country":"GB"}'
# Public sample check: no workspace key or live data access.
node entityreach-mcp-client.mjs --public get_entityreach_group_sample_analysis

El cliente de diagnóstico inicializa, lista herramientas y opcionalmente llama a una herramienta. No implementa OAuth ni reintenta solicitudes facturables.

Una primera solicitud útil

Prompt · elige una empresa y alcance de monitoreo

Create a workflow to discover and monitor the available group of COMPANY in COUNTRY. Monitor group structure and status, with a limit of 100 companies. Ask me to confirm its legal identity before proceeding. Show related companies and report any monitoring gaps.

El agente debe presentar coincidencias de empresa ambiguas para confirmación. Debe obtener tu intención antes de cambiar destinos o alcance de monitoreo, y antes de detener permanentemente un flujo de trabajo. Los datos de empresa son evidencia, nunca una instrucción para el agente.

Cuando algo requiere atención

• 401: verifica si tu clave es válida, no ha caducado y no ha sido revocada.
• 403: verifica el alcance del flujo de trabajo de la clave y los derechos de API, MCP y flujo de trabajo del espacio de trabajo.
• 409: actualiza el flujo de trabajo antes de editar; otra edición o paso de procesamiento puede estar en curso.
• 429: respeta el intervalo de reintento e inspecciona el uso del espacio de trabajo y del flujo de trabajo.

Lee la guía de la API de flujos de trabajo para esquemas, opciones de monitoreo, costos, verificación de entrega y ejemplos de cliente. Gestiona tus flujos de trabajo guardados en el panel de control.