MCP HubSpot para Ringover
Servidor MCP que conecta a Airo (agente de voz Felipe) con HubSpot.
Endpoint
Protocolo JSON-RPC 2.0 (MCP Streamable HTTP, sin sesion). Autenticacion via Authorization: Bearer <MCP_API_KEY>.
Herramientas disponibles
buscar_contacto_por_telefono
Busca o crea un contacto en HubSpot por numero de telefono. Siempre retorna un contact_id.
obtener_contexto_por_telefono
Devuelve contexto completo del cliente (identidad, comunidades, tickets) en markdown.
obtener_condominios_del_contacto
Lista las comunidades (Companies de HubSpot) asociadas al contacto.
obtener_tickets_abiertos
Lista los tickets abiertos del contacto, con filtro opcional por condominio.
actualizar_datos_contacto
Actualiza nombre, apellido, email o comunidad del contacto durante la llamada.
registrar_resumen_llamada
Guarda el resumen de la llamada como Engagement en el timeline del contacto.
registrar_transfer_agente
Registra el contexto antes de transferir al cliente a un agente humano.
crear_ticket_soporte
Crea un ticket de soporte cuando no hay agentes disponibles.
verificar_disponibilidad_agentes
Consulta en tiempo real si hay agentes disponibles via Ringover API.
Variables de entorno requeridas
MCP_API_KEYClave de acceso para Airo. Generarla con un UUID v4.HUBSPOT_TOKENToken privado de la app HubSpot de ComunidadFeliz.HUBSPOT_PORTAL_IDPortal ID de HubSpot (default: 6977629).RINGOVER_API_KEYOpcional. API key de Ringover para verificar disponibilidad de agentes.RINGOVER_USER_IDSOpcional. IDs de agentes a monitorear, separados por coma.DEFAULT_PHONE_COUNTRYOpcional. Codigo de pais para normalizar telefonos (default: CL).AGENTS_AVAILABLEOpcional. Override manual: true/false.