io.github.theYahia/calltouch-mcp
MCP server for Calltouch API — call tracking, call statistics. Token auth.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
@theyahia/calltouch-mcpclaude mcp add calltouch-mcp -e 'CALLTOUCH_TOKEN=<your calltouch_token>' -- npx -y @theyahia/calltouch-mcp@1.0.1
{
"mcpServers": {
"calltouch-mcp": {
"command": "npx",
"args": [
"-y",
"@theyahia/calltouch-mcp@1.0.1"
],
"env": {
"CALLTOUCH_TOKEN": "<your calltouch_token>"
}
}
}
}
Environment variables
CALLTOUCH_TOKENrequired secret API key for the service
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
🗄 Репозиторий заархивирован
Разработка переехала в theYahia/WWmcp — монорепозиторий MCP-серверов для незападных API: СНГ, MENA, Африка, LATAM, Юго-Восточная Азия. Общее ядро
@theyahia/mcp-core, единый CI, единый релизный конвейер.Актуальная версия того, что лежало здесь:
servers/calltouch/Пакет в npm прежний —
@theyahia/calltouch-mcp, ставится и работает как раньше. Здесь больше ничего не обновляется. Задачи и pull request'ы — в WWmcp.Archived — development moved to theYahia/WWmcp, a monorepo of MCP servers for non-Western APIs. The current version of this package now lives at
servers/calltouch/. The npm package@theyahia/calltouch-mcpis unchanged. Please open issues and pull requests there.
Calltouch MCP — коллтрекинг и звонки с рекламы в диалоге с нейросетью
Если вы искали, как спросить у ИИ, сколько звонков пришло с рекламы за сегодня, найти пропущенные обращения или свести источники трафика со звонками без выгрузок — это оно. 5 инструментов + 2 скилла поверх API Calltouch: звонки с UTM-разметкой, агрегированная статистика, лиды, источники и теги. Stdio + Streamable HTTP.
Установка
Claude Desktop
{
"mcpServers": {
"calltouch": {
"command": "npx",
"args": ["-y", "@theyahia/calltouch-mcp"],
"env": {
"CALLTOUCH_TOKEN": "ваш_токен",
"CALLTOUCH_SITE_ID": "ваш_site_id"
}
}
}
}
Claude Code
claude mcp add calltouch -e CALLTOUCH_TOKEN=ваш_токен -e CALLTOUCH_SITE_ID=ваш_site_id -- npx -y @theyahia/calltouch-mcp
Smithery
npx -y @smithery/cli install @theyahia/calltouch-mcp --client claude
Streamable HTTP
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 | Эффективность источников — топ по звонкам |
Примеры запросов
Покажи все звонки за сегодня
Какая статистика звонков за последнюю неделю?
Какие лиды пришли за март?
Какие источники самые эффективные?
Покажи теги за этот месяц
Разработка
npm install
npm test
npm run dev # stdio
npm run dev:http # HTTP на порту 3000
Реферальная программа
Calltouch предлагает реферальную программу: 15% пожизненно с каждого приведённого клиента. Подробности: calltouch.ru/partners
Лицензия
MIT
Telegram: @vhodvai
Frequently asked questions
What is io.github.theYahia/calltouch-mcp?
MCP server for Calltouch API — call tracking, call statistics. Token auth.
How do I install io.github.theYahia/calltouch-mcp?
It runs on your machine. In Claude Code: claude mcp add calltouch-mcp -e 'CALLTOUCH_TOKEN=<your calltouch_token>' -- npx -y @theyahia/calltouch-mcp@1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.theYahia/calltouch-mcp need an API key?
Yes. It expects CALLTOUCH_TOKEN, which you set in its configuration.
Is io.github.theYahia/calltouch-mcp open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.theYahia/calltouch-mcp?
It is published by theYahia. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.