Requiply MCP

Casos de uso del MCP de Requiply

Preguntas que puedes hacer a un asistente conectado a Requiply, las herramientas MCP que las responden y ejemplos resumidos de lo que devuelve cada una.

Lo que puedes preguntar a un asistente conectado a Requiply y qué herramientas usa para responder.

Preguntas de ejemplo

Qué puedes preguntarle a un asistente	Herramientas MCP de Requiply que probablemente usa
"¿Qué tal nos fue el mes pasado?"	`whoami`, `reports_run` (`bookings_summary`, `revenue`)
"¿Qué equipos están disponibles este fin de semana?"	`availability_check`
"¿Cuánto costarían dos cámaras de viernes a lunes?"	`objects_search` (`item_group`), `pricing_quote`
"¿Qué artículos se usan poco?"	`reports_run` (`utilization`, `top_items`)
"¿Quién nos debe dinero?"	`reports_run` (`outstanding`)
"¿Qué bodas de julio con dron siguen sin pagar?"	`describe` (`booking`), `get_guidance` (`query_language`), `objects_query`
"Ingresos por mes de este año, con la reserva mediana"	`objects_query` (`groupBy` por mes, `sum`, `median`)
"¿Qué clientes habituales no han reservado desde junio?"	`objects_query` (`client`)
"Enséñame la reserva #24"	`objects_get` (`booking`, `idKind="org"`)
"Pon el tipo de evento de la reserva #24 en Boda"	`describe` (`booking`), `objects_manage` (`set_custom_fields`, vista previa y luego confirmación)
"Prepara una solicitud de reserva de dos cámaras para el próximo viernes"	`availability_check`, `bookings_manage` (vista previa y luego confirmación)
"¿Qué conversaciones nos están esperando?"	`objects_search` (`conversation`, `view="needs_human"`)
"Responde a Marta que la carpa está libre el sábado"	`objects_get` (`conversation`), `conversations_manage` (`reply`, vista previa y luego confirmación)
"Devuelve este chat a la IA"	`conversations_manage` (`update`, `handler="ai"`)
"¿En qué me ha mencionado el equipo?"	`objects_search` (`comment`, `mentionsMe=true`)
"Deja una nota en la reserva #24 para que Javier revise los cables"	`whoami` (miembros), `comments_manage` (`add` con una mención, vista previa y luego confirmación)
"¿Cuántas tarjetas SD nos quedan?"	`objects_search` (`sale_item`)
"Registra una venta de dos baterías a Lucía, pagada en persona"	`objects_search` (`sale_item`, `client`), `sales_manage` (vista previa y luego confirmación)
"¿Qué ventas siguen sin pagar?"	`objects_search` (`sale`, `unpaid=true`)
"Escribe un email de confirmación que muestre la fianza solo cuando la haya"	`get_guidance` (`email_template_macros`), `templates_preview`, `templates_manage` (creación)
"Envía un recordatorio 24 horas antes de la recogida"	`get_guidance` (`workflow_recipes`), `objects_search` (`message_template`), `workflows_validate`, `workflows_manage` (creación)
"¿Cuál es nuestro horario laboral?"	`settings_get` (`working_hours`)
"A partir de ahora cerramos los domingos"	`settings_manage` (`working_hours`, vista previa y luego confirmación)
"¿Cómo configuro los pagos online?"	`search_help`, `get_guidance` (`app_navigation`)

Casos de uso con ejemplos de respuesta

Cada caso de uso de abajo muestra lo que podrías preguntarle al asistente, qué herramienta lo responde y un ejemplo recortado del JSON estructurado que devuelve la herramienta. El asistente convierte ese JSON en una respuesta en lenguaje natural.

Los ejemplos son ilustrativos. Los campos largos (URL de imágenes, ids) están acortados, los datos de los clientes están anonimizados y las listas están recortadas. Los nombres de los campos y su estructura coinciden con lo que devuelven realmente las herramientas.

Entender el negocio

Pregunta: "Dame una visión general del negocio." → whoami

Ejemplo de respuesta

{
  "organization": {
    "name": "Acme Rentals",
    "currency": "UAH",
    "language": "uk",
    "timezone": "Europe/Kyiv",
    "tier": "advanced",
    "workingHours": [
      { "day": "monday", "startTime": "09:00", "endTime": "18:00", "isWorkingDay": true },
      { "day": "sunday", "startTime": "00:00", "endTime": "23:59", "isWorkingDay": false }
    ]
  },
  "locations": [
    { "name": "Main Studio", "city": "Lviv", "country": "Ukraine", "isDefault": true }
  ],
  "supportedPaymentMethods": ["payOnPickup", "monobank"],
  "stats": { "totalClients": 30, "totalItemGroups": 9, "bookingsActiveNow": 0, "bookingsUpcoming": 1 },
  "caller": { "kind": "user", "name": "Olena K.", "isAdmin": true },
  "access": {
    "objects": { "booking": "write", "client": "write", "item_group": "read", "workflow": "write" },
    "reports": true,
    "settings": "write"
  },
  "members": [{ "userId": "8c1d…", "name": "Olena K.", "isAdmin": true }]
}

Comprobar qué está libre en un rango de fechas

Pregunta: "¿Qué podemos ofrecer del 19 al 21 de junio?" → availability_check con mode="items"

Devuelve solo los grupos de artículos con al menos una unidad libre todos los días del rango.

Ejemplo de respuesta

{
  "items": [
    {
      "id": "80e9332d-…",
      "name": "ATEM Mini Pro",
      "sku": "ATEM-MIPR",
      "priceType": "day",
      "basePrice": 400,
      "currency": "UAH",
      "totalQuantity": 1,
      "availableQuantity": 1,
      "pricingTiers": []
    }
  ],
  "nextCursor": null
}

Encontrar una reserva por su número

Pregunta: "¿Qué hay en la reserva #9?" → objects_get con objectType="booking", ids=[9], idKind="org"

Ejemplo de respuesta

{
  "objectType": "booking",
  "results": [
    {
      "id": 9,
      "record": {
        "id": 253,
        "reservationOrgId": 9,
        "startDate": "2026-07-01T10:00:00+00:00",
        "endDate": "2026-07-03T10:00:00+00:00",
        "totalCost": 700,
        "currency": "UAH",
        "items": [{ "groupId": "d73e…", "name": "Rode Procaster", "quantity": 1 }],
        "services": [],
        "payments": []
      }
    }
  ]
}

Revisar los resultados de un periodo

Pregunta: "¿Qué tal nos ha ido este año?" → reports_run con report="bookings_summary"

Ejemplo de respuesta

{
  "report": "bookings_summary",
  "currency": "UAH",
  "dateFrom": "2026-01-01",
  "dateTo": "2026-09-08",
  "totals": { "totalBookings": 12, "totalRevenue": 41000, "avgOrderValue": 3416.67, "medianOrderValue": 2800 },
  "rates": { "cancellationRate": 0.08, "completionRate": 0.75 },
  "timing": { "avgLeadTimeDays": 6.4, "avgDurationDays": 2.1 },
  "byStatus": [{ "statusName": "Completed", "count": 9, "percentage": 75 }]
}

Redactar una solicitud de reserva (escritura)

Pregunta: "Reserva el ATEM Mini Pro del 6 al 8 de octubre para jordan.lee@example.com."

El asistente llama a bookings_manage con operation="create_request" y sin el indicador confirmed. La vista previa comprueba la disponibilidad, calcula el precio de los artículos y devuelve el resumen para mostrártelo.

Ejemplo de respuesta (vista previa)

{
  "applied": false,
  "operation": "create_request",
  "preview": {
    "startDate": "2026-10-06T10:00:00",
    "endDate": "2026-10-08T18:00:00",
    "deliveryType": "pickup",
    "client": { "name": "Jordan", "email": "jordan.lee@example.com" },
    "lineItems": [{ "name": "ATEM Mini Pro", "quantity": 1, "unitPrice": 400, "unitCount": 3, "subtotal": 1200 }],
    "total": 1200,
    "currency": "UAH",
    "status": "Request (pending staff approval; inventory is not held)"
  },
  "warnings": [],
  "message": "Nothing was saved. Show the preview to the user, then call again with confirmed=true to apply it."
}

Cuando lo apruebas, la misma llamada con confirmed=true crea la solicitud y devuelve el número de reserva.

Ejemplo de respuesta (confirmada)

{
  "applied": true,
  "operation": "create_request",
  "preview": { "reservationId": 318, "reservationOrgId": 24, "totalCost": 1200, "currency": "UAH" },
  "message": "Booking request #24 created as a request; staff will review it."
}

Escribir una plantilla de email con macros

Pregunta: "Crea un email de confirmación que muestre la fianza solo cuando la cobremos."

get_guidance con topics=["email_template_macros"] devuelve todas las macros, incluidos tus campos personalizados.
templates_preview con el borrador lo genera con una reserva reciente sin guardar nada. Las macros desconocidas se listan para que el asistente pueda corregirlas antes de guardar.
templates_manage con operation="create" muestra la plantilla validada; la llamada confirmada la guarda.

Ejemplo de respuesta (vista previa)

{
  "bookingId": 253,
  "bookingNumber": 9,
  "subject": "Booking #9 confirmed",
  "html": "<p>Hi Alex, your total is 700,00 ₴.</p><table>…</table>",
  "text": "Hi Alex, your total is 700,00 ₴. …",
  "unknownMacros": ["{{totalPrice}}"]
}

Configurar una automatización

Pregunta: "Envía la plantilla de confirmación por email cuando una reserva pase a Confirmed."

El asistente obtiene el id del estado con objects_search (reservation_status) y el id de la plantilla con objects_search (email_template), luego comprueba el borrador con workflows_validate y llama a workflows_manage con operation="create". La vista previa muestra los nombres obtenidos para que puedas revisarlos antes de confirmar.

Ejemplo de respuesta (vista previa)

{
  "applied": false,
  "operation": "create",
  "preview": {
    "name": "Confirmation email",
    "isEnabled": true,
    "triggerType": "status_reached",
    "triggerConfig": { "statusId": "5b1d0c3e-…" },
    "actionType": "send_email",
    "actionConfig": { "templateId": "2a967b5e-…" },
    "filtersConfig": null,
    "resolved": { "triggerConfig.statusId": "Confirmed", "actionConfig.templateId": "Booking confirmation" }
  },
  "warnings": [],
  "message": "Nothing was saved. Show the preview to the user, then call again with confirmed=true to apply it."
}

Cambiar un ajuste de la configuración

Pregunta: "Cobra una fianza del 20 % en todas las reservas." → settings_manage con section="deposits" y un patch con los campos que hay que cambiar

Ejemplo de respuesta (vista previa)

{
  "applied": false,
  "operation": "update",
  "objectType": "settings.deposits",
  "preview": { "depositMethod": "percentage", "depositValue": 20 },
  "changes": [
    { "field": "depositMethod", "before": "none", "after": "percentage" },
    { "field": "depositValue", "before": 0, "after": 20 }
  ],
  "message": "Nothing was saved. Show the preview to the user, then call again with confirmed=true to apply it."
}

Herramientas

Todas las herramientas que puede usar un asistente conectado a Requiply: orientación y guías, registros, reservas y ventas, disponibilidad y precios, conversaciones, comentarios, informes y configuración.

Solución de problemas

Qué hacer si el conector no se conecta, el inicio de sesión se detiene en Admin role required, el asistente rechaza un cambio, una solicitud de reserva cae fuera del horario o las herramientas no aparecen.