iletimerkezi/iletimerkezi-mcp-server

iletimerkezi/iletimerkezi-mcp-server

от iletimerkezi
MCP сервер для работы с SMS-платформой iletiMerkezi: отправка сообщений, проверка отчётов доставки, управление отправителями и чёрным списком. Включает 11 инструментов, синхронизированных с API. Подходит разработчикам, автоматизирующим бизнес-коммуникации.

iletiMerkezi MCP Server

npm version License Node Glama score Mentioned in Awesome MCP Servers

Model Context Protocol server for the iletiMerkezi SMS API. Lets MCP-aware LLM clients (Claude Code, Cursor, Codex CLI, Gemini CLI, VS Code+Cline, Claude Desktop, …) send SMS, query delivery reports, and manage senders / blacklists through tool calls.

iletiMerkezi is a Turkish, BTK-licensed bulk SMS / OTP / A2P platform. Tool shapes (input schemas, descriptions, doc links) are derived from a canonical API manifest that is built from the official endpoint documentation, so this server stays in lock-step with the live API by design.

Tools

Tool API endpoint Notes
send_sms POST /v1/send-sms/json Send SMS to one or many numbers (transactional 100/sec, bulk 50,000/request)
cancel_order POST /v1/cancel-order/json Cancel a future-scheduled order before dispatch
get_report POST /v1/get-report/json Single-order delivery report (summary + per-recipient)
get_reports POST /v1/get-reports/json Order summary list within a date range (max 10 days)
get_balance POST /v1/get-balance/json Account balance (TL + SMS credits)
get_sender POST /v1/get-sender/json Approved sender (header) list
get_blacklist POST /v1/get-blacklist/json Blocked numbers (paginated)
add_blacklist POST /v1/add-blacklist/json Block a number (idempotent)
delete_blacklist POST /v1/delete-blacklist/json Unblock a number
iys_register POST /v1/consent/create/json Register İYS consent records (batch, max 5000)
iys_check POST /v1/consent/show/json Look up İYS consent status for a recipient
Инструменты были проиндексированы:
add_blacklist

Эндпоинт add-blacklist добавляет один номер телефона в чёрный список вашего аккаунта, чтобы send-sms пропускал его. Идемпотентность: повторное добавление того же номера возвращает 200 вместо ошибки. Один номер на запрос. Ссылка: https://www.iletimerkezi.com/en/docs/api/add-blacklist

Параметры
  • blacklistobjectобязательный
cancel_order

Эндпоинт cancel-order отменяет заказ, созданный через send-sms с sendDateTime в будущем, до отправки оператору. Отменить можно только те заказы, которые ещё не начали отправляться – как только заказ попадает в конвейер отправки, окно отмены закрывается, и запрос возвращает 455. Ссылка: https://www.iletimerkezi.com/en/docs/api/cancel-order

Параметры
  • orderobjectобязательный
delete_blacklist

The delete-blacklist endpoint удаляет номер телефона из чёрного списка вашего аккаунта. После удаления send-sms снова сможет доставлять сообщения на этот номер. Один номер за запрос; не идемпотентен: удаление номера, которого нет в списке, возвращает ошибку. Ссылка: https://www.iletimerkezi.com/en/docs/api/delete-blacklist

Параметры
  • blacklistobjectобязательный
get_balance

Эндпоинт get-balance возвращает остаток баланса TL на вашем аккаунте и количество стандартных SMS-сообщений, которое можно оплатить этим балансом. Он не имеет побочных эффектов и не расходует кредиты, что делает его самым безопасным вызовом для проверки аутентификации и оценки оставшегося бюджета перед кампанией. Reference: https://www.iletimerkezi.com/en/docs/api/get-balance

Параметры

Без параметров.

get_blacklist

Эндпоинт get-blacklist возвращает список номеров телефонов, которые вы заблокировали в своём аккаунте. Номера из этого списка пропускаются при отправке send-sms. Вызов не имеет побочных эффектов и не расходует кредиты. Ссылка: https://www.iletimerkezi.com/en/docs/api/get-blacklist

Параметры
  • blacklistobject
get_report

Эндпоинт get-report возвращает отчёт о доставке для заказа, созданного через send-sms. Один ответ содержит общий статус заказа, сводные счётчики (всего / доставлено / не доставлено / ожидает), временные метки, отправителя, стоимость заказа и статус доставки по каждому получателю. Крупные заказы разбиваются на страницы с помощью page + rowCount. Ссылка: https://www.iletimerkezi.com/en/docs/api/get-report

Параметры
  • orderobjectобязательный
get_reports

Эндпоинт get-reports возвращает сводный список всех SMS-заказов, созданных за указанный период. Для каждого заказа в ответе содержатся счетчики (всего / доставлено / не доставлено / ожидает), временные метки и отправитель; разбивка по получателям не включена. Чтобы получить детали по получателям, вызывайте get-report для конкретного заказа. Этот эндпоинт используется для экрана Reports > Bulk SMS History в панели управления. Типичные случаи использования: дашборды, периодическая аналитика, запросы вроде «показать заказы за последнюю неделю». Ссылка: https://www.iletimerkezi.com/en/docs/api/get-reports

Параметры
  • filterobjectобязательный
get_sender

Конечная точка get-sender возвращает список идентификаторов отправителей (заголовков), зарегистрированных и одобренных в вашем аккаунте. Поле order.sender в send-sms принимает только значения из этого списка; всё остальное отклоняется. Этот вызов не имеет побочных эффектов и не расходует кредиты. Ссылка: https://www.iletimerkezi.com/en/docs/api/get-sender

Параметры

Без параметров.

iys_check

Эндпоинт iys-check возвращает текущий статус согласия İYS (İleti Yönetim Sistemi) для заданного получателя. Используйте его, чтобы проверить, обработана ли запись, отправленная через iys-register, проверить ONAY (согласие) / RET (отказ) перед коммерческой отправкой, или для создания отчетов аудита. Вызов не имеет побочных эффектов и не расходует кредиты. Ссылка: https://www.iletimerkezi.com/en/docs/api/iys-check

Параметры
  • consentobjectобязательный
iys_register

Эндпоинт iys-register создаёт записи согласия İYS (İleti Yönetim Sistemi) — обязательный по закону турецкий национальный реестр коммерческих электронных сообщений. Согласия (или отказы), собранные через веб-формы, подписанные контракты, подтверждения колл-центра и т.д., отправляются в iletiMerkezi через этот эндпоинт и передаются в национальный реестр İYS. До 5000 получателей на один запрос. Регистрация в İYS обязательна для любой коммерческой SMS, отправляемой в Турции. Без действительной записи согласия соответствующий вызов send-sms с iys: "1" будет отклонён с кодом 468/469/470. Ссылка: https://www.iletimerkezi.com/en/docs/api/iys-register

Параметры
  • consentobjectобязательный
send_sms

Отправляет SMS на один или несколько турецких или международных мобильных номеров в одном запросе. Возвращает orderId, который используется для отчётов о доставке (get_report) и отмены запланированной рассылки (cancel_order). Разрушительно и необратимо: отправляет реальное SMS, списывает оплаченный кредит, и после попадания сообщения в очередь оператора отозвать его нельзя. Для предварительного тестирования используйте отправителя "APITEST" — он принудительно устанавливает iys="0" и заменяет текст сообщения фиксированной проверочной строкой. После одобрения реального отправителя на аккаунте "APITEST" возвращает код 450. Авторизация: API-ключ + хэш. Тумблер "Allow API access" (Settings > Security > Access Permissions) в панели управления должен быть включён, иначе каждый вызов возвращает 401. Если настроен IP-адресный белый список, он применяется. Условные поля: order.sender должен быть буквенно-цифровым заголовком, одобренным в панели, макс. 11 символов. order.iys обязателен и выбирает регуляторный канал. Используйте "0" для транзакционных сообщений (OTP, сброс пароля, уведомления о заказе/доставке/оплате, напоминания о записи, регуляторные уведомления) — такие сообщения не подпадают под действие согласия на коммерческие сообщения согласно Закону Турции № 6563 и правилам IYS. Используйте "1" для коммерческих сообщений (кампания, акция, скидка, маркетинг). При iys="1" также требуется order.iysList, который должен быть "BIREYSEL" (физлица) или "TACIR" (юрлица). Обязательства по KVKK в отношении персональных данных остаются отдельными и действуют всегда. Примечание по именованию полей: контейнер получателей называется order.message.receipents (sic!); это опечатка для обратной совместимости, и "recipients" возвращает ошибку 452. Лимиты: 100 SMS в секунду на аккаунт для транзакционных отправок, считая по количеству получателей, а не запросов — запрос к пяти номерам потребляет пять единиц SMS. Массовые отправки принимают до 50 000 получателей за запрос; разбивайте большие списки клиентской стороной по 50 000. Планирование: order.sendDateTime ("dd/MM/yyyy HH:mm", местное время Турции, без секунд) задаёт отложенную отправку. Отмените до выхода сообщения из очереди через cancel_order с возвращённым orderId. Ссылка:…

Параметры
  • orderobjectобязательный
1.0.2основная
1.0.1
1.0.0
0.2.0
0.1.0

Выберите клиент, чтобы установить iletimerkezi/iletimerkezi-mcp-server:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "iletimerkezi-iletimerkezi-mcp-server-3rhcrj9ynv": {
      "command": "npx",
      "args": [
        "-y",
        "@iletimerkezi/mcp-server"
      ],
      "env": {
        "ILETIMERKEZI_API_KEY": "your-api-key",
        "ILETIMERKEZI_API_HASH": "your-api-hash"
      }
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "iletimerkezi-iletimerkezi-mcp-server-3rhcrj9ynv": {
      "command": "npx",
      "args": [
        "-y",
        "@iletimerkezi/mcp-server"
      ],
      "env": {
        "ILETIMERKEZI_API_KEY": "your-api-key",
        "ILETIMERKEZI_API_HASH": "your-api-hash"
      }
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "iletimerkezi-iletimerkezi-mcp-server-3rhcrj9ynv": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@iletimerkezi/mcp-server"
      ],
      "env": {
        "ILETIMERKEZI_API_KEY": "your-api-key",
        "ILETIMERKEZI_API_HASH": "your-api-hash"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"iletimerkezi-iletimerkezi-mcp-server-3rhcrj9ynv\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@iletimerkezi/mcp-server\"],\"env\":{\"ILETIMERKEZI_API_KEY\":\"your-api-key\",\"ILETIMERKEZI_API_HASH\":\"your-api-hash\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "iletimerkezi-iletimerkezi-mcp-server-3rhcrj9ynv": {
      "command": "npx",
      "args": [
        "-y",
        "@iletimerkezi/mcp-server"
      ],
      "env": {
        "ILETIMERKEZI_API_KEY": "your-api-key",
        "ILETIMERKEZI_API_HASH": "your-api-hash"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add iletimerkezi-iletimerkezi-mcp-server-3rhcrj9ynv --env ILETIMERKEZI_API_KEY=your-api-key --env ILETIMERKEZI_API_HASH=your-api-hash -- npx -y @iletimerkezi/mcp-server

Либо через JSON-конфиг:

claude mcp add-json iletimerkezi-iletimerkezi-mcp-server-3rhcrj9ynv "{\"command\":\"npx\",\"args\":[\"-y\",\"@iletimerkezi/mcp-server\"],\"env\":{\"ILETIMERKEZI_API_KEY\":\"your-api-key\",\"ILETIMERKEZI_API_HASH\":\"your-api-hash\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add iletimerkezi-iletimerkezi-mcp-server-3rhcrj9ynv --env ILETIMERKEZI_API_KEY=your-api-key --env ILETIMERKEZI_API_HASH=your-api-hash -- npx -y @iletimerkezi/mcp-server

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.iletimerkezi-iletimerkezi-mcp-server-3rhcrj9ynv]
command = "npx"
args = ["-y", "@iletimerkezi/mcp-server"]

[mcp_servers.iletimerkezi-iletimerkezi-mcp-server-3rhcrj9ynv.env]
ILETIMERKEZI_API_KEY = "your-api-key"
ILETIMERKEZI_API_HASH = "your-api-hash"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите iletimerkezi/iletimerkezi-mcp-server, а в поле команды запуска — строку ниже:
npx -y @iletimerkezi/mcp-server

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "iletimerkezi-iletimerkezi-mcp-server-3rhcrj9ynv": {
      "command": "npx",
      "args": [
        "-y",
        "@iletimerkezi/mcp-server"
      ],
      "env": {
        "ILETIMERKEZI_API_KEY": "your-api-key",
        "ILETIMERKEZI_API_HASH": "your-api-hash"
      }
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "iletimerkezi-iletimerkezi-mcp-server-3rhcrj9ynv": {
      "command": "npx",
      "args": [
        "-y",
        "@iletimerkezi/mcp-server"
      ],
      "env": {
        "ILETIMERKEZI_API_KEY": "your-api-key",
        "ILETIMERKEZI_API_HASH": "your-api-hash"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например iletimerkezi-iletimerkezi-mcp-server-3rhcrj9ynv.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: iletimerkezi-iletimerkezi-mcp-server-3rhcrj9ynv
    command: npx
    args:
      - "-y"
      - "@iletimerkezi/mcp-server"
    env:
      ILETIMERKEZI_API_KEY: your-api-key
      ILETIMERKEZI_API_HASH: your-api-hash
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "iletimerkezi-iletimerkezi-mcp-server-3rhcrj9ynv": {
      "command": "npx",
      "args": [
        "-y",
        "@iletimerkezi/mcp-server"
      ],
      "env": {
        "ILETIMERKEZI_API_KEY": "your-api-key",
        "ILETIMERKEZI_API_HASH": "your-api-hash"
      }
    }
  }
}

Похожие MCP-сервера

trycourier/courier-mcp

trycourier/courier-mcp

от trycourier

MCP-сервер Courier даёт AI-агентам полный доступ к API уведомлений через 124 инструмента: отправка сообщений, управление профилями, доставкой, списками и аудиенциями. Полезен для интеграции ИИ-аген...

TypeScript⭐ 2
khan2a/telephony-mcp-server

khan2a/telephony-mcp-server

от khan2a

MCP-сервер для телефонии на базе Vonage API. LLM-агенты совершают звонки и отправляют SMS прямо в диалоге. Разработчики AI-приложений получают простой инструмент для голосовых вызовов, отправки соо...

Python⭐ 14
carterlasalle/mac_messages_mcp

carterlasalle/mac_messages_mcp

от carterlasalle

Управляет Сообщениями на macOS: отправляет iMessage и SMS с авто-выбором канала, читает переписку, ищет сообщения и вложения. Работает локально.

Python⭐ 333
chaindead/telegram-mcp

chaindead/telegram-mcp

от chaindead

Telegram MCP сервер подключает AI-ассистентов к вашему аккаунту: чтение диалогов, отправка сообщений, отслеживание уведомлений. Работает с Claude, Cursor. Упрощает управление перепиской и автоматизацию ответов.

Go⭐ 349
twilio-labs/mcp

twilio-labs/mcp

от twilio-labs

MCP сервер для всех публичных Twilio API - SMS, звонки, уведомления. AI-инструменты управляют Twilio напрямую через MCP. Полезен разработчикам для автоматизации общения.

TypeScript⭐ 113
iprashantraj/mcp-discord-bridge

iprashantraj/mcp-discord-bridge

от iprashantraj

MCP-сервер для управления Discord-сервером через AI: 44 инструмента для каналов, сообщений, ролей, модерации и вебхуков. Подходит для автоматизации модерации и администрирования с любым MCP-клиентом.

TypeScript⭐ 3
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин