Skip to content
MCP server

Buk.ng MCP by usefulapi

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

Install
Runs
Remotely
Version
1.4.0
Listing updated
4 days ago

About Buk.ng MCP by usefulapi

Buk.ng MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http buk-ng https://buk-ng.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://buk-ng.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "buk-ng": {
      "url": "https://buk-ng.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "buk-ng": {
      "type": "http",
      "url": "https://buk-ng.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "buk-ng": {
      "serverUrl": "https://buk-ng.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "buk-ng": {
      "type": "http",
      "url": "https://buk-ng.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (6)

Read directly from the server.

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.
buk_list_services
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.
buk_list_customers
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.
buk_list_bookings
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.
buk_get_insights
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.
buk_get_website_insights
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.

Buk.ng MCP by usefulapi FAQ

How do I add Buk.ng MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http buk-ng https://buk-ng.usefulapi.io/mcp