Home

MCP Documentation

BKlayer MCP — Booking Infrastructure for AI Agents

BKlayer MCP server enables AI agents like Claude, ChatGPT and others to search businesses, check real availability and create bookings through a secure, GDPR-compliant API.

Section 1 — What is BKlayer MCP?

BKlayer is a booking infrastructure platform that connects AI agents to real local businesses. Through the BKlayer MCP server, agents like Claude can search businesses, check real-time availability, and create, manage or cancel bookings on behalf of users — all through a secure, structured API.

MCP Server URL: https://mcp.bklayer.com/mcp

Transport: Streamable HTTP (MCP spec compliant)

Privacy Policy: https://www.bklayer.com/privacy

Contact: reservas@bklayer.com

Section 2 — Available Tools (13 tools)

BKlayer MCP exposes read-only discovery tools and mutation tools for booking operations. The table below includes all tool names, behavior, and required inputs.

#ToolDescriptionInputsTypeFlags
1search_businessSearch for businesses by name, category or city.

q (string)

city (string, optional)

category (string, optional)

READ-ONLY
ReadOnly: true
2get_business_profileGet the public profile of a business including name, description, category, city and contact info.

idOrSlug (string)

READ-ONLY
ReadOnly: true
3get_business_policiesGet the booking policies of a business (cancellation, payment, timing).

idOrSlug (string)

READ-ONLY
ReadOnly: true
4list_business_servicesList all active services offered by a business, including duration and metadata.

idOrSlug (string)

READ-ONLY
ReadOnly: true
5list_business_staffList all active staff members for a business. Use to let the user choose a professional.

idOrSlug (string)

READ-ONLY
ReadOnly: true
6check_availabilityCheck real-time availability for a business on a specific date. Returns available time slots with staff metadata.

idOrSlug (string)

date (string YYYY-MM-DD)

serviceId (string, optional)

staffId (string, optional)

party_size (number, optional)

meal_period (string, optional)

READ-ONLY
ReadOnly: true
7search_customer_bookingsSearch bookings for a customer by phone. Requires OTP verification.

idOrSlug (string)

phone (string)

verification_code (string)

READ-ONLY
ReadOnly: true
8get_booking_detailsGet full details of a specific booking by reference. Returns service, staff, date, time, customer name and status.

idOrSlug (string)

booking_reference (string)

customer_verification (object)

READ-ONLY
ReadOnly: true
9create_bookingCreate a confirmed booking. Requires explicit user confirmation before calling. Never call without showing a summary and receiving confirmation.

idOrSlug (string)

serviceId (string)

date (string)

time (string)

customerName (string)

customerPhone (string)

staffId (string, optional)

notes (string, optional)

confirmation_summary_presented (boolean)

confirmation_obtained (boolean)

user_confirmation_text (string)

MUTATION
Destructive: false
10reschedule_bookingReschedule an existing booking to a new date and time. Requires OTP verification and explicit user confirmation.

idOrSlug (string)

booking_reference (string)

new_date (string)

new_time (string)

customer_verification (object)

confirmation_summary_presented (boolean)

confirmation_obtained (boolean)

user_confirmation_text (string)

MUTATION
Destructive: true
11request_customer_booking_verification_codeSend an OTP verification code to the customer's phone. Required before cancellations and booking lookups.

idOrSlug (string)

phone (string)

MUTATION
Destructive: false
12cancel_bookingCancel an existing booking. Requires OTP verification and explicit user confirmation. Never cancel without confirmation.

idOrSlug (string)

booking_reference (string)

customer_verification (object)

confirmation_summary_presented (boolean)

confirmation_obtained (boolean)

user_confirmation_text (string)

MUTATION
Destructive: true
13add_booking_noteAdd an observation or note to an existing booking. Cannot be used to change date, time, service or staff.

idOrSlug (string)

booking_reference (string)

note (string)

note_type (string)

customer_verification (object)

confirmation_summary_presented (boolean)

confirmation_obtained (boolean)

user_confirmation_text (string)

MUTATION
Destructive: false

Section 3 — Usage Examples

Example 1 — Find a business and check availability

User: "Book a haircut at Peluquería Loli tomorrow afternoon"

Agent flow

  1. search_business → finds "Peluquería Loli"
  2. list_business_services → finds "Corte de pelo"
  3. check_availability → date: tomorrow, returns available slots for afternoon
  4. Agent presents options to user
  5. User confirms time and name
  6. create_booking → booking confirmed, reference BK-XXXX returned

create_booking example payload

{
  "idOrSlug": "peluqueria-loli",
  "serviceId": "service_uuid",
  "date": "2026-05-21",
  "time": "16:00",
  "customerName": "María García",
  "customerPhone": "+34600000000",
  "notes": "Prefiero corte en capas",
  "confirmation_summary_presented": true,
  "confirmation_obtained": true,
  "user_confirmation_text": "confirmo"
}

Example 2 — Restaurant reservation

User: "Reserve a table for 4 at El Fermín for dinner on Friday"

Agent flow

  1. search_business → finds "Restaurante El Fermín"
  2. check_availability → date: Friday, meal_period: dinner, party_size: 4
  3. Agent presents available slots
  4. User confirms time and name
  5. create_booking with party_size=4, meal_period=dinner

Example 3 — Check and cancel a booking

User: "Cancel my appointment at Estética Avanzada"

Agent flow

  1. request_customer_booking_verification_code → sends OTP to customer phone
  2. User provides OTP
  3. search_customer_bookings → finds booking BK-XXXX
  4. Agent shows booking details and asks for confirmation
  5. User confirms cancellation
  6. cancel_booking → booking cancelled

Section 4 — Security & Privacy

Security

  • All mutations require explicit user confirmation (confirmation_obtained: true)
  • OTP verification required for cancellations and booking lookups
  • No internal UUIDs exposed to agents — public booking references (BK-XXXX) only
  • Origin validation on all MCP requests
  • HTTPS/TLS on all connections
  • Timeout: 25 seconds per tool call

Section 5 — Connect BKlayer to Claude

Instructions for claude.ai:

  1. Go to claude.ai → Settings → Connectors
  2. Click "Add connector"
  3. Enter MCP server URL: https://mcp.bklayer.com/mcp
  4. BKlayer tools will be available in your Claude conversations

For developers (code):

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

Section 6 — Demo Account

To test the MCP server with real data, you can request access to our demo account.

Email: reservas@bklayer.com

Subject: MCP Demo Access Request

Demo account includes:

  • Restaurante de prueba: El Fermín (Alcorcón)
  • Negocio de estética: Estética Avanzada (Alcorcón)
  • Servicios y horarios configurados
  • Google Calendar integrado