Buk.ng MCP by usefulapi

List services, customers and bookings, and read booking page insights in Buk.ng.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
73%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,164Tokens (tool definitions)
~1.1 KBTypical response size
Moderate attention impact (0.91% of 128k context)

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-http

What it can do

Tool inventory

Tools (6)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded6 tools