SkillFoxx

YCLIENTS MCP server

YCLIENTS MCP Server

An MCP server for the YCLIENTS booking platform: services, staff, clients, appointments and analytics for salons and service businesses

  • 2 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • Can create, edit and delete clients, staff and appointments
  • The partner and user tokens grant broad access to the company's YCLIENTS data
All reasons and checks
Russian stack

greenrun666/yclients-mcp-serverAuthor:greenrun666

Install

Services

Manual install

uv sync

Installs dependencies after cloning the repository.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • Can create, edit and delete clients, staff and appointments
  • The partner and user tokens grant 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 YCLIENTS REST API with more than thirty tools across seven areas: companies, services and their categories, staff and positions, client search and records with visit history, service appointments, the full online booking flow from available dates and slots to creating a booking, staff schedules and workload, and analytics with daily revenue, a Z-report and appointment breakdowns by source and status. A client-side rate limit of 5 requests per second and 200 per minute keeps it within API limits. The server runs over stdio locally or as an HTTP service, with a ready integration and panel config for Timeweb Cloud AI agents.

Who it is for. For owners of salons, clinics and service businesses on YCLIENTS who want to manage bookings, clients and analytics through an agent.

Good fit when

  • You want to quickly create or change a client's service appointment
  • You need analytics on revenue, workload or appointment sources for a period
  • You want to find the nearest available slots for a specific staff member

Not a fit when

  • You do not have a YCLIENTS partner token, issued through the YCLIENTS marketplace
  • You do not want to grant an agent the ability to delete staff, clients and records: these tools have no separate read-only restriction

Example request

Create a booking for a client's haircut tomorrow at 2pm and show last week's revenue

MCP

Transport
stdio, http
Authentication
API key

Environment variables

YCLIENTS_PARTNER_TOKEN required, secret
Partner token, issued through the YCLIENTS marketplace.
YCLIENTS_USER_TOKEN secret
User token, needed for some operations.

Limitations

The project has a single author, and the README's clone command still has a YOUR_USERNAME placeholder instead of the real path. It needs a partner token, and some operations additionally need a user token. The README does not detail token permissions or which tools work without admin rights.

How to disable. Stop the server process or container and remove it from your MCP client config or the Timeweb AI agents panel.

FAQ

Can the server run in Docker?

Yes, there is a Dockerfile, built with docker build -t yclients-mcp-server . and run with the YCLIENTS_PARTNER_TOKEN and YCLIENTS_USER_TOKEN variables.

Is Timeweb Cloud integration supported?

Yes, the README describes connecting the deployed server in the Timeweb Cloud panel's AI agents, MCP servers section over HTTP.

Discussion

No questions or reviews yet.

All YCLIENTS tools

YCLIENTS MCP server

YCLIENTS MCP Server

Russian stack

An MCP server for YCLIENTS with 30-plus tools covering companies, services, staff, clients, bookings, online booking and analytics

MCP serverBroad access

YClients and Ozon MCP servers, one deployment

MCP Servers — Combined Deployment

Russian stack

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

MCP serverBroad access
Russian stack

An MCP server for the JivoSite live chat: customer conversations, contacts, agents and webhooks through an AI agent

MCP serverExtended access
Russian stack

A Yandex Market Partner API MCP server for sellers: orders, returns, listings, prices, reports, reviews and chats

MCP serverBroad access3
Russian stack

An MCP server for the InSales online store platform: products, orders, customers and categories via the admin API

MCP serverBroad access1

README in short

The Russian README lists more than thirty tools across companies, services, staff, clients, records, online booking, schedules and analytics, gives installation via uv or pip, stdio and HTTP launch, a Docker run and step-by-step Timeweb Cloud AI agents panel setup. It separately notes client-side rate limiting and a recommendation not to store tokens in code.

README badge

Report a problem