Buk.ng MCP by usefulapi
List services, customers and bookings, and read booking page insights in Buk.ng.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"buk-ng": {
"url": "https://buk-ng.usefulapi.io/mcp"
}
}
}Remote endpoints
https://buk-ng.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (6)
🟢buk_get_account
Show the permissions (scopes) and mode (live or test) of the connected Buk.ng API key, and the business's name and timezone. Call it first to confirm the connection. Buk.ng API: GET /v1/me.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢buk_list_services(active)
List everything the business offers: name, description, duration in minutes, price (a decimal string in NGN) and whether it is bookable now. Not paged. Set active to true for bookable services only. Buk.ng API: GET /v1/services.
Input Schema
{
"type": "object",
"properties": {
"active": {
"description": "true = only services that can be booked now. Omit for all.",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢buk_list_customers(email, phone, limit, cursor)
List the business's customer records (id, name, phone, email, createdAt). Returns personal data. Look up one customer with email or phone, or page through all of them. One page per call: pass nextCursor back as cursor until it is null. Buk.ng API: GET /v1/customers.
Input Schema
{
"type": "object",
"properties": {
"email": {
"description": "Look up one customer by email (exact, not case-sensitive).",
"type": "string",
"maxLength": 254
},
"phone": {
"description": "Customer phone in international format, e.g. +2348031234567.",
"type": "string",
"pattern": "^\\+[1-9]\\d{6,14}$"
},
"limit": {
"description": "Items per page, 1 to 100 (default 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "nextCursor from the previous page. Omit on the first page. Pass it back unchanged.",
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢buk_list_bookings(from, to, status, externalReference, limit, ...)
List appointments, newest first, with service, customer, staff (may be null), location, payment and join link. Filter by date range, status or your own externalReference. One page per call (up to 100): pass nextCursor back as cursor until it is null. Buk.ng API: GET /v1/bookings.
Input Schema
{
"type": "object",
"properties": {
"from": {
"description": "Only bookings that start on or after this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"to": {
"description": "Only bookings that start on or before this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"status": {
"description": "Only bookings with this status. Omit for all statuses.",
"type": "string",
"enum": [
"PENDING_APPROVAL",
"CONFIRMED",
"COMPLETED",
"CANCELLED"
]
},
"externalReference": {
"description": "Your own booking id. Returns that booking only.",
"type": "string",
"maxLength": 200
},
"limit": {
"description": "Items per page, 1 to 100 (default 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "nextCursor from the previous page. Omit on the first page. Pass it back unchanged.",
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢buk_get_insights(days)
Get visits to the business's booking page, Explore profile and website, where visitors came from, and what they did next. The response also has the previous period for comparison. Aggregates only. Needs a paid plan (Starter and above). Buk.ng API: GET /v1/insights.
Input Schema
{
"type": "object",
"properties": {
"days": {
"description": "Report period in days: 7, 30 or 90 (default 30).",
"anyOf": [
{
"type": "number",
"const": 7
},
{
"type": "number",
"const": 30
},
{
"type": "number",
"const": 90
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢buk_get_website_insights(days)
Get the live visit figures for the business's website (this hour and today against the usual) and the period report with top pages, devices and tips. Returns connected: false when no website reports to Buk. Needs a paid plan. Buk.ng API: GET /v1/website-insights.
Input Schema
{
"type": "object",
"properties": {
"days": {
"description": "Report period in days: 7, 30 or 90 (default 30).",
"anyOf": [
{
"type": "number",
"const": 7
},
{
"type": "number",
"const": 30
},
{
"type": "number",
"const": 90
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence