Cliento MCP by usefulapi
Review Cliento locations, staff, resources, services, products and stock.
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": {
"cliento": {
"url": "https://cliento.usefulapi.io/mcp"
}
}
}Remote endpoints
https://cliento.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (18)
🟢cliento_list_locations
Preview API: Locations accessible to this API key, with name, currency and time zone. Read-only; this API may change without a version bump.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cliento_get_location(locationId)
Preview API: One location, with name, currency and time zone. Read-only; this API may change without a version bump.
Input Schema
{
"type": "object",
"properties": {
"locationId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^loc_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
}
},
"required": [
"locationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cliento_list_staff(locationId)
Preview API: Staff IDs, optional names and linked resource IDs. Omits PIN settings and secrets. Requires staff:read. Read-only; this API may change without a version bump.
Input Schema
{
"type": "object",
"properties": {
"locationId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^loc_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
}
},
"required": [
"locationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cliento_list_resources(locationId, limit, after)
Preview API: Bookable resource catalog and online-booking settings; no bookings or availability. Requires resources:read. Read-only; this API may change without a version bump.
Input Schema
{
"type": "object",
"properties": {
"locationId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^loc_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
},
"limit": {
"default": 50,
"type": "integer",
"minimum": 1,
"maximum": 200
},
"after": {
"description": "Opaque nextCursor from the same list. For stock movements an earlier movement ID also works.",
"type": "string",
"minLength": 1,
"maxLength": 4096,
"pattern": "^[^\\x00-\\x1f\\x7f]+$"
}
},
"required": [
"locationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cliento_get_resource(locationId, resourceId)
Preview API: One resource, including its status and online-booking settings. Requires resources:read. Read-only; this API may change without a version bump.
Input Schema
{
"type": "object",
"properties": {
"locationId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^loc_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
},
"resourceId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^res_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
}
},
"required": [
"locationId",
"resourceId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cliento_list_resource_groups(locationId, limit, after)
Preview API: Resource headings in display order. Requires resources:read. Read-only; this API may change without a version bump.
Input Schema
{
"type": "object",
"properties": {
"locationId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^loc_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
},
"limit": {
"default": 50,
"type": "integer",
"minimum": 1,
"maximum": 200
},
"after": {
"description": "Opaque nextCursor from the same list. For stock movements an earlier movement ID also works.",
"type": "string",
"minLength": 1,
"maxLength": 4096,
"pattern": "^[^\\x00-\\x1f\\x7f]+$"
}
},
"required": [
"locationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cliento_list_services(locationId, limit, after, resourceId)
Preview API: Service catalog, durations, prices, VAT and per-resource overrides. Omits free-text descriptions. Requires services:read. Read-only; this API may change without a version bump.
Input Schema
{
"type": "object",
"properties": {
"locationId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^loc_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
},
"limit": {
"default": 50,
"type": "integer",
"minimum": 1,
"maximum": 200
},
"after": {
"description": "Opaque nextCursor from the same list. For stock movements an earlier movement ID also works.",
"type": "string",
"minLength": 1,
"maxLength": 4096,
"pattern": "^[^\\x00-\\x1f\\x7f]+$"
},
"resourceId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^res_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
}
},
"required": [
"locationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cliento_get_service(locationId, serviceId)
Preview API: One service and its per-resource overrides, excluding free-text descriptions. Requires services:read. Read-only; this API may change without a version bump.
Input Schema
{
"type": "object",
"properties": {
"locationId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^loc_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
},
"serviceId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^svc_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
}
},
"required": [
"locationId",
"serviceId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cliento_list_service_groups(locationId, limit, after)
Preview API: Service headings and their add-on marker. Requires services:read. Read-only; this API may change without a version bump.
Input Schema
{
"type": "object",
"properties": {
"locationId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^loc_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
},
"limit": {
"default": 50,
"type": "integer",
"minimum": 1,
"maximum": 200
},
"after": {
"description": "Opaque nextCursor from the same list. For stock movements an earlier movement ID also works.",
"type": "string",
"minLength": 1,
"maxLength": 4096,
"pattern": "^[^\\x00-\\x1f\\x7f]+$"
}
},
"required": [
"locationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cliento_list_resource_services(locationId, resourceId, limit, after)
Preview API: Services as this resource offers them, including its duration, price and override settings. Requires services:read. Read-only; this API may change without a version bump.
Input Schema
{
"type": "object",
"properties": {
"locationId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^loc_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
},
"resourceId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^res_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
},
"limit": {
"default": 50,
"type": "integer",
"minimum": 1,
"maximum": 200
},
"after": {
"description": "Opaque nextCursor from the same list. For stock movements an earlier movement ID also works.",
"type": "string",
"minLength": 1,
"maxLength": 4096,
"pattern": "^[^\\x00-\\x1f\\x7f]+$"
}
},
"required": [
"locationId",
"resourceId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cliento_list_products(locationId, limit, after, ean, articleNumber)
Preview API: Product catalog and current stock balances. Cost fields appear only with stock:cost; omitted balances mean the product is not stock-tracked. Requires products:read. Read-only; this API may change without a version bump.
Input Schema
{
"type": "object",
"properties": {
"locationId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^loc_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
},
"limit": {
"default": 50,
"type": "integer",
"minimum": 1,
"maximum": 200
},
"after": {
"description": "Opaque nextCursor from the same list. For stock movements an earlier movement ID also works.",
"type": "string",
"minLength": 1,
"maxLength": 4096,
"pattern": "^[^\\x00-\\x1f\\x7f]+$"
},
"ean": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"articleNumber": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"locationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cliento_get_product(locationId, productId)
Preview API: One product and its current stock balance, when tracked. Cost fields need stock:cost. Requires products:read. Read-only; this API may change without a version bump.
Input Schema
{
"type": "object",
"properties": {
"locationId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^loc_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
},
"productId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^prd_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
}
},
"required": [
"locationId",
"productId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cliento_list_stock_movements(locationId, limit, after, productId, colourBarItemId, ...)
Preview API: Stock changes, oldest first, omitting comments, visit/external references, colour-mix links and free-text reasons. Movements may appear about ten seconds after creation. Requires stock:read. Read-only; this API may change without a version bump.
Input Schema
{
"type": "object",
"properties": {
"locationId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^loc_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
},
"limit": {
"default": 50,
"type": "integer",
"minimum": 1,
"maximum": 200
},
"after": {
"description": "Opaque nextCursor from the same list. For stock movements an earlier movement ID also works.",
"type": "string",
"minLength": 1,
"maxLength": 4096,
"pattern": "^[^\\x00-\\x1f\\x7f]+$"
},
"productId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^prd_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
},
"colourBarItemId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^cbi_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
},
"type": {
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"required": [
"locationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cliento_list_merchants(locationId)
Preview API: Legal sellers at the location, with optional company registration numbers. No payment or gift-card data. Read-only; this API may change without a version bump.
Input Schema
{
"type": "object",
"properties": {
"locationId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^loc_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
}
},
"required": [
"locationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cliento_list_colour_bar_ranges(locationId, limit, after)
Preview API: Supplier range catalog and pack-size/list-price settings; no personal recipes or colour mixes. Requires products:read. Read-only; this API may change without a version bump.
Input Schema
{
"type": "object",
"properties": {
"locationId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^loc_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
},
"limit": {
"default": 50,
"type": "integer",
"minimum": 1,
"maximum": 200
},
"after": {
"description": "Opaque nextCursor from the same list. For stock movements an earlier movement ID also works.",
"type": "string",
"minLength": 1,
"maxLength": 4096,
"pattern": "^[^\\x00-\\x1f\\x7f]+$"
}
},
"required": [
"locationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cliento_get_colour_bar_range(locationId, colourBarRangeId)
Preview API: One supplier range and its catalog settings; no personal recipes or colour mixes. Requires products:read. Read-only; this API may change without a version bump.
Input Schema
{
"type": "object",
"properties": {
"locationId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^loc_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
},
"colourBarRangeId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^cbr_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
}
},
"required": [
"locationId",
"colourBarRangeId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cliento_list_colour_bar_items(locationId, limit, after, rangeId, ean, ...)
Preview API: Shade/item catalog, barcodes and pack balances. Choose at most one of rangeId, ean or articleNumber; no recipe or mix data. Requires products:read. Read-only; this API may change without a version bump.
Input Schema
{
"type": "object",
"properties": {
"locationId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^loc_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
},
"limit": {
"default": 50,
"type": "integer",
"minimum": 1,
"maximum": 200
},
"after": {
"description": "Opaque nextCursor from the same list. For stock movements an earlier movement ID also works.",
"type": "string",
"minLength": 1,
"maxLength": 4096,
"pattern": "^[^\\x00-\\x1f\\x7f]+$"
},
"rangeId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^cbr_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
},
"ean": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"articleNumber": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"locationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢cliento_get_colour_bar_item(locationId, colourBarItemId)
Preview API: One colour-bar stock item and its pack balances; no personal recipes or mixes. Requires products:read. Read-only; this API may change without a version bump.
Input Schema
{
"type": "object",
"properties": {
"locationId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^loc_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
},
"colourBarItemId": {
"type": "string",
"minLength": 5,
"maxLength": 512,
"allOf": [
{
"pattern": "^cbi_.*"
},
{
"pattern": "^[^\\x00-\\x20\\x7f/\\\\]+$"
}
]
}
},
"required": [
"locationId",
"colourBarItemId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence