Enrichments.io
Encuentra personas, empresas y enriquece datos a través de más de 10 proveedores.
Documentación
Enrichments ejecuta un servidor de Model Context Protocol, por lo que un agente en Claude, ChatGPT, Cursor o Codex puede encontrar y enriquecer personas y empresas como llamadas a herramientas ordinarias — sin código de pegamento, sin SDK. Se autentica con la misma clave de API que la API REST y factura contra el mismo saldo de créditos, cobrando solo por los datos realmente devueltos.
Endpoint
| Qué | Dónde |
|---|---|
| Endpoint MCP | https://www.enrichments.io/api/mcp |
| Transporte | Streamable HTTP (POST, con respuestas SSE) |
| Autenticación | Authorization: Bearer con una clave de API de Enrichments |
| Documento de descubrimiento | /.well-known/oauth-protected-resource |
El documento de descubrimiento son los metadatos de recurso protegido RFC 9728 para el endpoint. Se sirve para los clientes que lo buscan; nada sobre la conexión requiere que lo obtengas tú mismo.
Herramientas
| Herramienta | Qué hace | Coste | Alcance |
|---|---|---|---|
search_people | Encuentra personas que coinciden con una descripción de perfil de cliente ideal — cargos, antigüedad, departamento, ubicación, empleador. Devuelve quiénes son, no su dirección de correo electrónico. | Gasta créditos | enrich:write |
enrich_people | Resuelve identificadores que ya tienes — una URL de LinkedIn, un correo electrónico o un nombre más empleador — en registros completos de personas, hasta 100 por llamada. Aquí es también de donde provienen las direcciones de correo electrónico laborales: pídelas con fields: ["email"]. | Gasta créditos | enrich:write |
search_companies | Encuentra empresas que coinciden con una descripción — industria, tamaño, ubicación, año de fundación. | Gasta créditos | enrich:write |
enrich_companies | Resuelve dominios, nombres o URLs de LinkedIn en registros de empresas — descripción, industria, plantilla, ubicación, año de fundación — hasta 100 por llamada. | Gasta créditos | enrich:write |
get_job | Consulta un trabajo iniciado por cualquier herramienta de búsqueda o enriquecimiento y recorre sus resultados. Gratis — consultar no cuesta créditos. | Gratis | enrich:read |
search | Alias de ChatGPT Deep Research. Una búsqueda de diez resultados que devuelve IDs citables; Claude y otros clientes pueden ignorarla. | Gasta créditos | enrich:write |
fetch | Alias de ChatGPT Deep Research. Lee el registro detrás de un ID de búsqueda. Gratis — devuelve algo que ya se pagó. | Gratis | enrich:read |
Las solicitudes pequeñas se responden en línea. Las más grandes se ponen en cola: la herramienta devuelve un ID de trabajo con results: null, y el agente consulta get_job hasta que done sea verdadero. Consultar es gratuito.
email nunca se devuelve a menos que se nombre en fields. Es el único campo costoso y se factura por dirección realmente encontrada, por lo que la forma prevista de una ejecución es: descubrir sin él, decidir qué filas quieres y luego hacer una llamada a enrich_people pidiéndolo exactamente en esas filas.
Qué se devuelve
Campos de personas: email, linkedin_url, title, seniority, department, location, country, company, company_domain, headline, phone, company_profile.
Campos de empresas: company, company_domain, linkedin_url, location, country, headline, más la firmografía que acompaña a cualquier fila de empresa.
Cada campo se describe en la referencia de la API, que se genera a partir de los mismos esquemas con los que estas herramientas validan.
Conexión de un cliente
Cada cliente siguiente se autentica de la misma manera: una clave de API, creada en la aplicación y mostrada una vez, enviada como Authorization: Bearer. Una clave pertenece a una organización, no a una persona, y lleva ámbitos — una clave nueva tiene ambos ámbitos de enriquecimiento, por lo que todas las herramientas anteriores se pueden llamar con ella.
Claude, Cursor y cualquier cosa que acepte una URL MCP remota
Apunta el cliente al endpoint y dale la cabecera. En Cursor esto es ~/.cursor/mcp.json para cada proyecto, o .cursor/mcp.json dentro de un repositorio. En un cliente de Claude que acepte una URL de conector personalizada, añade el endpoint y, donde se ofrezca la opción de cabeceras de solicitud, la misma cabecera.
mcp.json
{
"mcpServers": {
"enrichments": {
"url": "https://www.enrichments.io/api/mcp",
"headers": {
"Authorization": "Bearer ek_live_xxxxxxxxxxxxxxxxxxxx"
}
}
}
}
Claude Desktop y otros clientes solo-stdio
Un cliente que no puede alcanzar un servidor remoto directamente se conecta a él a través de stdio. El puente es una comodidad de desarrollo, no parte de este producto. Añade el bloque siguiente al archivo de configuración de Claude Desktop para tu plataforma, cierra Claude Desktop por completo y vuelve a abrirlo.
claude_desktop_config.json
{
"mcpServers": {
"enrichments": {
"command": "npx",
"args": [
"-y", "mcp-remote", "https://www.enrichments.io/api/mcp",
"--header", "Authorization: Bearer ek_live_xxxxxxxxxxxxxxxxxxxx"
]
}
}
}
ChatGPT y la API de Responses
Declara el servidor en línea en una solicitud de la API de Responses y pasa la clave en authorization. Deep Research solo llama a search y fetch, que este servidor registra con las formas que OpenAI documenta.
Solicitud de la API de Responses
{
"model": "gpt-5",
"tools": [
{
"type": "mcp",
"server_label": "enrichments",
"server_url": "https://www.enrichments.io/api/mcp",
"authorization": "Bearer ek_live_xxxxxxxxxxxxxxxxxxxx",
"require_approval": "never"
}
],
"input": "Find heads of platform engineering at German fintech companies."
}
Añadir el servidor a través del diálogo de conectores de la aplicación de ChatGPT aún no es compatible: ese flujo espera que el servidor se autentique mediante OAuth, y el flujo de código de autorización no está disponible aquí. Usa un cliente que pueda enviar una cabecera Authorization fija.
Codex
Codex lee sus servidores de ~/.codex/config.toml. La forma stdio funciona en todas las versiones; una compilación con soporte directo de Streamable HTTP remoto puede usar el endpoint y la cabecera en su lugar.
~/.codex/config.toml
[mcp_servers.enrichments]
command = "npx"
args = [
"-y", "mcp-remote", "https://www.enrichments.io/api/mcp",
"--header", "Authorization: Bearer ek_live_xxxxxxxxxxxxxxxxxxxx",
]
Qué rechazará el servidor
- Los números móviles están disponibles como el campo
phone\y se facturan por número encontrado. 15 alias comunes — móvil, celular, marcación directa, teléfono y el resto — se resuelven a él en lugar de fallar. A diferencia de una dirección de correo electrónico, un número no lleva veredicto de entregabilidad, porque nada comprueba un teléfono como se puede comprobar un buzón. - Que un número de teléfono esté disponible no es un consejo de que sea legal llamar. Las obligaciones según TCPA, los registros DNC y las normas locales de consentimiento son del llamante.
- El catálogo de campos está cerrado. Una solicitud de algo fuera de los 12 campos de personas es un error de validación, no una columna vacía.
- Las direcciones de correo electrónico son direcciones laborales encontradas en fuentes públicas. Los datos de contacto personales no forman parte del catálogo.
- El enriquecimiento es en vivo, no una base de datos estática con licencia, por lo que la misma consulta puede legítimamente devolver datos diferentes mañana.
Los rechazos son errores de validación en el borde con una frase que los explica, no columnas vacías — a un agente que pide un número de teléfono se le dice claramente que no hay campo de teléfono, que es lo que evita que lo reintente en un bucle.
Preguntas
¿Cuál es la URL del servidor MCP de Enrichments?
https://www.enrichments.io/api/mcp. Habla el Model Context Protocol sobre Streamable HTTP y se autentica con una clave de API de Enrichments enviada como cabecera Authorization: Bearer.
¿Qué herramientas expone el servidor MCP?
7 herramientas: search_people, enrich_people, search_companies, enrich_companies, get_job, search, fetch. Las dos últimas son alias requeridos por ChatGPT Deep Research; otros clientes pueden ignorarlas.
¿Puedo conectarlo a Claude?
Sí. Un cliente de Claude que acepte una URL de conector remota puede apuntar directamente al endpoint y proporcionar la clave de API como cabecera Authorization. Claude Desktop, que lee un archivo de configuración local, se conecta a través del puente stdio mcp-remote.
¿Puedo conectarlo a ChatGPT?
Sí, declarando el servidor en línea en una solicitud de la API de Responses con la clave de API en el campo de autorización. El diálogo de conectores de la propia aplicación de ChatGPT aún no es compatible, porque ese flujo espera que el servidor se autentique mediante OAuth y el flujo de código de autorización no está disponible aquí.
¿Llamar a las herramientas MCP cuesta créditos?
Las herramientas de búsqueda y enriquecimiento gastan créditos, cobrados solo por los datos realmente devueltos; consultar un trabajo y obtener un registro que ya pagaste son gratuitos. Cada herramienta anuncia esto al cliente a través de la indicación de solo lectura de MCP, por lo que un cliente que autoaprueba herramientas de solo lectura no puede gastar tu saldo sin supervisión.
¿El servidor MCP devuelve números de teléfono?
Los números móviles se devuelven como el campo phone\, se facturan por número encontrado y nunca llevan un veredicto de entregabilidad.
Los precios por unidad entregada están en precios; el contrato REST está en la referencia de la API.