> ## 🗄 Репозиторий заархивирован
>
> Разработка переехала в **[theYahia/WWmcp](https://github.com/theYahia/WWmcp)** — монорепозиторий MCP-серверов для незападных API: СНГ, MENA, Африка, LATAM, Юго-Восточная Азия. Общее ядро `@theyahia/mcp-core`, единый CI, единый релизный конвейер.
>
> Актуальная версия того, что лежало здесь: [`servers/calltouch/`](https://github.com/theYahia/WWmcp/tree/main/servers/calltouch)
>
> Пакет в npm прежний — [`@theyahia/calltouch-mcp`](https://www.npmjs.com/package/@theyahia/calltouch-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/calltouch/`](https://github.com/theYahia/WWmcp/tree/main/servers/calltouch).
> The npm package [`@theyahia/calltouch-mcp`](https://www.npmjs.com/package/@theyahia/calltouch-mcp) is unchanged.
> Please open issues and pull requests there.

# Calltouch MCP — коллтрекинг и звонки с рекламы в диалоге с нейросетью

Если вы искали, как спросить у ИИ, сколько звонков пришло с рекламы за сегодня, найти пропущенные обращения или свести источники трафика со звонками без выгрузок — это оно. **5 инструментов + 2 скилла** поверх API Calltouch: звонки с UTM-разметкой, агрегированная статистика, лиды, источники и теги. Stdio + Streamable HTTP.

[![npm](https://img.shields.io/npm/v/@theyahia/calltouch-mcp)](https://www.npmjs.com/package/@theyahia/calltouch-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Установка

### Claude Desktop

```json
{
  "mcpServers": {
    "calltouch": {
      "command": "npx",
      "args": ["-y", "@theyahia/calltouch-mcp"],
      "env": {
        "CALLTOUCH_TOKEN": "ваш_токен",
        "CALLTOUCH_SITE_ID": "ваш_site_id"
      }
    }
  }
}
```

### Claude Code

```bash
claude mcp add calltouch -e CALLTOUCH_TOKEN=ваш_токен -e CALLTOUCH_SITE_ID=ваш_site_id -- npx -y @theyahia/calltouch-mcp
```

### Smithery

[![smithery badge](https://smithery.ai/badge/@theyahia/calltouch-mcp)](https://smithery.ai/server/@theyahia/calltouch-mcp)

```bash
npx -y @smithery/cli install @theyahia/calltouch-mcp --client claude
```

### Streamable HTTP

```bash
npx @theyahia/calltouch-mcp --http
# POST http://localhost:3000/mcp
# GET  http://localhost:3000/health
```

Порт настраивается через `PORT=8080`.

## Авторизация

| Переменная | Описание |
|------------|----------|
| `CALLTOUCH_TOKEN` | API-токен из личного кабинета Calltouch (обязательно) |
| `CALLTOUCH_SITE_ID` | ID сайта в Calltouch (обязательно) |

Base URL: `https://api.calltouch.ru/calls-service/RestAPI/`

## Инструменты (5)

| Инструмент | Описание |
|------------|----------|
| `get_calls` | Список звонков с детализацией: номер, источник, длительность, UTM |
| `get_statistics` | Агрегированная статистика: всего, уникальных, целевых, пропущенных |
| `get_leads` | Список лидов: заявки с сайта, формы обратной связи |
| `get_sources` | Источники трафика: каналы, кампании, эффективность |
| `get_tags` | Теги звонков: категории и метки |

## Скиллы (2)

| Скилл | Описание |
|-------|----------|
| `skill_calls_today` | Звонки за сегодня — быстрый отчёт |
| `skill_sources` | Эффективность источников — топ по звонкам |

## Примеры запросов

```
Покажи все звонки за сегодня
Какая статистика звонков за последнюю неделю?
Какие лиды пришли за март?
Какие источники самые эффективные?
Покажи теги за этот месяц
```

## Разработка

```bash
npm install
npm test
npm run dev          # stdio
npm run dev:http     # HTTP на порту 3000
```

## Реферальная программа

Calltouch предлагает реферальную программу: **15% пожизненно** с каждого приведённого клиента.
Подробности: [calltouch.ru/partners](https://www.calltouch.ru/partners/)

## Лицензия

MIT

---

Telegram: [@vhodvai](https://t.me/vhodvai)