# Buk.ng MCP by usefulapi

> Buk.ng MCP by usefulapi is an MCP server. List services, customers and bookings, and read booking page insights in Buk.ng. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/buk-ng/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/buk-ng
- **MCP Registry name:** io.usefulapi/buk-ng
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://buk-ng.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "buk-ng": {
      "url": "https://buk-ng.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

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

---
Source: https://ai-powered.com/mcp/buk-ng-mcp-by-usefulapi
