add_prospect_note
ChatGPTAgrega una nota u observación al timeline de un prospecto o lead asignado al asesor. Prospecto y lead son sinónimos en Nuboo. La nota queda registrada con fecha/hora y visible en el historial del prospecto/lead. Útil para: registrar resultado de una llamada, observaciones de interés, estado de seguimiento o cualquier comentario sobre el prospecto o lead.
create_investment_quote
ChatGPTGenera una cotización de inversión por extensión/cantidad (p. ej. hectáreas de Coterra) y devuelve resumen financiero + PDF descargable. Solo funciona con proyectos de inversión (model fungible_quantity). FLUJO OBLIGATORIO — sigue estos pasos en orden antes de llamar este tool: 1. OPCIONES DEL PROYECTO: Llama get_investment_options con el nombre del proyecto. Presenta al usuario: inventario(s) disponible(s), unidad de medida, cantidad mínima, múltiplos válidos, precio base por unidad mínima, descuentos por volumen y plazos. 2. PROMOCIONES ACTIVAS: Llama list_active_promotions con el nombre del proyecto. Si hay promociones vigentes, preséntaselas al usuario con: nombre, descripción, reglas de aplicación, beneficios y vigencia. Pregunta si desea aplicar alguna. Si no hay promociones o el usuario prefiere sin promoción, continúa sin ella. 3. MINI-WIZARD — pregunta de a uno lo que falte, en este orden: a. Nombre del cliente (si no lo dio) b. Etapa/inventario — solo si el proyecto tiene más de uno (usa phase_name) c. Cantidad a cotizar — indica la unidad de medida y los múltiplos válidos (p. ej. «¿Cuántas hectáreas? Mínimo 0.25, en pasos de 0.25») d. Plazo en pagos — muestra las opciones disponibles y espera elección e. Enganche % — sugiere el mínimo de la etapa, deja que cambie f. Promoción — usa el nombre exacto de la promoción elegida en el paso 2 (omite el campo si el usuario no quiere ninguna) 4. DESCUENTO POR VOLUMEN: El sistema aplica automáticamente el mejor precio según la cantidad. No necesitas calcular ni pasar price_per_unit manualmente a menos que quieras negociar un precio específico. 5. Con toda la información confirmada, llama este tool para generar la cotización. No pidas toda la información de golpe. Un dato por mensaje.
create_personal_event
ChatGPTCrea un evento o recordatorio personal en el calendario del asesor. Solo crea eventos propios (scope personal); los eventos de equipo los gestiona el administrador. Requiere: título y fecha/hora de inicio (YYYY-MM-DD HH:MM). Opcional: descripción, fecha/hora de fin y tipo de evento. Útil para: 'agéndame una llamada mañana a las 10', 'crea un recordatorio para el viernes'.
create_prospect
ChatGPTCrea un nuevo prospecto o lead y lo asigna directamente al asesor autenticado. Prospecto y lead son sinónimos en Nuboo. El prospecto/lead queda en etapa 'Nuevo' del pipeline. Requiere al menos el nombre. Email, teléfono y celular son opcionales pero recomendados. Útil para: registrar un lead de referido, un contacto de evento o cualquier prospecto manual.
create_quote
ChatGPTGenera una cotización para un lote disponible: resumen financiero y PDF descargable. Queda guardada en el historial del asesor. Solo funciona con unidades disponibles. IMPORTANTE — de cara al usuario, habla siempre en términos de negocio (mensualidades, enganche, promoción), nunca menciones nombres de campos, parámetros, tools ni detalles técnicos internos (ej. no digas "deferred_downpayment_months" ni narres que estás buscando o recargando un esquema). Si una llamada falla, tradúcelo a una pregunta natural para el usuario, no repitas el mensaje de error tal cual. ANTES de llamar este tool, llama get_quote_context con el proyecto y el código de lote: trae en una sola respuesta el detalle de la unidad (precio, enganche mínimo, superficie, estado), los plazos de financiamiento de la etapa y las promociones activas del proyecto. Si la unidad no está disponible, detente ahí. Si hay promociones vigentes, preséntaselas al usuario con nombre, descripción, reglas y beneficios, y pregunta si desea aplicar alguna. Si la promoción elegida trae requires_deferred_downpayment_months: true, es de enganche diferido: DEBES preguntar cuántas mensualidades quiere diferir el enganche (entre 1 y max_deferred_downpayment_months) y enviarlo en deferred_downpayment_months. Nunca asumas un valor por defecto ni cotices esa promoción sin este dato: si no lo indicas, el enganche se cobra de inmediato y la promoción no tiene ningún efecto. MINI-WIZARD — con el contexto ya obtenido, pregunta de a uno lo que falte, en este orden: a. Nombre del cliente (si no lo dio) b. Plazo en mensualidades — muestra las opciones de financiamiento y espera elección c. Enganche % — sugiere el mínimo, deja que cambie d. Precio de venta — solo si quiere negociar; si no, usa precio de lista e. Promoción — usa el nombre exacto de la promoción elegida (omite el campo si el usuario no quiere ninguna) Con toda la información confirmada, llama este tool para generar la cotización. No pidas toda la información de golpe. Un dato por mensaje. PROMOCIÓN entre varias cotizaciones seguidas del mismo cliente/lote — cada llamada a este tool es independiente y NO recuerda la promoción usada antes: si el usuario pide una nueva cotización sin repetir la promoción, sale SIN promoción (precio de lista, sin avisar). Antes de generar, si la conversación ya traía una promoción aplicada y este nuevo pedido no la menciona, confírmalo con el usuario en vez de asumir ("¿esta cotización lleva la misma promoción de antes o va sin promoción?"). promotion_id — cuando list_active_promotions o get_quote_context ya te devolvió el id de la promoción elegida en este mismo chat, reenvíalo aquí junto con promotion_name para evitar repetir la búsqueda por texto (más rápido y sin riesgo de ambigüedad si hay nombres parecidos). Es un detalle interno: nunca lo menciones, muestres ni preguntes al usuario, quien solo conoce el nombre de la promoción.
get_availability_map
ChatGPTEnlace temporal (15 minutos) al mapa de disponibilidad de una etapa: muestra qué lotes están disponibles, reservados, vendidos o bloqueados. Necesita el nombre del proyecto y el nombre de la etapa.
get_help
ChatGPTQué es este servidor MCP (nombre, versión) y catálogo de herramientas disponibles con su descripción.
get_investment_options
ChatGPTOpciones reales para cotizar proyectos de inversión (agro-lotes y similares): cantidad mínima, múltiplos, máximo por operación, disponibilidad, precio por unidad, enganche permitido, plazos y descuentos por volumen. Úsala antes de create_investment_quote para pedir al cliente solo datos válidos. Incluye el enlace público al logo oficial de cada producto; para ver su imagen consulta get_project_detail.
get_lot_detail
ChatGPTDetalle de un lote o unidad: código, etapa, estado, superficie, tipo, precio, enganche mínimo y financiamientos. Necesita el nombre del proyecto y el código del lote.
get_masterlink_download
ChatGPTEnlace de descarga de un recurso Masterlink por nombre del proyecto y del documento. Úsala para brochure, folleto, planos, masterplan, KMZ, PDF, ficha técnica, preguntas frecuentes o material comercial/publicitario de un proyecto.
get_nuboo_info
ChatGPTQué es Nuboo, contacto, sitio web y cómo solicitar acceso según perfil (desarrollador, agencia o asesor).
get_project_detail
ChatGPTFicha completa de un desarrollo: ubicación, inventario, amenidades, etapas, precios, financiamientos y logo oficial (enlace público e imagen adjunta cuando disponible). Úsala también cuando pidan ver, obtener o usar el logo de un desarrollo o producto. Necesita el nombre del proyecto.
get_prospect_detail
ChatGPTDevuelve el detalle completo de un prospecto o lead asignado al asesor: datos de contacto, etapa del pipeline, temperatura, puntos de score y las últimas actividades/notas del timeline. Prospecto y lead son sinónimos en Nuboo. Requiere el ID del prospecto/lead (obtenible con list_my_prospects).
get_quote_context
ChatGPTTrae de una sola vez lo necesario para preparar una cotización: detalle del lote (precio, enganche mínimo, superficie, estado), financiamientos de la etapa y promociones activas del proyecto. Llama este tool antes de create_quote o create_investment_quote en vez de pedir el detalle, los financiamientos y las promociones por separado. Cada promoción trae su id interno: si el usuario elige una, puedes reenviarlo en create_quote (promotion_id) para cotizaciones subsecuentes del mismo chat sin repetir la búsqueda por nombre; nunca lo menciones al usuario.
get_sale_detail
ChatGPTDevuelve el detalle completo de una venta: estado de venta, estado del contrato, liberación, precio, enganche, mensualidades, superficie del lote, asesor, cliente y notas. Se identifica por código de lote con búsqueda fuzzy (ej. «65» encuentra «NUB-01-065»); si el código existe en varios proyectos indica project_name para desambiguar. Solo lectura, no modifica datos. Para buscar ventas por período, asesor, cliente o contrato usa search_sales.
get_sales_summary
ChatGPTResumen de ventas del usuario con totales por cantidad y monto. Permite agrupar por proyecto, asesor, agencia, mes o estado. Si no se indica período devuelve el mes actual. Respeta el scope del usuario: un asesor ve sus propias ventas, un director ve las de su equipo. Para ver el listado individual de ventas usa search_sales; para el detalle de una venta específica usa get_sale_detail.
get_team_sales_summary
ChatGPTDevuelve el equipo completo de un usuario con el resumen de sus ventas. Recorre el árbol jerárquico hacia abajo (padre → hijos → nietos…) sin importar el perfil. Cada miembro incluye: depth (0=raíz, 1=hijos directos, 2=nietos…), parent_user_id, perfil y conteo de ventas por estado (pendiente, aprobada, liberada). No incluye ventas anuladas. Por defecto consulta al usuario autenticado como raíz. Úsala para responder preguntas sobre el rendimiento del equipo o la estructura jerárquica.
get_usage
ChatGPTConsultas usadas y restantes del mes, ritmo por minuto y reglas de cotización en Nuboo.
get_user_profile
ChatGPTPerfil del asesor: nombre, agencia, líder, cotizaciones del mes, historial mensual y ventas. Para un mes concreto indica año y mes en la consulta. Si el asesor pertenece a Grupo Pulser, incluye advisor_site con el estado de su minisite público: published + url si está publicado, o published: false + reason (asesor inactivo, sin slug configurado, o publicación desactivada) si no lo está. Si el usuario pregunta por su sitio y published es false, dile el motivo en términos claros en vez de solo decir que no tiene sitio.
link_quote_to_prospect
ChatGPTVincula una cotización existente a un prospecto o lead asignado al asesor. Prospecto y lead son sinónimos en Nuboo. La cotización queda registrada en el timeline del prospecto/lead para trazabilidad. Usar después de create_quote o create_investment_quote cuando el asesor quiere asociar la cotización a un prospecto o lead específico. Requiere el ID del prospecto/lead y el ID de la cotización.
list_active_promotions
ChatGPTPromociones vigentes en los proyectos del asesor: nombre, descripción, reglas de aplicación, vigencia y beneficios (descuento, enganche, financiamiento, apartado, mensualidad fija, etc.). Llama este tool durante el flujo de cotización (create_quote o create_investment_quote) para mostrarle al usuario las promociones disponibles antes de generar la cotización. Puede filtrar por proyecto o nombre de promoción. Cada promoción trae un id interno (junto con name). Si el usuario elige una promoción de esta lista, puedes reenviar ese id en create_quote (promotion_id, además de promotion_name) para cotizaciones subsecuentes del mismo chat sin repetir la búsqueda por texto. Es un detalle de uso interno entre tools: nunca lo muestres ni lo menciones al usuario, que solo conoce el nombre de la promoción.
list_available_lots
ChatGPTInventario de lotes o unidades disponibles en un proyecto: código, etapa, m², precio y estado. Sirve para comparar tamaños, precios o listar opciones cotizables.
list_financing_options
ChatGPTOpciones de financiamiento de los proyectos del asesor: plazos disponibles (mensualidades) y enganche mínimo por etapa. Puede filtrar por proyecto y etapa.
list_masterlink_documents
ChatGPTRecursos Masterlink visibles del asesor, agrupados por proyecto, con enlace de descarga o vista previa cuando aplique. Úsala para cualquier pedido de brochure, folleto, planos, masterplan, KMZ, PDF, ficha técnica, preguntas frecuentes o material comercial/publicitario de un proyecto.
list_my_events
ChatGPTEventos y recordatorios propios del usuario en el calendario de Nuboo. Por defecto muestra los próximos 90 días desde hoy. Admite filtros: rango de fechas (date_from / date_to en YYYY-MM-DD), tipo de evento (webinar, visita, capacitacion, reunion, otro) y búsqueda por título (q). Útil para: ¿qué tengo hoy?, ¿qué hay esta semana?, ¿cuándo es mi reunión de ventas?
list_my_projects
ChatGPTProyectos activos del asesor, disponibilidad y enlace público al logo oficial de cada proyecto o producto. Para ver la imagen del logo, consulta get_project_detail por nombre.
list_my_prospects
ChatGPTLista los prospectos (también llamados leads) asignados al asesor autenticado. Prospecto y lead son sinónimos en Nuboo. Solo muestra prospectos ya asignados al usuario, no la bandeja de entrada sin asignar. Admite filtros: etapa del pipeline (pipeline), temperatura (temperature) y búsqueda por nombre/email/teléfono (q). Útil para: ¿cuáles son mis prospectos?, ¿cuáles son mis leads?, ¿quién está en etapa interesado?, ¿mis leads calientes?
list_project_training_requests
ChatGPTConsulta solicitudes de capacitación de los proyectos a los que tienes acceso. Por defecto muestra todas las solicitudes. Usa status='pending' para pendientes, 'processed' para capacitaciones confirmadas o 'all' para todas. Puedes filtrar por proyecto con project_slug y por texto con q. La consulta respeta el alcance de tu cuenta y no permite elegir otra agencia.
move_prospect_pipeline
ChatGPTMueve un prospecto o lead asignado al asesor a una nueva etapa del pipeline de ventas. Prospecto y lead son sinónimos en Nuboo. Etapas disponibles: new (Nuevo), contact_attempt (Intento de contacto), contacted (Contactado), interested (Interesado), converted (Convertido), lost (Perdido). Solo aplica a prospectos/leads asignados al usuario. Registra el cambio en el timeline.
search_sales
ChatGPTBusca y lista ventas del usuario agrupadas por proyecto → etapa → mes → asesor → cliente. Búsqueda fuzzy por texto libre (nombre de cliente, asesor, código de lote o proyecto), filtro por nombre de proyecto, rango de fechas, estado de venta (pendiente/aprobada/anulada) y estado de contrato (en proceso/generado/enviado/firmado/recepcionado/anulado). Requiere al menos un filtro. Solo lectura, no modifica datos. Para ver el detalle completo de una venta específica usa get_sale_detail.
