YCLIENTS MCP server
YCLIENTS MCP Server
An MCP server for YCLIENTS with 30-plus tools covering companies, services, staff, clients, bookings, online booking and analytics
High risk
We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.
Why this level
- Tools create, change and delete records, staff and clients in the company's live database
- The partner token grants broad access to the company's YCLIENTS data
Install
Manual install
docker compose up -dThe project ships a Dockerfile and docker-compose.yaml with a ready nginx proxy.
This is third-party code. Review the repository files before installing.
What it does
The server wraps the REST API of YCLIENTS, a booking and CRM platform for service businesses, in MCP tools grouped by companies, services, staff, clients, records, online booking, schedules and analytics like daily revenue and a Z-report. It runs over stdio and Streamable HTTP, the latter compatible with Timeweb Cloud AI agents. It has a built-in rate limiter at 5 requests per second and 200 per minute to respect YCLIENTS API limits. Access needs a YCLIENTS partner token.
Who it is for. For owners and admins of salons, clinics and other service businesses on YCLIENTS who want to manage bookings and analytics through an agent.
Good fit when
- You want to create, change and cancel client bookings through an agent
- You need daily analytics on revenue, records and staff workload
- You need YCLIENTS access from Timeweb Cloud agents over HTTP
Not a fit when
- You do not have a YCLIENTS partner token: it can only be obtained through the developer marketplace
- You do not want to host your own server: the project offers no managed cloud hosting
Example request
Show daily revenue for the last week and find the nearest open slots for stylist IvanovaLimitations
You need Python 3.10 or newer and a YCLIENTS partner token from the developer marketplace. The rate limiter is hardcoded to the API limits and can slow down bulk operations. The staff and client creation/deletion tools write to the company's live database; a mistaken call has to be fixed manually in the YCLIENTS interface.
How to disable. Remove the yclients server from your MCP client config and revoke the partner token in your YCLIENTS account.
MCP
- Transport
- stdio, http
- Authentication
- API key
| Environment variables | |
|---|---|
| YCLIENTS_PARTNER_TOKEN required, secret | Partner token from the YCLIENTS developer marketplace |
Security check
- Tools create, change and delete records, staff and clients in the company's live database
- The partner token grants broad access to the company's YCLIENTS data
README in short
The README lists 30-plus tools by section: companies, services, staff, clients, records, online booking, schedule and analytics including daily revenue and a Z-report. It notes compatibility with Timeweb Cloud AI agents via Streamable HTTP, a built-in rate limiter, and install requirements: Python 3.10+ and a partner token from the YCLIENTS developer marketplace.
FAQ
Can it connect to Timeweb Cloud agents?
Yes, the server supports Streamable HTTP transport, compatible with Timeweb Cloud AI agents, and the repo includes a ready timeweb-app.yaml.
Where do I get the token?
The partner token is issued in the YCLIENTS developer marketplace.
Related
Salesforce's official DX MCP server: work with orgs, metadata, data, users and Apex tests from your agent
Yandex Kit skills for store management
kit-skills
Yandex's official skill set: catalog, prices, stock, orders, storefront and a weekly checkup for a Yandex Kit store, through Claude Code or Codex
YouGile MCP by Indalo
YouGile MCP
Full 65-operation YouGile API coverage with configurable permissions, write confirmation and a shared company rate limit
Bitrix24 portal MCP server
MCP-сервер портала Битрикс24
Bitrix24's official per-portal MCP: an external agent uses OAuth or a token to read and change tasks, deals, meetings and mail