Referencia de herramientas MCP

Por qué es importante

Cuando un asistente de IA se conecta a tu cuenta de Kit, obtiene acceso a un conjunto de herramientas. Cada herramienta hace una sola cosa: listar tus ofertas de empleo, obtener detalles de una plantilla, invitar a un miembro del equipo. Esta página documenta cada herramienta para que sepas qué puede y qué no puede hacer tu asistente de IA.

Para empezar

Todo asistente de IA conectado ve esta instrucción primero:

Comienza con hiring_get_setup_guide para entender las capacidades de contratación de esta cuenta, las plantillas disponibles y el estado actual.

La herramienta guía devuelve las estadísticas de tu cuenta y los tipos de etapa disponibles, dándole contexto al asistente antes de que realice cualquier acción.

Herramientas de contratación

Configuración y plantillas

hiring_get_setup_guide

Devuelve una vista general de tu configuración de contratación: cantidad de plantillas, ofertas de empleo activas, total de candidatos y todos los tipos de etapa disponibles.

Parámetros: Ninguno

Devuelve: Nombre de la cuenta, estadísticas rápidas, descripciones de los tipos de etapa y próximos pasos sugeridos.

---

hiring_list_templates

Lista todas las plantillas de proceso de contratación disponibles para tu cuenta, tanto plantillas del sistema como las personalizadas que hayas creado.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
tag	string	No	Filtrar plantillas por tag
published_only	boolean	No	Solo plantillas publicadas (por defecto: true)

Devuelve: Array de plantillas con ID, nombre, tags, cantidad de etapas, tipos de etapa y cantidad de usos.

---

hiring_get_template

Devuelve los detalles completos de una plantilla específica, incluyendo cada etapa y su configuración.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
template_id	integer	Sí	ID de la plantilla obtenido de hiring_list_templates

Devuelve: Metadatos de la plantilla, etapas ordenadas con tipo y configuración, y plantillas de email asociadas.

---

hiring_create_process_template

Crea una plantilla de proceso de contratación con las etapas indicadas. Devuelve el nombre de la plantilla, la cantidad de etapas y la URL de edición.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
name	string	Sí	Nombre de la plantilla (p. ej. “Contratación Ingeniero de Software”)
stages	array	Sí	Array de objetos de etapa, cada uno con name (string), type (string), config opcional (object) y reviewers opcional (array de {email, role})
description	string	No	Descripción corta de esta plantilla
tags	array	No	Tags para categorización

Devuelve: ID de la plantilla, nombre, cantidad de etapas y URL de edición.

Requiere: Suscripción activa.

---

Ofertas de empleo

hiring_list_job_postings

Lista todas las ofertas de empleo con su estado y cantidad de candidaturas. Filtra por estado para acotar los resultados.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
status	string	No	draft, published, paused, closed o active

Devuelve: Array de ofertas con ID, título, departamento, ubicación, estado, cantidad de etapas, desglose de candidaturas (total/activas/rechazadas/retiradas) y URL pública si está publicada.

---

hiring_get_job_posting

Devuelve toda la información sobre una oferta de empleo específica: etapas con evaluadores asignados, miembros del equipo y estadísticas del pipeline.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
job_posting_id	integer	Sí	ID de la oferta obtenido de hiring_list_job_postings

Devuelve: Detalles completos de la oferta, etapas con nombres de evaluadores, miembros del equipo con roles y contadores del pipeline (total/activos/rechazados/retirados/con oferta).

---

hiring_create_job_posting

Crea una nueva oferta de empleo en estado borrador. Devuelve la URL de edición para que puedas revisarla y publicarla en el navegador.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
title	string	Sí	Título del puesto
description	string	Sí	Descripción del puesto en markdown (no incluyas el título)
department	string	No	Nombre del departamento
location	string	No	Ubicación del puesto
employment_type	string	No	full_time, part_time, contract o internship
remote	boolean	No	¿Puesto remoto?
process_template_id	integer	No	ID de la plantilla para aplicar las etapas de contratación
salary_min	integer	No	Salario mínimo
salary_max	integer	No	Salario máximo
salary_currency	string	No	Código de moneda (p. ej., USD, EUR)
salary_period	string	No	Periodo (p. ej., year, month)

Devuelve: ID de la nueva oferta, título, estado (siempre “draft”) y URL de edición.

Requiere: Suscripción activa.

Nota: Esta herramienta actualmente solo está disponible a través del chatbot de IA integrado, no desde clientes MCP externos.

---

Candidaturas y pipeline

hiring_list_applications

Lista las candidaturas enviadas con filtros opcionales por fecha, estado y oferta de empleo. Úsalo para ver nuevos candidatos, el desglose del pipeline por etapa o filtrar por rango de fechas.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
date_range	string	No	this_week, last_week, this_month, last_month, last_7_days o last_30_days
since	string	No	Fecha de inicio personalizada (ISO 8601, p. ej. 2025-01-01)
until	string	No	Fecha de fin personalizada (ISO 8601, p. ej. 2025-01-31)
status	string	No	active, rejected, withdrawn, offered o all (por defecto: all)
job_posting_id	integer	No	Filtrar por una oferta de empleo específica

Devuelve: Contadores por estado, desglose por oferta de empleo y etapa, y un array de candidaturas con nombre del candidato, email, título del puesto, etapa actual, estado y fecha de envío.

---

hiring_get_application_summary

Devuelve el contexto a nivel de candidatura para la evaluación inicial: información del candidato, etapa actual, historial completo de etapas con envíos, respuestas de formularios y valores de campos rápidos.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
application_id	integer	Sí	ID de candidatura obtenido de hiring_list_reviews o hiring_list_applications

Devuelve: Detalles del candidato, oferta de empleo, estado de la candidatura, etapa actual, historial cronológico de etapas con resúmenes de envíos, respuestas de formularios y valores de campos rápidos.

---

hiring_get_stage_details

Devuelve información detallada y específica del tipo de etapa para un progreso de etapa individual. Incluye detalles de oferta, programación de entrevista, estado del ejercicio de código, agregados de evaluaciones, información de grabación de video y datos enriquecidos de los envíos. Úsalo después de hiring_get_application_summary para profundizar en una etapa específica.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
stage_progress_id	integer	Sí	ID de progreso de etapa obtenido del historial de etapas de hiring_get_application_summary

Devuelve: Metadatos de la etapa con estado y tiempos, contexto del candidato y la oferta de empleo, todos los envíos, y campos específicos según el tipo de etapa: términos de oferta, detalles de entrevista, configuración del ejercicio de código, agregados de evaluaciones, configuración de grabación de video, preguntas del cuestionario o configuración del portafolio según el tipo de etapa.

---

hiring_advance_application

Avanza una candidatura a la siguiente etapa del pipeline de contratación, o a una etapa específica si se proporciona stage_id. Las notificaciones al candidato y al equipo se envían automáticamente.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
application_id	integer	Sí	La candidatura a avanzar
stage_id	integer	No	Avanzar a una etapa específica (salta las etapas intermedias). Si se omite, avanza a la siguiente etapa en orden.

Devuelve: ID de candidatura, nombre del candidato, etapa anterior, nombre y tipo de la nueva etapa.

Requiere: Scope mcp_write.

---

hiring_reject_application

Rechaza una candidatura. El candidato es notificado por email (sujeto a la configuración de retraso del email de rechazo de la cuenta). Confirma siempre con el usuario antes de rechazar.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
application_id	integer	Sí	La candidatura a rechazar
reason	string	No	Motivo interno del rechazo (no visible para el candidato)

Devuelve: ID de candidatura, nombre del candidato, título de la oferta de empleo, motivo y quién rechazó.

Requiere: Scope mcp_write.

---

Evaluaciones

hiring_list_reviews

Devuelve tu bandeja de evaluaciones en tres secciones: candidaturas que necesitan evaluación inicial, evaluaciones en tu cola y tus evaluaciones completadas.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
section	string	No	screening, my_queue o completed

Devuelve: Tres arrays (needs_screening, my_queue, completed_reviews) con nombres de candidatos, títulos de puestos, información de etapa y tiempos de espera. Incluye contadores por sección.

---

hiring_get_review_details

Devuelve todo lo que un evaluador necesita para evaluar a un candidato en una etapa específica: información del candidato, envíos, criterios de puntuación y otras evaluaciones (respetando las reglas de visibilidad de evaluación ciega).

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
stage_progress_id	integer	Sí	ID de progreso de etapa obtenido de hiring_list_reviews

Devuelve: Información del candidato, oferta de empleo, detalles de la etapa, todos los envíos (respuestas de formularios, código, archivos, video, etc.), criterios de puntuación con ponderaciones, progreso de la evaluación, tu evaluación si la hay, y otras evaluaciones (cuando sean visibles).

---

Pool de talento

hiring_list_talent_pool

Lista las entradas verificadas del pool de talento con resúmenes compactos de extracción de CV. Paginado a 25 entradas por página. Usa hiring_search_talent_pool para filtrar por habilidades o experiencia.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
page	integer	No	Número de página (por defecto: 1, 25 entradas por página)

Devuelve: Cantidad total, información de paginación y un array de entradas con email, fecha de verificación, resumen de extracción de CV y fecha de creación.

---

hiring_search_talent_pool

Busca en el pool de talento por habilidades, experiencia o email usando búsqueda semántica y textual. Devuelve extracciones detalladas de CV para las entradas coincidentes.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
query	string	Sí	Consulta de búsqueda (habilidades, palabras clave de experiencia o email)
limit	integer	No	Máximo de resultados (por defecto: 10, máx: 25)

Devuelve: Entradas coincidentes con email, fecha de verificación, extracción detallada de CV y fecha de creación.

---

hiring_invite_talent_pool

Invita a un candidato del pool de talento a postularse a una oferta de empleo específica. Envía un email con un enlace de candidatura prellenado.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
talent_pool_entry_id	integer	Sí	ID de la entrada del pool de talento obtenido de hiring_list_talent_pool o hiring_search_talent_pool
job_posting_id	integer	Sí	ID de la oferta de empleo obtenido de hiring_list_job_postings

Devuelve: ID de la invitación, email del candidato, título del puesto, quién invitó y URL de la invitación.

Requiere: Scope mcp_write.

---

Video

hiring_search_video_transcripts

Busca en las transcripciones de entrevistas en video por palabras clave usando búsqueda semántica y textual. Devuelve información del candidato, detalles del video y extractos relevantes de la transcripción.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
query	string	Sí	Palabras clave a buscar en las transcripciones
job_posting_id	integer	No	Filtrar resultados por una oferta de empleo específica
limit	integer	No	Máximo de resultados (por defecto: 10, máx: 20)

Devuelve: Transcripciones de video coincidentes con información del candidato, detalles del video y extractos relevantes.

---

Herramientas de equipo

team_list_members

Lista todos los miembros de la cuenta actual con sus roles.

Parámetros: Ninguno

Devuelve: Array de miembros con nombre, email, roles e indicador de propietario.

---

team_list_invitations

Lista todas las invitaciones pendientes de la cuenta actual.

Parámetros: Ninguno

Devuelve: Array de invitaciones con nombre, email, roles asignados, quién invitó y cuándo.

---

team_invite_member

Envía un email de invitación para unirse a tu cuenta. Solo los administradores de la cuenta pueden usar esta herramienta.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
email	string	Sí	Dirección de email a invitar
name	string	Sí	Nombre completo del invitado
admin	boolean	No	Otorgar rol de administrador (por defecto: false)

Devuelve: Confirmación con email, nombre, rol asignado y estado.

Requiere: Scope mcp_write, rol de administrador y suscripción activa.

Herramientas de Outreach

Estas herramientas requieren el complemento Outreach y una suscripción activa.

outreach_list_campaigns

Lista las campañas de Outreach con filtro opcional por estado. Devuelve hasta 25 campañas.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
status	string	No	Filtrar por draft, active, paused o completed

Devuelve: Array de campañas con ID, nombre, estado, prospect_count, message_count, pending_draft_count y created_at.

---

outreach_get_campaign

Devuelve los detalles completos de una campaña específica, incluyendo configuración, contadores de prospectos por estado, resumen de mensajes y cantidad de respuestas.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
campaign_id	string	Sí	ID de campaña obtenido de outreach_list_campaigns

Devuelve: ID de campaña, nombre, estado, configuración completa (volumen objetivo, directivas de IA, pasos de secuencia), contadores de prospectos por estado, resumen de mensajes (total, borradores pendientes, enviados), cantidad de respuestas y created_at.

---

outreach_add_prospect

Añade un prospecto a una campaña. Verifica duplicados y emails suprimidos a menos que force esté activado.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
campaign_id	string	Sí	Campaña a la que añadir el prospecto
email	string	Sí	Dirección de email del prospecto
first_name	string	No	Nombre del prospecto
last_name	string	No	Apellido del prospecto
company_name	string	No	Nombre de la empresa
title	string	No	Cargo
source_url	string	No	Perfil de LinkedIn o URL de la empresa para investigación con IA
notes	string	No	Contexto en texto libre para el agente de IA
force	boolean	No	Omitir verificaciones de duplicados y supresión (por defecto: false)

Devuelve: ID del prospecto, email y estado.

Requiere: Scope mcp_write.

---

outreach_draft_email

Encola la investigación y redacción con IA para un prospecto específico. El prospecto debe estar en un estado que permita la redacción (que no haya sido ya redactado ni esté activo).

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
prospect_id	string	Sí	Prospecto para el que investigar y redactar

Devuelve: Confirmación de que la investigación ha sido encolada.

Requiere: Scope mcp_write.

---

outreach_list_pending_drafts

Lista los mensajes redactados pendientes de aprobación, con filtro opcional por campaña. Devuelve hasta 25 borradores.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
campaign_id	string	No	Filtrar por una campaña específica

Devuelve: Array de borradores con ID, nombre de la campaña, nombre del prospecto, asunto, vista previa del cuerpo (200 caracteres) y created_at.

---

Herramientas utilitarias

echo

Prueba la conectividad MCP. Devuelve tu mensaje con el contexto de la cuenta.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
message	string	Sí	Mensaje a devolver

Devuelve: Tu mensaje, nombre de la cuenta, email del usuario, scopes y marca de tiempo.

---

search_docs

Busca en la documentación de producto de Kit. Útil cuando le preguntas al asistente cómo funciona una característica.

Parámetros:

Nombre	Tipo	Obligatorio	Descripción
query	string	Sí	Qué buscar

Devuelve: Páginas de documentación coincidentes con título, categoría y contenido.

---

get_plans

Obtiene los planes de precios actuales con características, detalles de precios e información de facturación.

Parámetros: Ninguno

Devuelve: Array de planes con nombre, descripción, precio, moneda, intervalo, indicador de facturación por puesto, días de prueba y lista de características.

Resumen de permisos

Herramienta	Scope requerido	¿Escritura?	Notas
echo	–	No
search_docs	–	No
get_plans	–	No
hiring_get_setup_guide	mcp	No
hiring_list_templates	mcp	No
hiring_get_template	mcp	No
hiring_create_process_template	mcp	Sí	Requiere suscripción activa
hiring_list_job_postings	mcp	No
hiring_get_job_posting	mcp	No
hiring_create_job_posting	–	Sí	Solo chatbot integrado; requiere suscripción activa
hiring_list_applications	mcp	No
hiring_get_application_summary	mcp	No
hiring_get_stage_details	mcp	No
hiring_advance_application	mcp_write	Sí
hiring_reject_application	mcp_write	Sí
hiring_list_reviews	mcp	No
hiring_get_review_details	mcp	No
hiring_list_talent_pool	mcp	No
hiring_search_talent_pool	mcp	No
hiring_invite_talent_pool	mcp_write	Sí
hiring_search_video_transcripts	mcp	No
team_list_members	mcp	No
team_list_invitations	mcp	No
team_invite_member	mcp_write	Sí	Solo administradores; requiere suscripción activa
outreach_list_campaigns	mcp	No	Requiere complemento Outreach
outreach_get_campaign	mcp	No	Requiere complemento Outreach
outreach_add_prospect	mcp_write	Sí	Requiere complemento Outreach
outreach_draft_email	mcp_write	Sí	Requiere complemento Outreach
outreach_list_pending_drafts	mcp	No	Requiere complemento Outreach

Todas las herramientas están limitadas a tu cuenta conectada. Un asistente nunca puede ver ni modificar datos de otra cuenta.