---
title: "Casos de uso del MCP de Requiply"
description: "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."
canonical_url: "https://requiply.com/docs/es/ai/mcp/use-cases"
---
# 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](https://requiply.com/docs/es/ai/mcp/tools) usa para responder.

## Preguntas de ejemplo

<table>
<thead>
  <tr>
    <th>
      Qué puedes preguntarle a un asistente
    </th>
    
    <th>
      Herramientas MCP de Requiply que probablemente usa
    </th>
  </tr>
</thead>

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

## 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.

<note>

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.

</note>

### Entender el negocio

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

<details>
<summary>

Ejemplo de respuesta

</summary>

```json
{
  "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 }]
}
```

</details>

### 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.

<details>
<summary>

Ejemplo de respuesta

</summary>

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

</details>

### Encontrar una reserva por su número

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

<details>
<summary>

Ejemplo de respuesta

</summary>

```json
{
  "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": []
      }
    }
  ]
}
```

</details>

### Revisar los resultados de un periodo

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

<details>
<summary>

Ejemplo de respuesta

</summary>

```json
{
  "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 }]
}
```

</details>

### Redactar una solicitud de reserva (escritura)

**Pregunta:** "Reserva el ATEM Mini Pro del 6 al 8 de octubre para [jordan.lee@example.com](mailto: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.

<details>
<summary>

Ejemplo de respuesta (vista previa)

</summary>

```json
{
  "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."
}
```

</details>

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

<details>
<summary>

Ejemplo de respuesta (confirmada)

</summary>

```json
{
  "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."
}
```

</details>

### Escribir una plantilla de email con macros

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

1. **get_guidance** con `topics=["email_template_macros"]` devuelve todas las macros, incluidos tus campos personalizados.
2. **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.
3. **templates_manage** con `operation="create"` muestra la plantilla validada; la llamada confirmada la guarda.

<details>
<summary>

Ejemplo de respuesta (vista previa)

</summary>

```json
{
  "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}}"]
}
```

</details>

### 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.

<details>
<summary>

Ejemplo de respuesta (vista previa)

</summary>

```json
{
  "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."
}
```

</details>

### 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

<details>
<summary>

Ejemplo de respuesta (vista previa)

</summary>

```json
{
  "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."
}
```

</details>


## Sitemap

See the full [sitemap](https://requiply.com/docs/sitemap.md) for all pages.