Official Apollo.io MCP

Encuentra compradores y agenda más reuniones sin tu Asistente de IA

Documentación

Servidor MCP de Apollo.io

El servidor oficial del Model Context Protocol de Apollo.io para prospección, enriquecimiento de contactos, inteligencia de ventas y flujos de trabajo de divulgación.

Proveedor: Servidor oficial de primera parte, construido y mantenido por Apollo.io.

Lleva la prospección, el enriquecimiento y la divulgación de Apollo.io directamente a tu aplicación de IA compatible con MCP favorita: GitHub Copilot, Visual Studio Code, Cursor, Claude Code, Claude Desktop y Claude Cowork.

Apollo.io: https://www.apollo.io/
Model Context Protocol: https://modelcontextprotocol.io/
Licencia: MIT

Tabla de contenidos

Descripción general
Capacidades principales
Requisitos previos
Instalación en Visual Studio Code y GitHub Copilot
Instalación en Cursor
Instalación en Claude Code
Instalación en Claude Desktop o Claude Cowork
Configuración genérica de cliente MCP
Autenticación y autorización
Ejemplos de uso
Herramientas y capacidades disponibles
Recomendaciones de modelos
Seguridad y uso responsable
Privacidad y manejo de datos
Solución de problemas
Registro oficial de MCP
Desarrollo y contribución
Versionado y lanzamientos
Seguridad
Soporte
Créditos
Licencia

Descripción general

El servidor MCP de Apollo.io expone los datos y flujos de trabajo de go-to-market de Apollo.io a través del Model Context Protocol, para que las aplicaciones de IA compatibles con MCP puedan prospectar personas y empresas, enriquecer contactos, consultar analíticas de ventas y cargar contactos en secuencias de divulgación usando lenguaje natural.

Alojado y mantenido por Apollo.io. El servidor se ejecuta de forma remota: no hay nada que compilar, alojar ni ejecutar localmente.
Transporte: HTTP de transmisión (Streamable HTTP).
Punto de conexión (endpoint):
```
https://mcp.apollo.io/mcp
```
Autenticación: Se gestiona mediante OAuth de Apollo.io. Inicia sesión con tu cuenta de Apollo.io y autoriza el acceso desde tu cliente MCP; el servidor actúa entonces con tus permisos de Apollo.io. Consulta Autenticación y autorización.

Este repositorio también incluye un complemento opcional de Apollo para Claude Code y Cowork que agrupa habilidades de flujo de trabajo listas para usar (comandos /apollo:*) sobre el mismo servidor MCP.

Capacidades principales

Las siguientes capacidades están confirmadas por las herramientas y habilidades del servidor incluidas en este repositorio:

Prospección de personas — busca en la base de datos de personas de Apollo por cargo, nivel de antigüedad, ubicación y atributos de empresa.
Prospección de empresas — busca organizaciones por industria, tamaño, ubicación y palabras clave.
Enriquecimiento de contactos y cuentas — empareja y enriquece personas y organizaciones, individualmente o en lote.
Flujos de trabajo de secuencias de divulgación — encuentra secuencias y agrega o elimina/detiene contactos en una secuencia.
Analíticas de ventas — consulta métricas de correo electrónico, llamadas, reuniones, tareas, oportunidades, secuencias e inteligencia de conversaciones, y devuelve desgloses formateados.
Gestión de contactos — crea contactos de Apollo como parte de los flujos de trabajo de enriquecimiento y carga en secuencias.

El servidor remoto puede exponer herramientas adicionales más allá de las ejercitadas por las habilidades incluidas. La lista anterior refleja lo confirmado en este repositorio. Consulta Herramientas y capacidades disponibles.

Requisitos previos

Una cuenta de Apollo.io. Inicia sesión en https://www.apollo.io/.
Permisos y créditos de Apollo.io. Las acciones se ejecutan con los permisos de tu cuenta, y algunas acciones consumen créditos de Apollo (por ejemplo, el enriquecimiento). Consulta Seguridad y uso responsable. Para conocer los detalles de planes, créditos y permisos, consulta la documentación de Apollo.
Un cliente compatible con MCP que admita el transporte HTTP de transmisión (Streamable HTTP), como:
- GitHub Copilot en Visual Studio Code
- Cursor
- Claude Code
- Claude Desktop / Claude Cowork
- Otros clientes MCP (consulta Configuración genérica de cliente MCP)
No se requiere un entorno de ejecución local. El servidor es remoto y está alojado por Apollo.io: no necesitas Node.js, Docker ni una instalación local para usarlo. (El complemento opcional de Claude Code / Cowork instala habilidades de flujo de trabajo localmente a través del sistema de complementos de tu cliente, pero el servidor MCP en sí permanece remoto.)

Instalación en Visual Studio Code y GitHub Copilot

El servidor MCP de Apollo.io está publicado en el registro oficial del Model Context Protocol, pero aún no se puede descubrir en el registro de MCP curado de GitHub ni en la galería de MCP de VS Code. Hasta entonces, agrégalo manualmente con la configuración siguiente.

Opción A — archivo de configuración del espacio de trabajo

Crea un archivo .vscode/mcp.json en tu espacio de trabajo:

{
  "servers": {
    "apollo": {
      "type": "http",
      "url": "https://mcp.apollo.io/mcp"
    }
  }
}

Opción B — paleta de comandos

Abre la paleta de comandos (Cmd/Ctrl + Shift + P).
Ejecuta MCP: Add Server.
Elige el tipo de servidor HTTP (Streamable HTTP) cuando se te solicite.
Introduce la URL https://mcp.apollo.io/mcp y nombra el servidor apollo.

Autenticación esperada y primer uso

Agrega el servidor MCP usando cualquiera de las opciones anteriores.
Inicia o habilita el servidor apollo.
Completa la autenticación de Apollo.io en la ventana del navegador que se abre.
Aprueba el acceso solicitado para tu espacio de trabajo de Apollo.io.
Abre Copilot Chat en modo Agent.
Confirma que las herramientas de Apollo aparecen listadas y están disponibles para el agente.

Para conocer la terminología y el comportamiento actuales, consulta la documentación de VS Code sobre servidores MCP: https://code.visualstudio.com/docs/copilot/chat/mcp-servers.

Instalación en Cursor

Agrega el endpoint remoto de HTTP de transmisión (Streamable HTTP) a tu configuración MCP de Cursor (por ejemplo, ~/.cursor/mcp.json, o el archivo .cursor/mcp.json a nivel de proyecto):

{
  "mcpServers": {
    "apollo": {
      "type": "http",
      "url": "https://mcp.apollo.io/mcp"
    }
  }
}

Luego:

Abre la configuración de Cursor y confirma que el servidor apollo aparece listado bajo MCP.
Autentícate con tu cuenta de Apollo.io cuando se te solicite.
Aprueba el acceso solicitado y luego usa las herramientas de Apollo desde el agente.

Este repositorio también incluye un manifiesto de complemento para Cursor (.cursor-plugin/plugin.json) que hace referencia al mismo endpoint remoto (.mcp.json), por lo que no es necesario ejecutar ningún paquete local.

Instalación en Claude Code

Puedes conectar el servidor de dos maneras.

Opción A — agregar el servidor MCP remoto directamente

claude mcp add --transport http apollo https://mcp.apollo.io/mcp

Luego ejecuta /mcp dentro de Claude Code, selecciona apollo y autentícate.

Opción B — instalar el complemento de Apollo (agrega habilidades de flujo de trabajo `/apollo:*`)

Agrega el marketplace de este complemento:

/plugin marketplace add apolloio/apollo-mcp-plugin

Instala el complemento:

/plugin install apollo@apollo-plugin-marketplace

Reinicia Claude Code para que el servidor MCP se inicie correctamente.

El complemento configura automáticamente el servidor MCP de Apollo: no se necesitan archivos de configuración manuales. Después de instalar, autentícate con /mcp y ejecuta los comandos /apollo:* (consulta Herramientas y capacidades disponibles).

Instalación en Claude Desktop o Claude Cowork

Claude Desktop y Claude Cowork son independientes de Claude Code (la CLI). Usa los pasos siguientes para los clientes de escritorio.

Cowork (instalación en un clic)

Haz clic para instalar en un solo paso:

Instalar en Cowork

Luego reinicia Cowork para que el servidor MCP se inicie correctamente.

Claude Desktop

Agrega el conector de Apollo desde la configuración de Claude y luego autentícate:

Abre Configuración y conecta el conector de Apollo.io (Apollo aparece como un servidor MCP remoto).
Completa la autenticación de Apollo.io en tu navegador.
Aprueba el acceso solicitado.
Confirma que las herramientas de Apollo están disponibles en un chat nuevo.

Las etiquetas de menú y la navegación exactas varían según la versión de Claude Desktop. Consulta la documentación de Anthropic para conocer los pasos actuales para agregar un conector MCP remoto.

Configuración genérica de cliente MCP

Para cualquier otro cliente compatible con MCP que admita HTTP de transmisión (Streamable HTTP):

{
  "name": "apollo",
  "type": "streamable-http",
  "url": "https://mcp.apollo.io/mcp"
}

Los nombres de propiedades exactos varían entre clientes. Algunos clientes usan type: "http" (como en los ejemplos de VS Code y Cursor anteriores) y otros usan type: "streamable-http". Consulta la documentación MCP de tu cliente para conocer el esquema preciso.

Autenticación y autorización

El servidor MCP de Apollo usa OAuth de Apollo.io. Aquí solo se documenta el comportamiento confirmado.

Flujo de inicio de sesión. Cuando conectas el servidor, tu cliente abre una ventana de inicio de sesión y autorización de Apollo.io. Después de aprobar el acceso, tu cliente puede llamar a las herramientas de Apollo en tu nombre.
Espacio de trabajo y permisos. El servidor actúa con los permisos de Apollo.io del usuario autenticado. Solo puedes acceder a los datos y realizar las acciones que tu cuenta de Apollo.io te permita.
Reconexión. En Claude Code puedes volver a ejecutar /mcp, seleccionar apollo y volver a autenticarte. En otros clientes, vuelve a activar la autenticación desde la configuración de MCP o de conectores del cliente.
Revocación del acceso. Elimina o desconecta el servidor apollo de tu cliente MCP para evitar que actúe en tu nombre. Para gestionar las autorizaciones a nivel de cuenta, usa la configuración de tu cuenta de Apollo.io.

Los metadatos del servidor de autorización OAuth se pueden descubrir en https://mcp.apollo.io/.well-known/oauth-authorization-server. Más allá de eso, este README no afirma una especificación o perfil OAuth específico.

Ejemplos de uso

Indicaciones en lenguaje natural que puedes probar una vez que el servidor esté conectado:

Find software engineering leaders at B2B SaaS companies in Germany with 200–1,000 employees.

Enrich these business contacts and return their current title, company, and verified business email when available.

Show email and call performance by rep for this quarter, sorted by calls made.

Add the selected contacts to my Apollo sequence "Q1 Enterprise Outbound" — show a preview before enrolling.

Si instalaste el complemento de Claude Code / Cowork, los mismos flujos de trabajo están disponibles como comandos de barra:

/apollo:prospect VP of Engineering at Series B+ SaaS companies in the US, 200-1000 employees
/apollo:enrich-lead https://www.linkedin.com/in/example
/apollo:sequence-load add 20 VP Sales at SaaS companies to my "Q1 Outbound" sequence
/apollo:analytics Show me team call connect rate this quarter by rep

Revisa antes de actuar. Para acciones con consecuencias — el enriquecimiento (consumo de créditos) y la adición de contactos a una secuencia (potencialmente saliente) — revisa los destinatarios y parámetros exactos antes de confirmar la operación.

Herramientas y capacidades disponibles

El servidor remoto proporciona las herramientas subyacentes de Apollo; las herramientas listadas a continuación son las confirmadas en este repositorio a través de las habilidades de flujo de trabajo incluidas. El conjunto de herramientas completo y autoritativo lo proporciona el servidor remoto y puede evolucionar de forma independiente a este documento.

Habilidades de flujo de trabajo (complemento de Claude Code / Cowork)

Habilidades de alto valor que encadenan múltiples herramientas de Apollo en flujos de trabajo completos:

Habilidad	Qué hace
`/apollo:enrich-lead`	Introduce un nombre, una URL de LinkedIn o un correo electrónico y obtén una tarjeta de contacto completa con contexto de la empresa y próximas acciones.
`/apollo:prospect`	Describe tu ICP en inglés sencillo y obtén una tabla clasificada de tomadores de decisiones enriquecidos.
`/apollo:sequence-load`	Encuentra contactos, enriquécelos, elimina duplicados y agrégualos en lote a una secuencia de Apollo con una vista previa antes de la inscripción.
`/apollo:analytics`	Haz cualquier pregunta sobre rendimiento de ventas y obtén tablas formateadas a partir de datos reales de analíticas de Apollo.

Herramientas subyacentes de Apollo a las que hacen referencia las habilidades

Herramienta	Descripción	Efecto en datos	Acción externa / outreach
`apollo_mixed_people_api_search`	Busca en la base de datos de personas de Apollo por cargo, antigüedad, ubicación y filtros de empresa.	Lectura	No
`apollo_mixed_companies_search`	Busca en la base de datos de organizaciones de Apollo por industria, tamaño, ubicación y palabras clave.	Lectura	No
`apollo_people_match`	Hace match y enriquece a una persona individual a partir de los identificadores disponibles.	Lectura / enriquece	No
`apollo_people_bulk_match`	Hace match y enriquece a varias personas en una sola llamada.	Lectura / enriquece	No
`apollo_organizations_enrich`	Enriquece una organización individual.	Lectura / enriquece	No
`apollo_organizations_bulk_enrich`	Enriquece varias organizaciones en una sola llamada.	Lectura / enriquece	No
`apollo_contacts_create`	Crea un contacto en el espacio de trabajo de Apollo.	Modifica datos de Apollo	No
`apollo_emailer_campaigns_search`	Busca secuencias de outreach por nombre.	Lectura	No
`apollo_emailer_campaigns_add_contact_ids`	Añade contactos a una secuencia de outreach.	Modifica datos de Apollo	Sí: puede iniciar envíos salientes según la configuración de la secuencia.
`apollo_emailer_campaigns_remove_or_stop_contact_ids`	Elimina o detiene contactos en una secuencia de outreach.	Modifica datos de Apollo	Afecta al outreach activo
`apollo_email_accounts_index`	Lista las cuentas de correo/envío conectadas.	Lectura	No
`apollo_analytics_sync_report`	Obtiene métricas y desgloses de analítica de ventas.	Lectura	No

Algunas acciones (como el enriquecimiento) consumen créditos de Apollo. Para conocer los costes de crédito por herramienta y la referencia de herramientas autoritativa y actualizada, consulta la documentación de Apollo.

Recomendaciones de modelos

Para clientes en los que puedas elegir un modelo (por ejemplo, Claude Code mediante /model):

Opus (mejor calidad) — el razonamiento más sólido y la orquestación multi-paso de herramientas más fiable. La mejor opción para flujos de prospección, coincidencias ambiguas, encadenamientos multi-paso y tareas de alto riesgo. Contrapartida: mayor latencia y coste de uso.
Sonnet (más rápido) — adecuado para consultas rápidas, enriquecimiento ligero e iteración rápida. Contrapartida: puede necesitar más orientación en flujos multi-paso complejos.

Seguridad y uso responsable

Revisa los resultados de prospección antes de usarlos o exportarlos.
Cumple con las leyes aplicables de privacidad, marketing, anti-spam y protección de datos en tu jurisdicción y en la de tus destinatarios.
Confirma a los destinatarios antes de añadir a alguien a una secuencia de outreach. Según tu secuencia y tu configuración de envío, la inscripción puede iniciar envíos salientes automáticamente. Verifica siempre el nombre de la secuencia, la cuenta de envío y el volumen de inscripción antes de confirmar.
Ten en cuenta el consumo de créditos de Apollo. Algunas acciones (como el enriquecimiento) consumen créditos de Apollo, y las acciones masivas escalan con el volumen. Las skills de este repositorio están diseñadas para advertir y solicitar confirmación antes de acciones que consumen créditos. Para conocer los costes de crédito, consulta la documentación de Apollo.
Evita acciones masivas o destructivas sin revisar primero su alcance exacto.
Respeta los permisos de la cuenta de Apollo y las políticas de tu organización.

Esta sección es orientación, no asesoramiento legal.

Privacidad y manejo de datos

Las solicitudes se envían al endpoint MCP alojado por Apollo (https://mcp.apollo.io/mcp).
El servidor interactúa con los datos de Apollo bajo tu cuenta autenticada y tus permisos.
Evita enviar información sensible innecesaria en los prompts.

Para los recursos oficiales de privacidad y seguridad de Apollo.io:

Política de privacidad: https://www.apollo.io/privacy-policy
Centro de privacidad: https://www.apollo.io/company/privacy-center
Seguridad: https://www.apollo.io/product/security
Centro de confianza: https://trust.apollo.io/

Solución de problemas

Síntoma	Qué comprobar
La ventana de autenticación no se abre	Asegúrate de que las ventanas emergentes estén permitidas; vuelve a activar la autenticación desde la configuración de MCP/conector de tu cliente.
La sesión de autenticación ha caducado	Vuelve a autenticarte (en Claude Code, ejecuta `/mcp` → apollo → authenticate).
El servidor no se inicia	Reinicia el cliente después de añadirlo/instalarlo; confirma que la URL del endpoint sea exactamente `https://mcp.apollo.io/mcp`.
Las herramientas no aparecen	Confirma que el servidor esté habilitado y autenticado y (para Copilot) que el chat esté en modo Agent.
"Permission denied" en una acción	Tu cuenta de Apollo.io puede carecer del permiso necesario para esa acción.
Créditos no disponibles	El enriquecimiento y algunas acciones requieren créditos de Apollo; confirma que tu espacio de trabajo tenga créditos disponibles.
El cliente no es compatible con Streamable HTTP	Usa un cliente que admita el transporte Streamable HTTP o la configuración genérica en Generic MCP Client Configuration.
JSON no válido en la configuración	Valida tu configuración de `mcp.json` / cliente con un linter de JSON: una coma final o una llave faltante impedirán que el servidor se cargue.
El proxy corporativo o el firewall bloquean el endpoint	Asegúrate de que `https://mcp.apollo.io` sea accesible a través de tu red/lista de permitidos del proxy.

Registro oficial de MCP

Este servidor está publicado y activo en el Model Context Protocol Registry oficial.

Campo	Valor
Nombre en el registro	`io.github.apolloio/apollo-mcp`
Versión	`0.1.1`
Transporte	Streamable HTTP
Endpoint	`https://mcp.apollo.io/mcp`

La publicación en el Model Context Protocol Registry oficial es independiente del registro curado de MCP de GitHub y de la galería de MCP de VS Code. Que el servidor esté activo en el registro oficial no significa automáticamente que sea detectable en esos catálogos curados.

Desarrollo y contribuciones

Este repositorio contiene la configuración del cliente MCP de Apollo, los manifiestos de plugins para Claude/Cursor, las skills de flujos de trabajo y los metadatos del registro. El servidor MCP en sí está alojado por Apollo.io.

Estructura del repositorio:

Ruta	Propósito
`.mcp.json`	Definición del servidor MCP remoto (`apollo` → `https://mcp.apollo.io/mcp`).
`server.json`	Metadatos del registro oficial de MCP (nombre, versión, transporte, endpoint).
`.claude-plugin/`	Manifiestos de plugins y marketplace de Claude Code / Cowork.
`.cursor-plugin/`	Manifiesto del plugin de Cursor.
`glama.json`	Metadatos del directorio de MCP de Glama.
`skills/`	Skills de flujos de trabajo: `prospect`, `enrich-lead`, `sequence-load`, `analytics`.
`.github/workflows/publish-mcp.yml`	CI que publica `server.json` en el Registro de MCP.

Validación de `server.json`

server.json sigue el esquema de servidor MCP referenciado al inicio del archivo. La publicación está automatizada por el flujo de CI (ver más abajo), que descarga la mcp-publisher oficial y ejecuta mcp-publisher publish.

No existe un comando independiente de validate. Para comprobar server.json localmente antes de enviar cambios, ejecuta una publicación dry-run con la CLI oficial:

mcp-publisher publish --dry-run

Las contribuciones son bienvenidas mediante pull requests. Mantén los metadatos de versión coherentes entre server.json, .claude-plugin/plugin.json y .cursor-plugin/plugin.json.

Versiones y lanzamientos

La versión del servidor se declara en server.json (version: 0.1.1) y se refleja en los manifiestos de plugins (.claude-plugin/plugin.json, .cursor-plugin/plugin.json).
En cada push a main que modifique server.json, el flujo de trabajo publish-mcp.yml publica la nueva versión en el Model Context Protocol Registry oficial (autenticándose mediante GitHub OIDC).
Mantén la versión en server.json y en los manifiestos de plugins alineada antes de publicar, para que el repositorio y el registro permanezcan sincronizados.
Los lanzamientos se impulsan por cambios en server.json en main: el repositorio no crea GitHub Releases ni etiquetas de versión por cada versión.

Seguridad

Por favor, no reportes vulnerabilidades de seguridad a través de issues públicos de GitHub.

Reporta posibles vulnerabilidades de forma privada a través del Apollo Trust Center. Consulta SECURITY.md para conocer el proceso completo de divulgación y su alcance.

Soporte

Necesidad	Dónde acudir
Soporte del producto Apollo (datos, créditos, cuenta, facturación)	Apollo Knowledge Base o contacta con el soporte de Apollo
Documentación del producto Apollo	docs.apollo.io
Errores de integración MCP (este repositorio)	Abre un issue de GitHub en apolloio/apollo-mcp-plugin
Solicitudes de funciones	Abre un issue de GitHub en apolloio/apollo-mcp-plugin
Vulnerabilidades de seguridad	No abras un issue público: consulta Security

Créditos

Servidor MCP por Apollo.io
Especificación del plugin por Anthropic