Referencia de herramientas MCP

Referencia de todas las herramientas que expone el servidor MCP de graph8. Para la configuración y los modos (dev / gtm / all), consulte la página del Servidor MCP.

Número de herramientas por modo:

Modo	Cantidad	Incluye
`dev`	17	Repositorio, instalación, escaneo, formularios, KB, campañas
`gtm`	23	Campañas de Studio, KB, ICPs, personas, contexto global
`all`	35+	Todas las herramientas que se listan a continuación (predeterminado para OAuth remoto)

Todas las herramientas aceptan argumentos JSON y devuelven una cadena codificada en JSON en la respuesta MCP. Las herramientas marcadas como destructivas crean registros reales, envían mensajes reales, consumen créditos o varias de estas acciones a la vez. Confirme con el usuario antes de invocarlas.

Contactos

`g8_search_contacts`

Busca contactos que ya están en su base de datos CRM. Solo lectura. Use esta herramienta para encontrar personas que ya conoce. Para prospectar nuevos leads, use g8_find_contacts.

Parámetros

Nombre	Tipo	Requerido	Descripción
`email`	string	no	Coincidencia exacta con el correo de trabajo
`list_id`	string	no	Filtrar por ID de lista de contactos
`name`	string	no	Coincidencia parcial en nombre o apellido
`job_title`	string	no	Coincidencia parcial en cargo
`seniority_level`	string	no	Coincidencia exacta (p. ej. `C-Suite`, `VP`, `Director`, `Manager`)
`company_name`	string	no	Coincidencia parcial en nombre de empresa
`country`	string	no	Coincidencia exacta en país
`page`	integer	no	Número de página, predeterminado `1`
`limit`	integer	no	Elementos por página, predeterminado `50`, máx. `200`

Responde: GET /contacts. Devuelve una lista paginada de registros de contactos.

Ejemplo

{
  "seniority_level": "VP",
  "company_name": "acme",
  "country": "US",
  "limit": 25
}

`g8_find_contacts`

Busca prospectos que aún no tiene en su CRM dentro del índice de datos abiertos de graph8 (más de 300M de registros). Solo lectura, pero se cobran créditos por cada registro devuelto.

Parámetros

Nombre	Tipo	Requerido	Descripción
`filters`	array of objects	sí	Cada filtro es `{field, operator, value}`
`page`	integer	no	Predeterminado `1`
`limit`	integer	no	Predeterminado `25`, máx. `200`

Campos de filtro disponibles: first_name, last_name, work_email, job_title, seniority_level, job_department, role, linkedin_url, city, state, country, company_name, company_domain, company_industry, company_employee_count, company_revenue, company_founded_year.

Operadores: any_of, contains, all_of, none_of, is_empty, is_not_empty, between, exists.

Responde: POST /search/contacts.

Ejemplo

{
  "filters": [
    {"field": "seniority_level", "operator": "any_of", "value": ["VP", "Director"]},
    {"field": "company_industry", "operator": "contains", "value": ["SaaS"]},
    {"field": "company_employee_count", "operator": "between", "value": [50, 500]}
  ],
  "limit": 50
}

`g8_create_contact`

Crea un contacto en su CRM. Use esta herramienta después de g8_lookup_person para persistir un prospecto, o para agregar un contacto manualmente. Devuelve el nuevo contact_id (necesario para g8_add_to_sequence y g8_add_to_list).

Parámetros

Nombre	Tipo	Requerido	Descripción
`work_email`	string	sí	Dirección de correo de trabajo
`first_name`	string	no	Nombre
`last_name`	string	no	Apellido
`job_title`	string	no	Cargo
`company_domain`	string	no	Dominio de la empresa (p. ej. `acme.com`)
`linkedin_url`	string	no	URL del perfil de LinkedIn
`direct_phone`	string	no	Teléfono directo
`mobile_phone`	string	no	Teléfono móvil
`seniority_level`	string	no	Nivel jerárquico (p. ej. `VP`)
`city`	string	no	Ciudad
`state`	string	no	Estado o provincia
`country`	string	no	País
`list_id`	integer	no	Agregar opcionalmente a esta lista de inmediato

Responde: POST /contacts. Devuelve el registro del contacto, incluido contact_id.

`g8_enrich_contacts`

Enriquece contactos existentes del CRM con datos de terceros mediante el sistema de cascada multiproveedor de graph8. Se ejecuta de forma asíncrona y devuelve un job_id. Se cobran créditos por contacto.

Parámetros

Nombre	Tipo	Requerido	Descripción
`contact_ids`	array of integers	sí	IDs de contactos del CRM a enriquecer
`list_id`	integer	sí	Lista a la que pertenecen los contactos (requerida para el seguimiento de trabajos)

Responde: POST /enrichment/enrich.

Empresas

`g8_search_companies`

Busca empresas que ya están en su CRM. Solo lectura. Para nuevos prospectos, use g8_find_companies.

Parámetros

Nombre	Tipo	Requerido	Descripción
`domain`	string	no	Filtrar por dominio de empresa
`industry`	string	no	Filtrar por industria
`name`	string	no	Coincidencia parcial en nombre
`page`	integer	no	Predeterminado `1`
`limit`	integer	no	Predeterminado `50`, máx. `200`

Responde: GET /companies.

`g8_find_companies`

Busca empresas que aún no rastrea dentro del índice de datos abiertos de graph8. Solo lectura, se cobran créditos por cada registro devuelto.

Parámetros

Nombre	Tipo	Requerido	Descripción
`filters`	array of objects	sí	Filtros `{field, operator, value}`
`page`	integer	no	Predeterminado `1`
`limit`	integer	no	Predeterminado `25`, máx. `200`

Campos de filtro: name, domain, industry, industry_group, employee_count, revenue, founded_year, country, state, city, linkedin_followers.

Operadores: el mismo conjunto que g8_find_contacts.

Responde: POST /search/companies.

Enriquecimiento y búsqueda

`g8_lookup_person`

Busca a una sola persona en el índice de datos de graph8. Devuelve datos enriquecidos (correo verificado, teléfono, cargo, empresa, puntuación de confianza). Cuesta 1 crédito.

Proporcione al menos uno de los siguientes: email, linkedin_url o (first_name + last_name + company_domain).

Parámetros

Nombre	Tipo	Requerido	Descripción
`email`	string	condicional	Correo de la persona
`linkedin_url`	string	condicional	URL del perfil de LinkedIn
`first_name`	string	condicional	Combinar con `last_name` y `company_domain`
`last_name`	string	condicional
`company_domain`	string	condicional	p. ej. `acme.com`

Responde: POST /enrichment/lookup/person.

`g8_lookup_company`

Busca una sola empresa. Devuelve ingresos, número de empleados, industria, conjunto tecnológico, financiamiento y puntuación de confianza. Cuesta 1 crédito.

Proporcione al menos uno de los siguientes: domain o name.

Parámetros

Nombre	Tipo	Requerido	Descripción
`domain`	string	condicional	Dominio de la empresa
`name`	string	condicional	Nombre de la empresa

Responde: POST /enrichment/lookup/company.

Listas

`g8_get_lists`

Lista las listas de contactos y empresas en su CRM. Solo lectura.

Parámetros

Nombre	Tipo	Requerido	Descripción
`page`	integer	no	Predeterminado `1`
`limit`	integer	no	Predeterminado `50`

Responde: GET /lists.

`g8_create_list`

Crea una nueva lista vacía de contactos o empresas. Devuelve el list_id.

Parámetros

Nombre	Tipo	Requerido	Descripción
`title`	string	sí	Nombre de la lista (p. ej. `"Enterprise Q2 Targets"`)
`type`	string	no	`"contacts"` o `"companies"` (predeterminado `"contacts"`)

Responde: POST /lists.

`g8_add_to_list`

Agrega contactos existentes (que ya deben tener contact_id) a una lista.

Parámetros

Nombre	Tipo	Requerido	Descripción
`list_id`	integer	sí	Lista de destino
`contact_ids`	array of integers	sí	IDs de contactos a agregar

Responde: POST /lists/{list_id}/contacts.

`g8_build_contact_list`

Busca prospectos y guarda los resultados coincidentes en una nueva lista en una sola llamada. Se cobran créditos por cada contacto guardado, así que confirme siempre los filtros y max_results antes de proceder.

Parámetros

Nombre	Tipo	Requerido	Descripción
`filters`	array of objects	sí	Mismo formato de filtro que `g8_find_contacts`
`list_title`	string	sí	Nombre para la nueva lista
`max_results`	integer	no	Límite máximo de contactos guardados (predeterminado `100`)

Responde: POST /search/contacts/save.

Pipeline y CRM

`g8_get_deals`

Lista las oportunidades en su CRM con filtros opcionales. Solo lectura.

Parámetros

Nombre	Tipo	Requerido	Descripción
`page`	integer	no	Predeterminado `1`
`limit`	integer	no	Predeterminado `50`
`stage_id`	string	no	Filtrar por etapa
`pipeline_id`	string	no	Filtrar por pipeline
`search`	string	no	Búsqueda de texto libre

Responde: GET /deals.

`g8_get_deal`

Obtiene los detalles de una sola oportunidad. Solo lectura.

Parámetros

Nombre	Tipo	Requerido	Descripción
`deal_id`	string	sí	ID de la oportunidad

Responde: GET /deals/{deal_id}.

`g8_get_pipeline`

Lista los pipelines de oportunidades y sus etapas. Solo lectura. Sin parámetros.

Responde: GET /deals/pipelines.

Tareas

`g8_get_tasks`

Lista las tareas de la organización actual. Solo lectura.

Parámetros

Nombre	Tipo	Requerido	Descripción
`status`	string	no	Filtrar por estado
`priority`	integer	no	Filtrar por prioridad
`assignee_id`	string	no	Filtrar por responsable
`search`	string	no	Búsqueda de texto libre

Responde: GET /tasks.

`g8_create_task`

Crea una tarea vinculada a un contacto del CRM.

Parámetros

Nombre	Tipo	Requerido	Descripción
`contact_id`	integer	sí	Contacto al que pertenece la tarea
`title`	string	sí	Título de la tarea
`description`	string	no	Descripción de la tarea
`due_date`	string	no	Cadena de fecha ISO 8601
`assignee_id`	string	no	ID de usuario del responsable
`priority`	integer	no	Valor de prioridad

Responde: POST /contacts/{contact_id}/tasks.

Actividad y notas

`g8_get_activities`

Lista las actividades recientes del CRM para la organización actual. Solo lectura.

Parámetros

Nombre	Tipo	Requerido	Descripción
`limit`	integer	no	Predeterminado `50`
`activity_type`	string	no	Filtrar por tipo de actividad
`contact_id`	string	no	Filtrar por contacto
`company_id`	string	no	Filtrar por empresa
`deal_id`	string	no	Filtrar por oportunidad

Responde: GET /activities.

`g8_create_note`

Agrega una nota a un contacto del CRM.

Parámetros

Nombre	Tipo	Requerido	Descripción
`contact_id`	integer	sí	Contacto al que se adjunta la nota
`content`	string	sí	Cuerpo de la nota

Responde: POST /contacts/{contact_id}/notes.

Secuencias

`g8_list_sequences`

Lista las secuencias outbound disponibles. Solo lectura. Use esta herramienta para encontrar un sequence_id antes de llamar a g8_add_to_sequence.

Parámetros

Nombre	Tipo	Requerido	Descripción
`page`	integer	no	Predeterminado `1`
`limit`	integer	no	Predeterminado `50`

Responde: GET /sequences.

`g8_create_sequence`

Crea una nueva secuencia outbound (en borrador). Opcionalmente incluye steps y channels.

Parámetros

Nombre	Tipo	Requerido	Descripción
`name`	string	sí	Nombre de la secuencia
`user_email`	string	sí	Correo del propietario
`description`	string	no	Descripción
`finish_on_reply`	boolean	no	Predeterminado `true`
`send_in_same_thread`	boolean	no	Predeterminado `false`
`steps`	array of objects	no	Cada paso: `{step_order, step_type, input_type, time_interval, step_data}`
`channels`	array of objects	no	Cada canal: `{channel_id, channel_value, channel_type}`
`campaign_id`	string	no	Campaña de AI Studio a vincular

Responde: POST /sequences.

`g8_get_sequence_preview`

Previsualiza una secuencia con sus pasos y canales. Solo lectura, sin inscripción de contactos.

Parámetros

Nombre	Tipo	Requerido	Descripción
`sequence_id`	string	sí	ID de la secuencia

Responde: GET /sequences/{sequence_id}/preview.

`g8_update_sequence`

Actualiza los metadatos de una secuencia. No se puede modificar mientras esté en un estado transitorio.

Parámetros

Nombre	Tipo	Requerido	Descripción
`sequence_id`	string	sí	Secuencia a actualizar
`name`	string	no	Nuevo nombre
`description`	string	no	Nueva descripción
`is_shared`	boolean	no	Indicador de compartido
`finish_on_reply`	boolean	no
`send_in_same_thread`	boolean	no
`wait_for_new_contacts`	boolean	no

Responde: PATCH /sequences/{sequence_id}.

`g8_update_sequence_step`

Actualiza un solo paso en una secuencia.

Parámetros

Nombre	Tipo	Requerido	Descripción
`sequence_id`	string	sí	Secuencia padre
`step_id`	string	sí	Paso a actualizar
`step_data`	object	no	Datos de plantilla o contenido
`time_interval`	integer	no	Retraso (en segundos) después del paso anterior
`step_type`	string	no	`EMAIL`, `PHONE`, `SMS`, etc.
`input_type`	string	no	`ON_DEMAND` o `TEMPLATE`

Responde: PATCH /sequences/{sequence_id}/steps/{step_id}.

`g8_add_to_sequence`

Inscribe contactos en una secuencia outbound.

Parámetros

Nombre	Tipo	Requerido	Descripción
`sequence_id`	string	sí	Obtenido de `g8_list_sequences`
`contact_ids`	array of integers	sí	IDs de contactos del CRM
`list_id`	integer	sí	Lista a la que pertenecen los contactos

Responde: POST /sequences/{sequence_id}/contacts.

`g8_pause_sequence`

Pausa una secuencia activa. Los contactos en curso completan su flujo de forma gradual.

Parámetros

Nombre	Tipo	Requerido	Descripción
`sequence_id`	string	sí	Secuencia a pausar

Responde: POST /sequences/{sequence_id}/pause.

`g8_resume_sequence`

Reanuda una secuencia pausada.

Parámetros

Nombre	Tipo	Requerido	Descripción
`sequence_id`	string	sí	Secuencia a reanudar

Responde: POST /sequences/{sequence_id}/resume.

`g8_get_sequence_analytics`

Obtiene el resumen general, el rendimiento, la interacción, la línea de tiempo y la distribución de contactos de una secuencia. Solo lectura.

Parámetros

Nombre	Tipo	Requerido	Descripción
`sequence_id`	string	sí	ID de la secuencia

Responde: GET /sequences/{sequence_id}/analytics.

`g8_delete_sequence`

Archiva una secuencia mediante eliminación lógica. Establece is_archived=true. Queda oculta en la interfaz y excluida del procesamiento de trabajos.

Parámetros

Nombre	Tipo	Requerido	Descripción
`sequence_id`	string	sí	Secuencia a archivar

Responde: DELETE /sequences/{sequence_id}.

Bandeja de entrada

Bandeja de entrada multicanal que cubre correo electrónico, SMS y LinkedIn. Cada herramienta acepta un channel opcional (email / sms / linkedin, predeterminado email).

`g8_list_inbox`

Lista los hilos de la bandeja de entrada en todos los canales. Solo lectura.

Parámetros

Nombre	Tipo	Requerido	Descripción
`channel`	string	no	`email`, `sms`, `linkedin`, u omitir para todos
`sequence_id`	string	no	Filtrar por secuencia o campaña
`status`	string	no	Filtrar por estado
`assignee`	string	no	Correo del responsable
`tag`	string	no	ID de etiqueta
`page`	integer	no	Predeterminado `1`
`page_size`	integer	no	Predeterminado `50`, máx. `200`

Responde: GET /inbox.

`g8_get_reply`

Obtiene un solo hilo de la bandeja de entrada con el historial completo de mensajes. Solo lectura.

Parámetros

Nombre	Tipo	Requerido	Descripción
`reply_id`	string	sí	ID del hilo o respuesta
`channel`	string	no	Predeterminado `"email"`

Responde: GET /inbox/{reply_id}.

`g8_assign_reply`

Asigna un usuario a un hilo de la bandeja de entrada.

Parámetros

Nombre	Tipo	Requerido	Descripción
`reply_id`	string	sí	ID del hilo o respuesta
`assignee_email`	string	sí	Usuario a asignar
`channel`	string	no	Predeterminado `"email"`

Responde: POST /inbox/{reply_id}/assign.

`g8_tag_reply`

Adjunta etiquetas a un hilo de la bandeja de entrada.

Parámetros

Nombre	Tipo	Requerido	Descripción
`reply_id`	string	sí	ID del hilo o respuesta
`tag_ids`	array of strings	sí	IDs de etiquetas
`channel`	string	no	Predeterminado `"email"`

Responde: POST /inbox/{reply_id}/tag.

`g8_get_reply_draft`

Genera un borrador de respuesta con IA para un hilo. Consume créditos. Devuelve HTTP 402 si la organización no tiene créditos suficientes.

Parámetros

Nombre	Tipo	Requerido	Descripción
`reply_id`	string	sí	ID del hilo o respuesta
§INLIN