BKlayerAcceder

DOCUMENTACION MCP

BKlayer MCP para agentes de IA

Conecta asistentes de IA con negocios locales para buscar, consultar disponibilidad real y crear reservas mediante una API segura y conforme al RGPD.

Que es BKlayer MCP

BKlayer es una infraestructura de reservas que conecta agentes de IA con negocios locales reales. A traves del servidor MCP de BKlayer, agentes como Claude pueden buscar negocios, consultar disponibilidad en tiempo real y crear, gestionar o cancelar reservas en nombre de los usuarios mediante una API estructurada.

URL del servidor MCP: https://mcp.bklayer.com/mcp

Transporte: Streamable HTTP (compatible con la especificacion MCP)

Politica de privacidad: https://www.bklayer.com/privacidad

Contacto: reservas@bklayer.com

Herramientas disponibles

BKlayer MCP ofrece herramientas de consulta y de operacion para gestionar reservas. La tabla recoge los nombres de los metodos, su comportamiento y los parametros necesarios.

#MétodoDescripciónParámetrosTypeIndicators
1search_businessBusca negocios por nombre, categoria o ciudad.

q (texto)

city (texto, opcional)

category (texto, opcional)

READ ONLY
Read-only: yes
2get_business_profileObtiene el perfil publico de un negocio: nombre, descripcion, categoria, ciudad y contacto.

idOrSlug (texto)

READ ONLY
Read-only: yes
3get_business_policiesObtiene las politicas de reserva del negocio: cancelacion, pago y plazos.

idOrSlug (texto)

READ ONLY
Read-only: yes
4list_business_servicesLista los servicios activos de un negocio, incluida su duracion y metadatos.

idOrSlug (texto)

READ ONLY
Read-only: yes
5list_business_staffLista los profesionales activos de un negocio para que el cliente pueda elegir.

idOrSlug (texto)

READ ONLY
Read-only: yes
6check_availabilityConsulta la disponibilidad real de un negocio en una fecha concreta y devuelve huecos con datos del profesional.

idOrSlug (texto)

date (texto YYYY-MM-DD)

serviceId (texto, opcional)

staffId (texto, opcional)

party_size (numero, opcional)

meal_period (texto, opcional)

READ ONLY
Read-only: yes
7search_customer_bookingsBusca las reservas de un cliente por telefono. Requiere verificacion mediante OTP.

idOrSlug (texto)

phone (texto)

verification_code (texto)

READ ONLY
Read-only: yes
8get_booking_detailsObtiene el detalle de una reserva mediante su referencia: servicio, profesional, fecha, hora, cliente y estado.

idOrSlug (texto)

booking_reference (texto)

customer_verification (objeto)

READ ONLY
Read-only: yes
9create_bookingCrea una reserva confirmada. Requiere mostrar un resumen y recibir confirmacion explicita del usuario.

idOrSlug (texto)

serviceId (texto)

date (texto)

time (texto)

customerName (texto)

customerPhone (texto)

staffId (texto, opcional)

notes (texto, opcional)

confirmation_summary_presented (booleano)

confirmation_obtained (booleano)

user_confirmation_text (texto)

MUTATION
Destructive: no
10reschedule_bookingReprograma una reserva existente a una fecha y hora nuevas. Requiere OTP y confirmacion explicita.

idOrSlug (texto)

booking_reference (texto)

new_date (texto)

new_time (texto)

customer_verification (objeto)

confirmation_summary_presented (booleano)

confirmation_obtained (booleano)

user_confirmation_text (texto)

MUTATION
Destructive: yes
11request_customer_booking_verification_codeEnvia un codigo OTP al telefono del cliente antes de cancelar o consultar sus reservas.

idOrSlug (texto)

phone (texto)

MUTATION
Destructive: no
12cancel_bookingCancela una reserva existente. Requiere OTP y confirmacion explicita del usuario.

idOrSlug (texto)

booking_reference (texto)

customer_verification (objeto)

confirmation_summary_presented (booleano)

confirmation_obtained (booleano)

user_confirmation_text (texto)

MUTATION
Destructive: yes
13add_booking_noteAnade una observacion a una reserva existente. No modifica fecha, hora, servicio ni profesional.

idOrSlug (texto)

booking_reference (texto)

note (texto)

note_type (texto)

customer_verification (objeto)

confirmation_summary_presented (booleano)

confirmation_obtained (booleano)

user_confirmation_text (texto)

MUTATION
Destructive: no

Ejemplos de uso

Ejemplo 1 - Buscar un negocio y consultar disponibilidad

Usuario: "Quiero reservar un corte de pelo manana por la tarde."

Flujo del agente

  1. search_business - encuentra una peluqueria.
  2. list_business_services - encuentra "Corte de pelo".
  3. check_availability - consulta manana y devuelve huecos de tarde.
  4. El agente presenta las opciones al usuario.
  5. El usuario confirma horario y datos.
  6. create_booking - crea la reserva y devuelve una referencia publica.

Ejemplo de payload para create_booking

{
  "idOrSlug": "peluqueria",
  "serviceId": "service_uuid",
  "date": "2026-05-21",
  "time": "16:00",
  "customerName": "Cliente",
  "customerPhone": "+34600000000",
  "notes": "Preferencia de corte",
  "confirmation_summary_presented": true,
  "confirmation_obtained": true,
  "user_confirmation_text": "confirmo"
}

Ejemplo 2 - Reserva de restaurante

Usuario: "Reserva una mesa para 4 personas en un restaurante el viernes por la noche."

Flujo del agente

  1. search_business - encuentra un restaurante.
  2. check_availability - consulta viernes, meal_period: dinner y party_size: 4.
  3. El agente presenta los huecos disponibles.
  4. El usuario confirma horario y datos.
  5. create_booking crea la reserva con party_size=4 y meal_period=dinner.

Ejemplo 3 - Consultar y cancelar una reserva

Usuario: "Quiero cancelar mi cita en una peluqueria."

Flujo del agente

  1. request_customer_booking_verification_code envia un OTP al telefono del cliente.
  2. El usuario proporciona el OTP.
  3. search_customer_bookings encuentra la reserva.
  4. El agente muestra el detalle y solicita confirmacion.
  5. El usuario confirma la cancelacion.
  6. cancel_booking cancela la reserva.

Seguridad y privacidad

Seguridad

  • Toda mutacion exige confirmacion explicita del usuario (confirmation_obtained: true).
  • Se requiere OTP para cancelaciones y consultas de reservas.
  • No se exponen UUID internos; solo referencias publicas como BK-XXXX.
  • Validacion de origen en todas las solicitudes MCP.
  • HTTPS/TLS en todas las conexiones.
  • Tiempo maximo de 25 segundos por llamada.

RGPD

  • Los datos se procesan en la UE o bajo clausulas contractuales tipo de la UE.
  • Politica de privacidad: https://www.bklayer.com/privacidad
  • Minimizacion de datos: solo se transmite la informacion necesaria para cada operacion.
  • Los usuarios pueden ejercer sus derechos en privacidad@bklayer.com

Conecta BKlayer con Claude

Instrucciones para claude.ai:

  1. Entra en claude.ai - Settings - Connectors.
  2. Pulsa "Add connector".
  3. Introduce la URL del servidor MCP: https://mcp.bklayer.com/mcp
  4. Las herramientas de BKlayer quedaran disponibles en tus conversaciones con Claude.

Para desarrolladores:

{
  "mcpServers": {
    "bklayer": {
      "url": "https://mcp.bklayer.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Cuenta demo

Para probar el servidor MCP con datos reales, solicita acceso a nuestra cuenta demo.

Email: reservas@bklayer.com

Asunto: Solicitud de acceso a demo MCP

La cuenta demo incluye:

  • Restaurante de prueba.
  • Peluqueria de prueba.
  • Servicios y horarios configurados.
  • Google Calendar integrado.