Skip to main content
Glama
theYahia

@theyahia/getcourse-mcp

by theYahia
README.md
> ## 🗄 Репозиторий заархивирован
>
> Разработка переехала в **[theYahia/WWmcp](https://github.com/theYahia/WWmcp)** — монорепозиторий MCP-серверов для незападных API: СНГ, MENA, Африка, LATAM, Юго-Восточная Азия. Общее ядро `@theyahia/mcp-core`, единый CI, единый релизный конвейер.
>
> Актуальная версия того, что лежало здесь: [`servers/getcourse/`](https://github.com/theYahia/WWmcp/tree/main/servers/getcourse)
>
> Пакет в npm прежний — [`@theyahia/getcourse-mcp`](https://www.npmjs.com/package/@theyahia/getcourse-mcp), ставится и работает как раньше.
> Здесь больше ничего не обновляется. Задачи и pull request'ы — в WWmcp.
>
> **Archived — development moved to [theYahia/WWmcp](https://github.com/theYahia/WWmcp),** a monorepo of MCP servers for non-Western APIs.
> The current version of this package now lives at [`servers/getcourse/`](https://github.com/theYahia/WWmcp/tree/main/servers/getcourse).
> The npm package [`@theyahia/getcourse-mcp`](https://www.npmjs.com/package/@theyahia/getcourse-mcp) is unchanged.
> Please open issues and pull requests there.

# @theyahia/getcourse-mcp

MCP server for **GetCourse** LMS API. 3 tools for users, deals, and user creation.

[![npm](https://img.shields.io/npm/v/@theyahia/getcourse-mcp)](https://www.npmjs.com/package/@theyahia/getcourse-mcp)
[![license](https://img.shields.io/npm/l/@theyahia/getcourse-mcp)](./LICENSE)

## Quick Start

### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "getcourse": {
      "command": "npx",
      "args": ["-y", "@theyahia/getcourse-mcp"],
      "env": {
        "GETCOURSE_DOMAIN": "myschool.getcourse.ru",
        "GETCOURSE_API_KEY": "your-api-key"
      }
    }
  }
}
```

### Claude Code

```bash
claude mcp add getcourse -- npx -y @theyahia/getcourse-mcp
```

Set env: `GETCOURSE_DOMAIN` + `GETCOURSE_API_KEY`.

### Cursor / Windsurf

```json
{
  "getcourse": {
    "command": "npx",
    "args": ["-y", "@theyahia/getcourse-mcp"],
    "env": {
      "GETCOURSE_DOMAIN": "myschool.getcourse.ru",
      "GETCOURSE_API_KEY": "your-api-key"
    }
  }
}
```

## Tools

| Tool | Description |
|------|-------------|
| `get_users` | List users with optional status/date filters |
| `create_user` | Create or update a user, add to group/deal |
| `get_deals` | List deals (orders) with status/date filters |

## Auth

| Variable | Required | Description |
|----------|----------|-------------|
| `GETCOURSE_DOMAIN` | Yes | Account domain (e.g. myschool.getcourse.ru) |
| `GETCOURSE_API_KEY` | Yes | API secret key from account settings |

## HTTP Transport

```bash
HTTP_PORT=3000 npx @theyahia/getcourse-mcp
# or
npx @theyahia/getcourse-mcp --http 3000
```

Endpoints: `POST /mcp` (JSON-RPC), `GET /health` (status).

## Skills

- **skill-students** -- query and manage GetCourse students
- **skill-deals** -- query GetCourse deals/orders by status and date

## License

MIT

TDQS

B3.4/5.0

Scored across 3 tools

Disambiguation5/5

Each tool targets a distinct resource and action: getting users, creating/updating users, and getting deals. There is no overlap or ambiguity between the tools.

Naming Consistency5/5

All tools follow a consistent verb_noun pattern with get_ or create_ prefixes (get_users, create_user, get_deals). Naming is predictable and uniform.

Tool Count5/5

With exactly 3 tools, the count falls within the well-scoped 3-15 range. Each tool serves a clear core function for GetCourse integration without unnecessary bloat.

Completeness3/5

The tool surface covers listing users, upserting users, and listing deals, but notable operations are missing: no delete for users and no create/update/delete for deals. This creates partial CRUD coverage with gaps.

Maintenance

ActivityMaintained
ResponsivenessNo issues