BKG MCP by usefulapi

Read services, staff, bookings and clients; create and cancel bookings in BKG.

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
100%
Vollständigkeit des Schemas
89%
Qualität der Benennung
80%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~2,560Tokens (Tool-Definitionen)
~1.4 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (2.00% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

{
  "mcpServers": {
    "bkg": {
      "url": "https://bkg.usefulapi.io/mcp"
    }
  }
}

Remote-Endpunkte

https://bkg.usefulapi.io/mcpstreamable-http

Was es kann

Tool-Inventar

Tools (15)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢bkg_me

Show which salon the API key belongs to, its scopes and its rate limit. Use it first to confirm the connection. BKG API: GET /me.

Eingabe-Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bkg_list_services(include_inactive, cursor, limit)

List the services the salon sells (name, duration, price, category). BKG API: GET /services.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "include_inactive": {
      "description": "Also list services that are switched off (default false).",
      "type": "boolean"
    },
    "cursor": {
      "description": "meta.next_cursor from the previous page.",
      "type": "string"
    },
    "limit": {
      "description": "Page size, 1 to 200.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bkg_get_service(service_id)

Get one service by id, with its duration, price and rules. BKG API: GET /services/{service_id}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "service_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 36,
      "description": "The service id (from bkg_list_services)."
    }
  },
  "required": [
    "service_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bkg_list_staff(include_inactive, cursor, limit)

List the staff members (employees) of the salon. BKG API: GET /staff.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "include_inactive": {
      "description": "Also list inactive staff (default false).",
      "type": "boolean"
    },
    "cursor": {
      "description": "meta.next_cursor from the previous page.",
      "type": "string"
    },
    "limit": {
      "description": "Page size, 1 to 200.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bkg_list_locations(cursor, limit)

List the salon's locations (branches). BKG API: GET /locations.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "description": "meta.next_cursor from the previous page.",
      "type": "string"
    },
    "limit": {
      "description": "Page size, 1 to 200.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bkg_get_staff_schedule(start, end, staff_id)

Get the planned working hours per day for staff, with days off and special days applied. Range: at most 62 days. BKG API: GET /staff/schedule.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "start": {
      "type": "string",
      "description": "First day, salon-local, YYYY-MM-DD."
    },
    "end": {
      "type": "string",
      "description": "Last day, inclusive, YYYY-MM-DD (at most 62 days after start)."
    },
    "staff_id": {
      "description": "Only this staff member.",
      "type": "string",
      "minLength": 1,
      "maxLength": 36
    }
  },
  "required": [
    "start",
    "end"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bkg_search_availability(service_id, date, date_to, staff_id, location_id)

Find free booking times for a service on a day or a range of up to 14 days. Use it before bkg_create_booking. BKG API: GET /availability.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "service_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 36,
      "description": "The service to book (from bkg_list_services)."
    },
    "date": {
      "type": "string",
      "description": "First day, salon-local, YYYY-MM-DD."
    },
    "date_to": {
      "description": "Last day, inclusive, at most 14 days after date.",
      "type": "string"
    },
    "staff_id": {
      "description": "Only this staff member. Omit for anyone who performs the service.",
      "type": "string",
      "minLength": 1,
      "maxLength": 36
    },
    "location_id": {
      "description": "Only this location.",
      "type": "string",
      "minLength": 1,
      "maxLength": 36
    }
  },
  "required": [
    "service_id",
    "date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bkg_list_bookings(start, end, status, client_id, staff_id, ...)

List bookings, filtered by time range, status, client, staff or service. BKG API: GET /bookings.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "start": {
      "description": "Bookings that start at or after this salon-local time, e.g. 2026-11-18T00:00:00.",
      "type": "string"
    },
    "end": {
      "description": "Bookings that start before this salon-local time.",
      "type": "string"
    },
    "status": {
      "description": "Booking status filter, as the salon's status names.",
      "type": "string"
    },
    "client_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 36
    },
    "staff_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 36
    },
    "service_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 36
    },
    "cursor": {
      "description": "meta.next_cursor from the previous page.",
      "type": "string"
    },
    "limit": {
      "description": "Page size, 1 to 200.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "updated_since": {
      "description": "Only records changed at or after this ISO 8601 time. Results then sort by updated_at (use for sync).",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bkg_get_booking(booking_id)

Get one booking by id: service, staff, location, time, status and price. BKG API: GET /bookings/{booking_id}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 36,
      "description": "The booking id (from bkg_list_bookings)."
    }
  },
  "required": [
    "booking_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bkg_list_clients(q, email, phone, cursor, limit, ...)

Search clients by name, email or phone, or list them. BKG API: GET /clients.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Name, email or phone contains this text.",
      "type": "string",
      "maxLength": 200
    },
    "email": {
      "description": "Exact email.",
      "type": "string",
      "maxLength": 254
    },
    "phone": {
      "description": "Exact phone.",
      "type": "string",
      "maxLength": 40
    },
    "cursor": {
      "description": "meta.next_cursor from the previous page.",
      "type": "string"
    },
    "limit": {
      "description": "Page size, 1 to 200.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "updated_since": {
      "description": "Only records changed at or after this ISO 8601 time. Results then sort by updated_at (use for sync).",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bkg_get_client(client_id)

Get one client by id: contact details and notes. BKG API: GET /clients/{client_id}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "client_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 36,
      "description": "The client id (from bkg_list_clients)."
    }
  },
  "required": [
    "client_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢bkg_list_payments(booking_id, status, cursor, limit, updated_since)

List payments, optionally for one booking or status. BKG API: GET /payments.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 36
    },
    "status": {
      "description": "Payment status filter, as the salon's status names.",
      "type": "string"
    },
    "cursor": {
      "description": "meta.next_cursor from the previous page.",
      "type": "string"
    },
    "limit": {
      "description": "Page size, 1 to 200.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "updated_since": {
      "description": "Only records changed at or after this ISO 8601 time. Results then sort by updated_at (use for sync).",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴bkg_create_booking(service_id, starts_at, client_id, staff_id, location_id, ...)

Create a booking at a free time from bkg_search_availability. Writes to the salon's calendar. BKG API: POST /bookings.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "service_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 36,
      "description": "The service to book."
    },
    "starts_at": {
      "type": "string",
      "description": "Salon-local start time, e.g. 2026-11-02T10:30:00 (no offset)."
    },
    "client_id": {
      "description": "An existing client id (from bkg_list_clients).",
      "type": "string",
      "minLength": 1,
      "maxLength": 36
    },
    "staff_id": {
      "description": "Omit for 'any available'; the service rule then assigns staff.",
      "type": "string",
      "minLength": 1,
      "maxLength": 36
    },
    "location_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 36
    },
    "notes": {
      "description": "Note for the booking.",
      "type": "string",
      "maxLength": 2000
    },
    "coupon_code": {
      "type": "string",
      "maxLength": 64
    },
    "accept_policy": {
      "description": "Set true only when the client accepted the salon's cancellation terms (see GET /policy). Needed when the service has a policy.",
      "type": "boolean"
    },
    "idempotency_key": {
      "description": "Optional unique key (a UUID is ideal). Omit it to get a new key for this call.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "service_id",
    "starts_at"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴bkg_cancel_booking(booking_id, idempotency_key)

Cancel one booking. The salon's cancellation terms apply. BKG API: POST /bookings/{booking_id}/cancel.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 36,
      "description": "The booking id to cancel."
    },
    "idempotency_key": {
      "description": "Optional unique key (a UUID is ideal). Omit it to get a new key for this call.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "booking_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴bkg_create_client(first_name, last_name, email, phone, notes, ...)

Create a client record with contact details and notes. BKG API: POST /clients.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "first_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "last_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "email": {
      "type": "string",
      "maxLength": 254
    },
    "phone": {
      "type": "string",
      "maxLength": 40
    },
    "notes": {
      "type": "string",
      "maxLength": 2000
    },
    "locale": {
      "description": "Language for client messages, e.g. da, en.",
      "type": "string",
      "maxLength": 10
    },
    "idempotency_key": {
      "description": "Optional unique key (a UUID is ideal). Omit it to get a new key for this call.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "first_name",
    "last_name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet15 Tools