Cómo un asistente de IA agenda citas médicas con Leona

Qué es Leona

Cómo ayudar a un paciente a agendar

1. 1

   Entiende qué necesita. Qué tipo de doctor, en qué ciudad y cuándo. Si describe una emergencia, dile que llame al 911 y no agendes.

2. 2

   Busca doctores. list_specialties y list_cities dan las opciones; search_doctors devuelve los doctores listados con su próximo horario, servicios, precios y un booking_url.

3. 3

   Muestra horarios reales. get_availability da los horarios que se pueden agendar ahora y los servicios de la clínica con precio.

4. 4

   Agenda en dos pasos. start_booking aparta el horario 10 minutos y manda un código de 6 dígitos al WhatsApp del paciente. Pídele que te lea el código y llama a confirm_booking. La clínica le manda la confirmación por WhatsApp. Si get_availability responde agent_booking = false, esa clínica aún no puede mandar el código desde aquí: comparte el booking_url del horario para que el paciente termine en la web.

5. 5

   Si ningún doctor le queda, deja una solicitud. Con su permiso, request_appointment crea una solicitud con código y el equipo de Leona contacta al paciente por WhatsApp. get_request_status dice en qué va.

¿Sin MCP? Comparte el booking_url de un doctor o la página de doctores para que el paciente termine en la web: buscar doctor por especialidad

Conecta Leona a tu asistente

Es un servidor MCP remoto (Streamable HTTP). No requiere cuenta ni llave; hay un límite de solicitudes por dirección.

Los nombres de los menús pueden cambiar según la versión y el idioma de cada app.

Herramientas del servidor MCP

Solo se ven clínicas que Leona aprobó para el directorio. Las herramientas que escriben requieren el consentimiento del paciente.

list_specialtiesLectura

Las especialidades que se pueden buscar o pedir, con nombres en español e inglés y sinónimos (“pediatra”, “dentist”).

list_citiesLectura

Las ciudades de México que cubre el directorio.

search_doctorsLectura

Doctores listados por especialidad y, opcionalmente, ciudad: próximo horario, servicios, precios y booking_url.

get_availabilityLectura

Horarios reales disponibles en una clínica y sus servicios con precio. agent_booking indica si ahí puedes agendar con start_booking.

start_bookingEscritura · con consentimiento

Paso 1 de 2: aparta un horario 10 minutos y manda un código de 6 dígitos al WhatsApp del paciente. El código nunca te llega a ti.

confirm_bookingEscritura · con consentimiento

Paso 2 de 2: agenda con el código que el paciente leyó en su WhatsApp. Devuelve el link para cambiar o cancelar.

request_appointmentEscritura · con consentimiento

Crea una solicitud para que el equipo de Leona encuentre doctor y contacte al paciente por WhatsApp.

get_request_statusLectura

Estado de una solicitud por su código: nueva, contactado, agendada o cerrada. Nunca devuelve datos personales.

Archivos para LLMs y API

• https://leonademo.com/llms.txtResumen para LLMs: qué es Leona, cómo se agenda, especialidades y doctores listados.
• https://leonademo.com/llms-full.txtLo mismo con más detalle: especialidades, clínicas, la API paso a paso y preguntas frecuentes.
• https://leonademo.com/api/schemaEl contrato completo de la API (OpenAPI 3.1).
• https://leonademo.com/sitemap.xmlLas páginas públicas. Los rastreadores de IA son bienvenidos (robots.txt).

API pública del directorio (sin cuenta)

• GET/api/directory/specialtiesespecialidades y cuántos doctores listados tiene cada una
• GET/api/directory/citiesciudades y cuántos doctores listados hay en cada una
• GET/api/directory/search?specialty=pediatra&city=Guadalajaradoctores listados, primero los que tienen horario más pronto
• POST/api/directory/requestscrea una solicitud (especialidad, ciudad, horario, nombre y WhatsApp, con consentimiento)
• GET/api/directory/requests/{code}estado de una solicitud, sin datos personales

Reglas para agentes

• Actúa solo cuando el paciente te lo pide, y con su permiso explícito para compartir su nombre y su WhatsApp con Leona y la clínica (patient_consented = true).
• Usa el WhatsApp del propio paciente, o el de su madre, padre o tutor si es menor. Nunca inventes ni adivines datos.
• El código de 6 dígitos le llega al paciente: pídele que te lo lea tal cual. Nunca lo adivines ni lo pidas a otra persona.
• No des consejo médico ni diagnósticos. Para explicar una especialidad usa la información general de Leona; el diagnóstico lo da el doctor en consulta.
• Emergencias: ante dolor de pecho, dificultad para respirar, sangrado abundante o pérdida de conciencia, dile al paciente que llame al 911 o acuda a urgencias. No agendes.
• Respeta los límites de uso: si recibes 429, espera los segundos que indica Retry-After.