yourept-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@yourept-mcp What were total payments and payouts last month?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
yourept-mcp
MCP server for the YOUREPT CRM. Connects to Claude, Cursor, Codex and other MCP clients and gives the agent access to admin panel data — leads, students, teachers, lessons, payments, payouts and financial reports.
Questions it exists to answer:
"How much did we earn this month and how much went to payouts?" "Which leads are overdue and with which manager?" "Show students who haven't had lessons for two weeks" "Which teachers haven't signed a deal in Рокет Ворк"
In other words, the things for which you'd have to open three sections in the interface and reconcile the numbers by hand.
Installation
1. Get a key
In the admin panel: Settings → API keys → Create key. The key is shown once — copy it right away. Lost it? Issue a new one and revoke the old one.
The key works on behalf of the employee who issued it and with their permissions: sections closed to the person are also closed to the agent. A read-only key (by default) physically cannot change anything in the CRM.
2. Add the server to your program
Nothing needs to be installed separately — npx will download the package itself.
The package is installed directly from GitHub. After publishing to npm, instead of
github:Skamatoz/yourept-mcpyou can simply writeyourept-mcp.
Claude Desktop — Settings → Developer → Edit Config:
{
"mcpServers": {
"yourept": {
"command": "npx",
"args": ["-y", "github:Skamatoz/yourept-mcp"],
"env": {
"YOUREPT_API_URL": "https://api-admin.yourept.ru",
"YOUREPT_API_KEY": "yrp_live_ваш_ключ"
}
}
}
}Claude Code:
claude mcp add yourept \
--env YOUREPT_API_URL=https://api-admin.yourept.ru \
--env YOUREPT_API_KEY=yrp_live_ваш_ключ \
-- npx -y github:Skamatoz/yourept-mcpCursor — file ~/.cursor/mcp.json, same format as Claude Desktop.
Codex — file ~/.codex/config.toml:
[mcp_servers.yourept]
command = "npx"
args = ["-y", "github:Skamatoz/yourept-mcp"]
[mcp_servers.yourept.env]
YOUREPT_API_URL = "https://api-admin.yourept.ru"
YOUREPT_API_KEY = "yrp_live_ваш_ключ"After editing the config, restart the program.
Related MCP server: MoyKlass MCP Server
What it can do
Tool | Description |
| search across the entire CRM: people, leads, payments, payouts |
| leads, including problem groups |
| students and their contracts |
| teachers, rates, self-employed status |
| lessons for a period, including unmarked ones |
| contracts, rates, balance remaining |
| employee tasks and quality control checks |
| AI scores for trial lessons |
| incoming money from parents |
| payouts to teachers and Рокет Ворк deal stages |
| P&L, cash flow, cohorts |
| summaries: finances, funnel, retention, unit economics |
| what needs attention right now |
| whose behalf the key works on and which sections are available |
Amounts are given in rubles, time is Moscow time.
If something doesn't work
"Invalid key" — the key has been revoked, expired, or copied with missing characters. Check it in the admin panel and issue a new one if necessary.
"Insufficient permissions" — the employee the key is issued to doesn't have access to this section. Ask the agent whoami: it will show which sections are open.
"Key is read-only" — expected: the key doesn't change anything by default.
"Admin panel didn't respond" — check YOUREPT_API_URL. You need the address where the API works (usually starts with api-), not the address of the admin panel site itself.
The server didn't appear in the list — almost always an unclosed bracket or an extra comma in the config. In the admin panel, on the key issuance screen, there's a ready-made snippet to copy entirely.
Security
Only the key hash is stored in the database — the key cannot be recovered from it.
The key inherits its employee's permissions and cannot exceed them.
Keys cannot be managed with a key: you can't issue yourself new access via the API.
Revocation takes effect instantly.
Personal data not present in the interface (trial lesson transcripts) is not accessible through this server.
When an employee leaves, revoke their keys along with their account.
Development
pnpm install
pnpm build # tsc → dist/To test the server without connecting to a client:
printf '%s\n' \
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"1"}}}' \
'{"jsonrpc":"2.0","method":"notifications/initialized"}' \
'{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
| YOUREPT_API_URL=http://localhost:4001 YOUREPT_API_KEY=ключ node dist/index.jsDiagnostics go to stderr — stdout is only for the protocol, nothing else should be written there.
Available Tools
17 toolsalertsЧто требует вниманияARead-only
Реестр проблем, которые система отслеживает сама: просроченные шаги по заявкам, пробные без даты и без проставленного исхода, ученики без уроков, зависшие долги, контракты без оплаты. Без параметра key показывает сводку по всем видам, с key — конкретные записи по одному виду.
Inputs: key.
dashboardСводка по школеARead-only
Главные показатели за период. section: finance (деньги), funnel (воронка продаж), retention (удержание учеников), lessons (уроки), portfolio (портфель контрактов), debt (задолженности), payroll (фонд оплаты), channels (каналы привлечения), unit-economics (юнит-экономика), new-vs-returning (новые против вернувшихся). Периоды календарные: week — с понедельника, month — с первого числа.
Inputs: section (required), dateTo, period, dateFrom.
finance_reportФинансовый отчёт (P&L, движение денег)ARead-only
Сводные финансовые отчёты. report: pnl (прибыли и убытки), cashflow (движение денег), cohorts (когорты по месяцам прихода). Периоды считаются календарными: неделя с понедельника, месяц с первого числа.
Inputs: report (required), month_to, month_from.
get_leadКарточка заявкиBRead-only
Полная карточка заявки: контакты родителя, предмет, преподаватель, история шагов воронки.
Inputs: lead_id (required).
get_studentКарточка ученикаARead-only
Карточка ученика: контакты, предмет, теги, связанные контракты и платежи.
Inputs: student_id (required).
get_teacherКарточка преподавателяARead-only
Карточка преподавателя: ставка, контакты, статус самозанятого, доступность. Для оценок за пробные уроки есть отдельный инструмент list_trial_scores.
Inputs: teacher_id (required).
list_enrollmentsКонтракты (ученик ↔ преподаватель)BRead-only
Контракты: связка ученика с преподавателем по предмету, ставки и остаток оплаченных часов. Именно здесь видно, у кого кончаются деньги на балансе.
Inputs: page, limit, status, student_id, +1 more.
list_leadsЗаявки (лиды)ARead-only
Список заявок с фильтрами. Помимо статуса умеет отбирать проблемные группы через alert: overdue (просрочен срок шага), trial_no_date (пробный без даты), trial_overdue (пробный прошёл, исход не проставлен), postponed_stale (отложена больше недели), needs_contract (продажа состоялась, а контракта нет), needs_feedback (ждём обратную связь).
Inputs: page, alert, limit, status, +1 more.
list_lessonsУроки и расписаниеARead-only
Уроки за период с фильтрами по преподавателю, контракту и статусу. unmarked=true отбирает проведённые уроки, у которых преподаватель не отметил результат — типичный источник вопросов «кто не закрыл уроки». type=TRIAL — только пробные.
Inputs: page, type, limit, status, +5 more.
list_paymentsПлатежи родителейARead-only
Приход денег: оплаты родителей через эквайринг. Все суммы приводятся к рублям. Поиск по человеку — параметр q (имя ученика, родителя или преподавателя).
Inputs: q, page, limit, status, +2 more.
list_payoutsВыплаты преподавателямCRead-only
Расход денег: выплаты самозанятым через сделки Рокет Ворк. Этапы сделки в поле «Этап РВ»: draft (преподаватель не принял задание), inwork (не отметил выполнение), accepting и completed (подписал, ждём оплату), paying, paid. Зависшие draft и inwork — это те, кто держит свои же деньги.
Inputs: q, kind, page, limit, +1 more.
list_studentsУченикиARead-only
Список учеников с контактами родителей и предметом. Для поиска конкретного человека по имени или телефону быстрее инструмент search.
Inputs: tag_ids.
list_tasksЗадачи и контроль качестваBRead-only
Задачи сотрудников. Движок контроля качества живёт в этой же таблице: задачи с check_key заведены роботом или ИИ по нарушениям (медленный ответ в чате, не сдано ДЗ, нет отчёта родителю, увод клиента). Фильтр only_quality=true оставляет только их.
Inputs: limit, assignee_id, is_completed, only_quality.
list_teachersПреподавателиARead-only
Список преподавателей: ставки, загрузка, готовность к выплатам через Рокет Ворк. Поле «Статус в РВ» = validated означает, что права ФНС подтверждены и выплаты возможны.
Inputs: q.
list_trial_scoresОценки пробных уроковARead-only
ИИ-оценки пробных уроков: механические и смысловые метрики по расшифровке звонка в Контур.Толк. Позволяет сравнить преподавателей по качеству проведения пробных. Сами расшифровки через этот сервер недоступны — это персональные данные.
Inputs: limit, teacher_id.
searchПоиск по всей CRMARead-only
Глобальный поиск по имени, телефону или номеру: преподаватели, ученики, заявки, платежи, выплаты, подрядчики, сотрудники, кандидаты HR. С этого инструмента стоит начинать, когда известно имя или телефон, но неизвестны внутренние id.
Inputs: query (required).
whoamiЧей это доступARead-only
Показывает, от чьего имени работает ключ и к каким разделам есть доступ. Полезно, когда инструмент отвечает «недостаточно прав»: здесь видно, чего именно не хватает.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
工具大多针对不同实体(线索、学生、教师、课程、支付等),search明确用于按名称/电话查找ID,与列表工具区分。但list_leads与alerts、list_lessons与list_trial_scores存在部分重叠,描述提供了指引,故为4分。
大部分工具遵循list_X或get_X的整洁模式(11个工具),但search、whoami、finance_report、dashboard和alerts不符合,混合了动词和名词。虽然存在异常,但整体模式明显且可预测,所以为4分。
17个工具覆盖了多个实体(线索、学生、教师、课程、合同、任务、付款、支出)以及搜索、报告、仪表板和警报,每个都有明确用途,没有明显冗余,工具数量对于该领域的复杂性是恰当的。
提供了主要实体的列表和获取工具(线索、学生、教师),但课程、合同、任务和付款只有列表,没有单独的获取工具。此外,没有创建、更新或删除操作,表明这是一个只读服务器,但对于查询目的,缺少get_lesson、get_enrollment、get_task等会限制深度访问,因此为3分。
Maintenance
Related MCP Connectors
Ask your AI assistant about your class studio's own numbers. See upcoming classes and how full they are, find the classes that need promoting, and check fill rates, attendance, bookings, cancellations and revenue from classes, gift cards and private events. Read-only, and limited to the studio that connects.
Read-only sales CRM for AI clients: leads, pipeline, AI-agent chats, calls, ad attribution.
Securely review your Neuron business profile, services, calls, leads, bookings, and CRM data after account owner authorization. Read-only: the assistant can view only the Neuron account and permissions the owner approves.
Amazon Ads, Seller Central, Vendor Central and AMC data for AI agents. Read-only by default.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with SalesDrive CRM, allowing order management, product queries, and more through natural language.1Apache 2.0
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to read MoyKlass CRM data through natural language, providing 16 tools for accessing users, groups, lessons, tasks, and more.-
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to query internal business data for insights into customers, revenue, subscriptions, sales, and churn through controlled, read-only MCP tools.-
- AlicenseBqualityCmaintenanceProvides AI assistants with read-only access to Chatwoot analytics and operational data, including conversations, agents, inboxes, teams, CSAT, and real-time metrics.301MIT