# Cliento MCP by usefulapi

> Cliento MCP by usefulapi is a freemium MCP server for salon management. Read-only MCP server giving AI clients access to Cliento salon stock, services and staff. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web, CLI
- **Website:** https://usefulapi.io/cliento/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/cliento
- **MCP Registry name:** io.usefulapi/cliento
- **Categories:** salon management
- **Listing updated:** 2026-11-18

## About

The server connects an AI assistant to a Cliento account through the Cliento API, using the account's own API key and read scopes. Once connected, it can look up locations, staff, bookable resources, the service catalogue with durations and prices, product stock balances, stock movement history and colour bar supplier inventory. The README notes that customer, booking and clinical records are excluded from the tool set.

Access is OAuth-based: clients are pointed at a single hosted URL, and a login page asks for a Cliento API key whose scopes were chosen when the key was created. Usage is metered per API key, with a free monthly allowance and paid Pro and Pro+ plans that are managed through the assistant itself.

The README and site describe it as aimed at salon and operations teams who run Cliento and want to answer questions about pricing, stock or resource setup in plain language. The Cliento API is described as being in Preview and may change.

## Features

- **Location and staff lookup:** Lists the locations an API key can reach, along with staff IDs, names and linked resources.
- **Service price comparison:** Shows the service catalogue with durations, prices, VAT and per-resource overrides.
- **Product stock balances:** Reports current balances for stock-tracked products, distinguishing untracked items from zero stock.
- **Stock movement history:** Lists recorded stock changes from oldest to newest, without comments or free-text reasons.
- **Colour bar inventory:** Inspects supplier ranges, shade items, barcodes and pack balances.
- **Read-only access:** All 18 data tools are marked read-only, so the assistant cannot change Cliento records.

## Good for

- Comparing how different resources price and time the same service
- Checking current stock levels for tracked products at a location
- Tracing when and how stock quantities changed for a product
- Reviewing how resources and service groups are configured
- Checking colour bar pack balances and barcodes across supplier ranges

## Install

### Claude Code (Terminal)

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

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

```sh
https://cliento.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "cliento": {
      "url": "https://cliento.usefulapi.io/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "cliento": {
      "serverUrl": "https://cliento.usefulapi.io/mcp"
    }
  }
}
```

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

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

## Tools

- `cliento_list_locations`: Locations accessible to this API key, with name, currency and time zone.
- `cliento_get_location`: One location, with name, currency and time zone.
- `cliento_list_staff`: Staff IDs, optional names and linked resource IDs.
- `cliento_list_resources`: Bookable resource catalog and online-booking settings.
- `cliento_get_resource`: One resource, including its status and online-booking settings.
- `cliento_list_resource_groups`: Resource headings in display order.
- `cliento_list_services`: Service catalog, durations, prices, VAT and per-resource overrides.
- `cliento_get_service`: One service and its per-resource overrides.
- `cliento_list_service_groups`: Service headings and their add-on marker.
- `cliento_list_resource_services`: Services as a resource offers them, including duration, price and overrides.
- `cliento_list_products`: Product catalog and current stock balances.
- `cliento_get_product`: One product and its current stock balance, when tracked.
- `cliento_list_stock_movements`: Stock changes, oldest first.
- `cliento_list_merchants`: Legal sellers at the location, with optional company registration numbers.
- `cliento_list_colour_bar_ranges`: Supplier range catalog and pack-size/list-price settings.
- `cliento_get_colour_bar_range`: One supplier range and its catalog settings.
- `cliento_list_colour_bar_items`: Shade/item catalog, barcodes and pack balances.
- `cliento_get_colour_bar_item`: One colour-bar stock item and its pack balances.

## FAQ

### Can the AI change my Cliento data?

No. The README and site state that all 18 Cliento data tools are read-only.

### What do I need to connect?

The login page asks for a Cliento API key, created on the Cliento account page with the read scopes you need.

### What does it cost?

The Free plan allows 50 tool calls a month. Pro is $9/mo or $90/yr for 10,000 calls, and Pro+ is $39/mo or $390/yr for 100,000 calls.

### Is this an official Cliento product?

No. The site says usefulapi is an independent service and is not affiliated with or endorsed by Cliento.

### Is Cliento MCP by usefulapi free?

Cliento MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Cliento MCP by usefulapi to Claude Code?

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

### What are the best alternatives to Cliento MCP by usefulapi?

The closest alternatives to Cliento MCP by usefulapi are BeautyOS by AI Beauty Bot, Mangomint MCP Server and API by Cotlet, Phorest MCP Server and API by Cotlet, DINGG MCP Server and API by Cotlet and BKG MCP by usefulapi.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [BeautyOS by AI Beauty Bot](https://ai-powered.com/mcp/beautyos-by-ai-beauty-bot): BeautyOS by AI Beauty Bot is a freemium MCP server for e-commerce.
- [Mangomint MCP Server and API by Cotlet](https://ai-powered.com/mcp/mangomint-mcp-server-and-api-by-cotlet): Mangomint MCP Server and API by Cotlet is a freemium MCP server for salon management.
- [Phorest MCP Server and API by Cotlet](https://ai-powered.com/mcp/phorest-mcp-server-and-api-by-cotlet): Phorest MCP Server and API by Cotlet is a freemium MCP server for salon management.
- [DINGG MCP Server and API by Cotlet](https://ai-powered.com/mcp/dingg-mcp-server-and-api-by-cotlet): DINGG MCP Server and API by Cotlet is a freemium MCP server for salon management.
- [BKG MCP by usefulapi](https://ai-powered.com/mcp/bkg-mcp-by-usefulapi): BKG MCP by usefulapi is a freemium MCP server for salon management.

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