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
- 0 ★ on the repository
- Last commit
- MIT
Broad access
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
- Works in
- Services
Manual install
docker compose up -dThe project ships a Dockerfile and docker-compose.yaml with a ready nginx proxy.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- 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
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 IvanovaMCP
- Transport
- stdio, http
- Authentication
- API key
Environment variables
YCLIENTS_PARTNER_TOKENrequired, secret- Partner token from the YCLIENTS developer marketplace
Limitations
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.
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.
Discussion
No questions or reviews yet.
Related
All YCLIENTS toolsYCLIENTS MCP server
YCLIENTS MCP Server
An MCP server for the YCLIENTS booking platform: services, staff, clients, appointments and analytics for salons and service businesses
YClients and Ozon MCP servers, one deployment
MCP Servers — Combined Deployment
A docker-compose deployment of two MCP servers behind one nginx: full YClients booking API access and an Ozon storefront reader via a headless browser
Timeweb Cloud's official remote MCP: account servers, databases, Kubernetes, domains, mail, S3 and billing, with mandatory confirmation for changes
Timeweb Cloud MCP server with 245 tools
Timeweb Cloud MCP Server
A broad Timeweb Cloud MCP server: 245 tools across servers, Kubernetes, databases, S3, domains, mail and billing
Timeweb Cloud MCP: full API coverage
Timeweb MCP Server
An MCP server with full Timeweb Cloud API coverage: servers, databases, Kubernetes, S3, domains and DNS, SSH keys, floating IPs and billing
Timeweb Cloud domains MCP
timeweb-cloud-mcp-server
An MCP for the Timeweb Cloud API: domains, subdomains, DNS records, name servers and the full domain registration, renewal and transfer flow
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.