Catálogo de herramientas
Cada herramienta que expone el servidor MCP de Ryde, con el alcance y derecho que requiere.
Generado desde el registro de operaciones, así que una herramienta no puede aparecer aquí sin una operación real detrás. "Confirmación" marca las herramientas que requieren una cotización reciente mostrada al cliente, más una clave de idempotencia.
| Herramienta | Descripción | Alcance | Ryde One | Confirmación | Estado |
|---|---|---|---|---|---|
get_membership_status | Si este cliente tiene una membresía Ryde One activa. Consúltalo antes de ofrecer transaccionar, para que el agente explique el requisito en vez de chocar con un 403 a media frase. | profile.read | No | No | Beta |
search_restaurants | Encuentra restaurantes, supermercados y tiendas abiertos cerca de un punto. | food.read | No | No | Beta |
get_restaurant_menu | El catálogo público de un comercio. El costo, el inventario, los códigos de barras y los identificadores de proveedor son asunto del comercio y nunca se devuelven aquí. | food.read | No | No | Beta |
quote_food_order | Cotiza una canasta exactamente como lo haría el checkout: artículos, cargos, impuestos, cualquier descuento de miembro y el total. Devuelve el quote_id que requiere place_food_order. | food.read | No | No | Beta |
place_food_order | Realiza el pedido que el cliente confirmó, a partir de un quote_id que se le mostró. | food.order | Obligatoria | Obligatoria | Beta |
get_food_order | Estado en vivo de un pedido, incluido el avance del mensajero. Deliberadamente SIN restricción de membresía: un pedido que existe sigue siendo rastreable. | food.read | No | No | Beta |
list_food_orders | El historial de pedidos del propio cliente, del más reciente al más antiguo. | food.read | No | No | Beta |
cancel_food_order | Cancela un pedido, cuando su estado actual aún lo permite. Nunca restringido por membresía: SALIR de una transacción no debe requerir un derecho. | food.read | No | No | Beta |
search_ride_options | Las categorías de vehículo que se pueden solicitar, con la tarifa base de cada una. | rides.read | No | No | Beta |
quote_ride | Distancia por carretera, tiempo de conducción y la tarifa final por categoría de vehículo, impuestos incluidos. Devuelve el quote_id que requiere request_ride. | rides.read | No | No | Beta |
request_ride | Solicita el viaje que el cliente confirmó, a partir de un quote_id que se le mostró. | rides.request | Obligatoria | Obligatoria | Beta |
get_ride | Estado en vivo de un viaje: avance del despacho, el conductor y vehículo asignados, y el tiempo estimado de llegada. Nunca restringido por membresía: un viaje en curso sigue siendo rastreable. | rides.read | No | No | Beta |
list_rides | El historial de viajes del propio cliente, del más reciente al más antiguo. | rides.read | No | No | Beta |
cancel_ride | Cancela un viaje que no ha comenzado. Nunca restringido por membresía, por la misma razón que cancelar un pedido. | rides.read | No | No | Beta |
quote_delivery | Cotiza un envío de mensajería entre dos puntos. Usa la misma ruta de precios que la solicitud, así que la cotización es el cobro. | delivery.read | No | No | Beta |
request_delivery | Despacha un mensajero para mover un paquete, a partir de un quote_id que se mostró al cliente. | delivery.request | Obligatoria | Obligatoria | Beta |
get_delivery | Estado en vivo de una entrega, incluido el avance del mensajero y la prueba de entrega una vez recogida. | delivery.read | No | No | Beta |
check_coverage | Consulta si Ryde entrega en un código postal o un punto, y con qué niveles de servicio. | coverage.read | No | No | Beta |
quote_rates | Cotiza un paquete a una dirección con tu tarifa contratada, por nivel de servicio. No crea nada. | coverage.read | No | No | Beta |
create_shipment | Entrega a Ryde un paquete para repartir. Devuelve su número de rastreo de Ryde. | shipments.create | No | No | Beta |
create_shipments_batch | Entrega a Ryde un manifiesto de hasta 500 paquetes en una sola solicitud. Cada fila informa creado, duplicado o rechazado con su motivo. | shipments.create | No | No | Beta |
get_shipment | El estado actual de un paquete, con su historial de escaneos y la prueba de entrega una vez entregado. | shipments.read | No | No | Beta |
list_shipments | Tus paquetes, del más reciente al más antiguo, filtrables por estado y fecha. | shipments.read | No | No | Beta |
cancel_shipment | Cancela un paquete que entregaste a Ryde, en cualquier momento antes de que se entregue o se devuelva. | shipments.manage | No | No | Beta |
list_shipment_events | Todos los eventos registrados de un paquete, del más antiguo al más reciente: dónde se escaneó, cuándo y por qué falló un intento. | shipments.read | No | No | Beta |
list_hubs | Los depósitos desde donde se recogen tus paquetes. | coverage.read | No | No | Beta |
search_service_providers | Encuentra proveedores que se desplazan al cliente, con su disponibilidad en vivo. La disponibilidad se deriva por solicitud y el cliente nunca debe guardarla en caché. | services.read | No | No | Beta |
get_provider_availability | Franjas de cita libres en una fecha, para un trabajo de cierta duración. A un trabajo largo solo se le ofrece un inicio cuyas franjas consecutivas estén todas libres. | services.read | No | No | Beta |
quote_service | Cotiza una reserva de servicio antes de comprometer una franja. | services.read | No | No | Beta |
book_service | Reserva un proveedor, opcionalmente en una franja concreta. La competencia por una franja la resuelve la plataforma: una reserva perdedora se rechaza, nunca se duplica. | services.book | Obligatoria | Obligatoria | Beta |
get_service_booking | Estado en vivo de una reserva, desde la llegada hasta el inicio y la finalización. | services.read | No | No | Beta |
list_task_types | Los tipos de tarea que este mercado puede ejecutar realmente, con la evidencia que recoge cada uno. Solo se listan los tipos que Ryde puede cubrir con personal. | tasks.read | No | No | Beta |
quote_task | Cotiza una tarea y confirma que podría encontrarse un proveedor calificado antes de comprometerse. | tasks.read | No | No | Beta |
create_task | Despacha trabajo del mundo real con requisitos estructurados y reglas de evidencia. | tasks.create | Obligatoria | Obligatoria | Beta |
get_task | Estado de la tarea, el proveedor asignado y la evidencia recogida hasta el momento. | tasks.read | No | No | Beta |
get_task_evidence | La evidencia recogida para una tarea: fotos con sus hashes de contenido, GPS de captura, marcas de tiempo del dispositivo y las respuestas de cualquier lista de verificación. | tasks.read | No | No | Beta |
cancel_task | Cancela una tarea que no ha comenzado. | tasks.read | No | No | Beta |
list_business_orders | Lista los pedidos de la tienda, del mas reciente al mas antiguo. Filtra por estado o tipo de entrega. | orders.read | No | No | Beta |
get_business_order | Consulta un pedido de la tienda en detalle, con sus articulos y su historial de estados. | orders.read | No | No | Beta |
accept_business_order | Acepta un pedido entrante. Se rechaza con 402 si un pedido con tarjeta o billetera aun no esta pagado. | orders.manage | No | No | Beta |
reject_business_order | Rechaza un pedido. Un pedido pagado se reembolsa a la billetera Ryde del cliente — o, si la tienda lo cobró en su propia cuenta de Stripe, a la tarjeta del cliente por la tienda — y se libera la cita reservada. | orders.manage | No | No | Beta |
start_business_order_prep | Marca un pedido aceptado como en preparacion, para que el seguimiento del cliente lo refleje. | orders.manage | No | No | Beta |
mark_business_order_ready | Marca un pedido como listo para recoger. En un pedido a domicilio esto despacha un mensajero de Ryde. | orders.manage | No | No | Beta |
complete_business_order | Completa un pedido para recoger o en el local. Se rechaza con 409 si la cuenta de la mesa sigue abierta. | orders.manage | No | No | Beta |
list_catalog_items | Lista los articulos del catalogo de la tienda con precios, modificadores y disponibilidad. | menu.read | No | No | Beta |
create_catalog_item | Crea un articulo del catalogo. Aparece de inmediato en el POS de la tienda y en su tienda Ryde. | menu.manage | No | No | Beta |
update_catalog_item | Actualiza el nombre, la descripcion, el precio, la categoria o los modificadores de un articulo. | menu.manage | No | No | Beta |
set_catalog_item_availability | Retira un articulo de la venta o vuelve a ofrecerlo, sin eliminarlo. La forma reversible de agotarlo. | menu.manage | No | No | Beta |
delete_catalog_item | Elimina un articulo del catalogo. No hay forma de deshacerlo por la API; para retirarlo temporalmente, cambia su disponibilidad. | menu.manage | No | No | Beta |
import_catalog_items | Crea varios articulos del catalogo a la vez, con sus categorias. Solo crea: nunca cambia el precio de un articulo existente. | menu.manage | No | No | Beta |