mcpField
C
calltouch-mcp

calltouch-mcp

Local
github.com/theYahiaData & Analytics0Updated 8w ago
Repository

About calltouch-mcp

calltouch-mcp connects MCP clients to the Calltouch API for call tracking and advertising analytics. It provides tools for call records, statistics, leads, traffic sources, and tags; development has moved to the WWmcp monorepo.

Key features

  1. 01Browse calls with source and UTM details
  2. 02View aggregated call statistics
  3. 03List leads
  4. 04Inspect traffic sources and tags
  5. 05Run daily-call and source-analysis skills

Use cases

  1. 01Review calls received today
  2. 02Find missed calls and lead records
  3. 03Compare calls across traffic sources

MCP support

Exposes five Calltouch API tools and two skills to MCP clients. Supports stdio and Streamable HTTP transports; authentication uses a Calltouch token and site ID.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "theyahia-calltouch": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/calltouch-mcp"
      ],
      "env": {
        "CALLTOUCH_TOKEN": "<CALLTOUCH_TOKEN>"
      }
    }
  }
}
Run commandnpx -y @theyahia/calltouch-mcp
Environment variables to set
CALLTOUCH_TOKENSecretAPI key for the service

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@theyahia/calltouch-mcp1.0.1

Tools

2

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
pagenumberNoPage number (default 1)
limitnumberNoКоличество записей (по умолчанию 50)
sourcestringNoФильтр по источнику трафика
date_tostringYesДата окончания в формате dd/MM/yyyy
date_fromstringYesДата начала в формате dd/MM/yyyy

Details

From the project README

🗄 Репозиторий заархивирован

Разработка переехала в 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-mcp is unchanged. Please open issues and pull requests there.

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

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

npm License: MIT

Установка

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

smithery badge

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_TOKENAPI-токен из личного кабинета Calltouch (обязательно)
CALLTOUCH_SITE_IDID сайта в 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.