BKG MCP by usefulapi
Read services, staff, bookings and clients; create and cancel bookings in BKG.
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"bkg": {
"url": "https://bkg.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://bkg.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール(15)
🟢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.
入力スキーマ
{
"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.
入力スキーマ
{
"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}.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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}.
入力スキーマ
{
"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.
入力スキーマ
{
"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}.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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"
}コミュニティ
エビデンス