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: mcp-server-salesforce

What it can do

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.