Kaio
Find and book local businesses in Italy on Kaio: real free times, booking, online payment link.
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": {
"kaio": {
"url": "https://api.website.prod.akaion.com/mcp/kaio"
}
}
}Remote endpoints
https://api.website.prod.akaion.com/mcp/kaiostreamable-httpWhat it can do
Tool inventory
Tools (4)
🟢search_kaio_businesses(what, where)
Find businesses that can be booked online with Kaio. `what`: the kind of business or treatment ("estetista", "pulizia viso", "idraulico"); `where`: town, province or area ("Lecco", "Brianza"). Returns name, slug, address, Google rating, website, booking link and services with prices.
Input Schema
{
"type": "object",
"properties": {
"what": {
"default": "",
"title": "What",
"type": "string"
},
"where": {
"default": "",
"title": "Where",
"type": "string"
}
},
"title": "search_kaio_businessesArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "search_kaio_businessesOutput"
}🟢get_kaio_business(slug)
A Kaio business by its slug (from search_kaio_businesses): description, timezone, booking link and services with their ids, duration and price — the ids are what kaio_free_slots and booking need.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"title": "Slug",
"type": "string"
}
},
"required": [
"slug"
],
"title": "get_kaio_businessArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "get_kaio_businessOutput"
}🟢kaio_free_slots(slug, service_id, start_date, end_date)
Real free times of a Kaio business for one service (id from get_kaio_business), dates YYYY-MM-DD, at most a couple of weeks at a time. These are the same slots its booking page shows.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"title": "Slug",
"type": "string"
},
"service_id": {
"title": "Service Id",
"type": "string"
},
"start_date": {
"title": "Start Date",
"type": "string"
},
"end_date": {
"title": "End Date",
"type": "string"
}
},
"required": [
"slug",
"service_id",
"start_date",
"end_date"
],
"title": "kaio_free_slotsArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "kaio_free_slotsOutput"
}⚪book_kaio_appointment(slug, service_id, start_time, name, phone, ...)
Book an appointment at a Kaio business. `start_time` is one of the slots from kaio_free_slots (ISO 8601 with offset). A phone or an email is required: the business uses it to confirm and remind. Only call this after the person has confirmed business, service, day, time and contact details.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"title": "Slug",
"type": "string"
},
"service_id": {
"title": "Service Id",
"type": "string"
},
"start_time": {
"title": "Start Time",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Phone"
},
"email": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Email"
},
"notes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Notes"
}
},
"required": [
"slug",
"service_id",
"start_time",
"name"
],
"title": "book_kaio_appointmentArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "book_kaio_appointmentOutput"
}Community
Evidence