Skip to main content
Glama
yourept-mcp

yourept-mcp

by Skamatoz

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-mcp you can simply write yourept-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-mcp

Cursor — 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

search across the entire CRM: people, leads, payments, payouts

list_leads, get_lead

leads, including problem groups

list_students, get_student

students and their contracts

list_teachers, get_teacher

teachers, rates, self-employed status

list_lessons

lessons for a period, including unmarked ones

list_enrollments

contracts, rates, balance remaining

list_tasks

employee tasks and quality control checks

list_trial_scores

AI scores for trial lessons

list_payments

incoming money from parents

list_payouts

payouts to teachers and Рокет Ворк deal stages

finance_report

P&L, cash flow, cohorts

dashboard

summaries: finances, funnel, retention, unit economics

alerts

what needs attention right now

whoami

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.js

Diagnostics go to stderr — stdout is only for the protocol, nothing else should be written there.

Available Tools

17 tools
alertsЧто требует вниманияA
Read-only

Реестр проблем, которые система отслеживает сама: просроченные шаги по заявкам, пробные без даты и без проставленного исхода, ученики без уроков, зависшие долги, контракты без оплаты. Без параметра key показывает сводку по всем видам, с key — конкретные записи по одному виду.

Inputs: key.

dashboardСводка по школеA
Read-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, движение денег)A
Read-only

Сводные финансовые отчёты. report: pnl (прибыли и убытки), cashflow (движение денег), cohorts (когорты по месяцам прихода). Периоды считаются календарными: неделя с понедельника, месяц с первого числа.

Inputs: report (required), month_to, month_from.

get_leadКарточка заявкиB
Read-only

Полная карточка заявки: контакты родителя, предмет, преподаватель, история шагов воронки.

Inputs: lead_id (required).

get_studentКарточка ученикаA
Read-only

Карточка ученика: контакты, предмет, теги, связанные контракты и платежи.

Inputs: student_id (required).

get_teacherКарточка преподавателяA
Read-only

Карточка преподавателя: ставка, контакты, статус самозанятого, доступность. Для оценок за пробные уроки есть отдельный инструмент list_trial_scores.

Inputs: teacher_id (required).

list_enrollmentsКонтракты (ученик ↔ преподаватель)B
Read-only

Контракты: связка ученика с преподавателем по предмету, ставки и остаток оплаченных часов. Именно здесь видно, у кого кончаются деньги на балансе.

Inputs: page, limit, status, student_id, +1 more.

list_leadsЗаявки (лиды)A
Read-only

Список заявок с фильтрами. Помимо статуса умеет отбирать проблемные группы через alert: overdue (просрочен срок шага), trial_no_date (пробный без даты), trial_overdue (пробный прошёл, исход не проставлен), postponed_stale (отложена больше недели), needs_contract (продажа состоялась, а контракта нет), needs_feedback (ждём обратную связь).

Inputs: page, alert, limit, status, +1 more.

list_lessonsУроки и расписаниеA
Read-only

Уроки за период с фильтрами по преподавателю, контракту и статусу. unmarked=true отбирает проведённые уроки, у которых преподаватель не отметил результат — типичный источник вопросов «кто не закрыл уроки». type=TRIAL — только пробные.

Inputs: page, type, limit, status, +5 more.

list_paymentsПлатежи родителейA
Read-only

Приход денег: оплаты родителей через эквайринг. Все суммы приводятся к рублям. Поиск по человеку — параметр q (имя ученика, родителя или преподавателя).

Inputs: q, page, limit, status, +2 more.

list_payoutsВыплаты преподавателямC
Read-only

Расход денег: выплаты самозанятым через сделки Рокет Ворк. Этапы сделки в поле «Этап РВ»: draft (преподаватель не принял задание), inwork (не отметил выполнение), accepting и completed (подписал, ждём оплату), paying, paid. Зависшие draft и inwork — это те, кто держит свои же деньги.

Inputs: q, kind, page, limit, +1 more.

list_studentsУченикиA
Read-only

Список учеников с контактами родителей и предметом. Для поиска конкретного человека по имени или телефону быстрее инструмент search.

Inputs: tag_ids.

list_tasksЗадачи и контроль качестваB
Read-only

Задачи сотрудников. Движок контроля качества живёт в этой же таблице: задачи с check_key заведены роботом или ИИ по нарушениям (медленный ответ в чате, не сдано ДЗ, нет отчёта родителю, увод клиента). Фильтр only_quality=true оставляет только их.

Inputs: limit, assignee_id, is_completed, only_quality.

list_teachersПреподавателиA
Read-only

Список преподавателей: ставки, загрузка, готовность к выплатам через Рокет Ворк. Поле «Статус в РВ» = validated означает, что права ФНС подтверждены и выплаты возможны.

Inputs: q.

list_trial_scoresОценки пробных уроковA
Read-only

ИИ-оценки пробных уроков: механические и смысловые метрики по расшифровке звонка в Контур.Толк. Позволяет сравнить преподавателей по качеству проведения пробных. Сами расшифровки через этот сервер недоступны — это персональные данные.

Inputs: limit, teacher_id.

whoamiЧей это доступA
Read-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

    A3.6/5.0

    Scored across 17 tools

    Disambiguation4/5

    工具大多针对不同实体(线索、学生、教师、课程、支付等),search明确用于按名称/电话查找ID,与列表工具区分。但list_leads与alerts、list_lessons与list_trial_scores存在部分重叠,描述提供了指引,故为4分。

    Naming Consistency4/5

    大部分工具遵循list_X或get_X的整洁模式(11个工具),但search、whoami、finance_report、dashboard和alerts不符合,混合了动词和名词。虽然存在异常,但整体模式明显且可预测,所以为4分。

    Tool Count5/5

    17个工具覆盖了多个实体(线索、学生、教师、课程、合同、任务、付款、支出)以及搜索、报告、仪表板和警报,每个都有明确用途,没有明显冗余,工具数量对于该领域的复杂性是恰当的。

    Completeness3/5

    提供了主要实体的列表和获取工具(线索、学生、教师),但课程、合同、任务和付款只有列表,没有单独的获取工具。此外,没有创建、更新或删除操作,表明这是一个只读服务器,但对于查询目的,缺少get_lesson、get_enrollment、get_task等会限制深度访问,因此为3分。

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with SalesDrive CRM, allowing order management, product queries, and more through natural language.
      1
      Apache 2.0
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to query internal business data for insights into customers, revenue, subscriptions, sales, and churn through controlled, read-only MCP tools.
      -
    • A
      license
      B
      quality
      C
      maintenance
      Provides AI assistants with read-only access to Chatwoot analytics and operational data, including conversations, agents, inboxes, teams, CSAT, and real-time metrics.
      30
      1
      MIT