Skip to main content
Glama
SMS-Activate MCP Server

SMS-Activate MCP Server

by momentum100

SMS-Activate MCP Server

English | Русский


English

MCP (Model Context Protocol) server for integrating with SMS-Activate service - a platform for receiving SMS verification codes and temporary email addresses.

Features

  • 📱 Phone Number Operations: Request virtual numbers, check SMS codes, manage activations

  • 📧 Email Activations: Purchase temporary emails, check inbox, manage email sessions

  • 💰 Account Management: Check balance, view activation history

  • 🌍 Service Information: Get available countries, operators, services, and prices

  • 🔄 Real-time Status: Track activation status and retrieve verification codes

Prerequisites

  • Node.js 18 or higher

  • npm or yarn

  • SMS-Activate API key (get it from sms-activate.io)

Installation

1. Clone the repository

git clone https://github.com/momentum100/sms-activate-mcp.git
cd sms-activate-mcp

2. Install dependencies

npm install

3. Configure environment

Create a .env file in the project root:

SMS_ACTIVATE_API_KEY=your_api_key_here
SMS_ACTIVATE_BASE_URL=https://api.sms-activate.ae

4. Build the project

npm run build

5. Test the server

npm start

Configuration for Claude Desktop

Add this configuration to your Claude Desktop settings:

Windows

Location: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sms-activate": {
      "command": "node",
      "args": ["C:/path/to/sms-activate-mcp/dist/index.js"],
      "env": {
        "SMS_ACTIVATE_API_KEY": "your_api_key_here"
      }
    }
  }
}

macOS

Location: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "sms-activate": {
      "command": "node",
      "args": ["/Users/username/path/to/sms-activate-mcp/dist/index.js"],
      "env": {
        "SMS_ACTIVATE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Linux

Location: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "sms-activate": {
      "command": "node",
      "args": ["/home/username/path/to/sms-activate-mcp/dist/index.js"],
      "env": {
        "SMS_ACTIVATE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available Tools

Phone Number Operations

  • request_number - Request a virtual phone number for SMS verification

    • service (required): Service code or name (e.g., "tg" or "Telegram")

    • country (optional): Country ID (0=Russia, 1=Ukraine, etc.)

    • operator (optional): Mobile operator

    • forward (optional): Enable forwarding (0 or 1)

    • ref (optional): Referral code

  • get_status - Check activation status and retrieve SMS code

    • activationId (required): The activation ID from request_number

  • set_status - Change activation status

    • activationId (required): The activation ID

    • status (required): Status code (1=resend, 3=new code, 6=complete, 8=cancel)

  • get_active_activations - Get list of all active activations

  • get_activation_history - View activation history

Email Operations

  • purchase_email - Purchase a temporary email address

    • site (required): Target website (e.g., "telegram.com")

    • mailDomain (required): Email domain (e.g., "gmail.com")

  • get_email_status - Check email activation status and inbox

    • emailId (required): Email activation ID

  • cancel_email - Cancel email activation

    • emailId (required): Email activation ID

  • reorder_email - Reorder the same email activation

    • emailId (required): Email activation ID

  • get_email_domains - Get available email domains for a website

    • site (optional): Target website

Information Tools

  • get_balance - Check account balance

  • get_numbers_status - Get available phone numbers count

  • get_countries - Get list of all available countries

  • get_services - Get list of all available services

  • get_operators - Get operators for a specific country

  • get_prices - Get service prices

  • get_top_countries - Get top countries for a specific service

Common Service Codes

Code

Service

tg

Telegram

wa

WhatsApp

ig

Instagram

fb

Facebook

go

Google

tw

Twitter

vi

Viber

ub

Uber

ot

Any other

Common Country IDs

ID

Country

0

Russia

1

Ukraine

2

Kazakhstan

3

China

4

Philippines

5

Myanmar

6

Indonesia

10

Vietnam

12

USA (Virtual)

16

England

22

India

Development

# Run in development mode
npm run dev

# Build the project
npm run build

# Start the server
npm start

Troubleshooting

  • "SMS_ACTIVATE_API_KEY environment variable is required" - Create .env file with your API key

  • "BAD_KEY" or "ERROR_SQL" - Verify API key and account balance

  • Connection errors - Check internet connection and API availability


Related MCP server: VirtualSMS MCP Server

Русский

MCP (Model Context Protocol) сервер для интеграции с сервисом SMS-Activate - платформой для получения SMS кодов верификации и временных email адресов.

Возможности

  • 📱 Операции с номерами: Запрос виртуальных номеров, проверка SMS кодов, управление активациями

  • 📧 Email активации: Покупка временных email адресов, проверка входящих, управление сессиями

  • 💰 Управление аккаунтом: Проверка баланса, просмотр истории активаций

  • 🌍 Информация о сервисах: Получение доступных стран, операторов, сервисов и цен

  • 🔄 Статус в реальном времени: Отслеживание статуса активации и получение кодов верификации

Требования

  • Node.js 18 или выше

  • npm или yarn

  • API ключ SMS-Activate (получите на sms-activate.io)

Установка

1. Клонирование репозитория

git clone https://github.com/momentum100/sms-activate-mcp.git
cd sms-activate-mcp

2. Установка зависимостей

npm install

3. Настройка окружения

Создайте файл .env в корне проекта:

SMS_ACTIVATE_API_KEY=ваш_api_ключ
SMS_ACTIVATE_BASE_URL=https://api.sms-activate.ae

4. Сборка проекта

npm run build

5. Тестирование сервера

npm start

Конфигурация для Claude Desktop

Добавьте эту конфигурацию в настройки Claude Desktop:

Windows

Расположение: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sms-activate": {
      "command": "node",
      "args": ["C:/путь/к/sms-activate-mcp/dist/index.js"],
      "env": {
        "SMS_ACTIVATE_API_KEY": "ваш_api_ключ"
      }
    }
  }
}

macOS

Расположение: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "sms-activate": {
      "command": "node",
      "args": ["/Users/username/путь/к/sms-activate-mcp/dist/index.js"],
      "env": {
        "SMS_ACTIVATE_API_KEY": "ваш_api_ключ"
      }
    }
  }
}

Linux

Расположение: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "sms-activate": {
      "command": "node",
      "args": ["/home/username/путь/к/sms-activate-mcp/dist/index.js"],
      "env": {
        "SMS_ACTIVATE_API_KEY": "ваш_api_ключ"
      }
    }
  }
}

Доступные инструменты

Операции с телефонными номерами

  • request_number - Запрос виртуального номера телефона для SMS верификации

    • service (обязательный): Код или название сервиса (например, "tg" или "Telegram")

    • country (опциональный): ID страны (0=Россия, 1=Украина и т.д.)

    • operator (опциональный): Мобильный оператор

    • forward (опциональный): Включить переадресацию (0 или 1)

    • ref (опциональный): Реферальный код

  • get_status - Проверка статуса активации и получение SMS кода

    • activationId (обязательный): ID активации из request_number

  • set_status - Изменение статуса активации

    • activationId (обязательный): ID активации

    • status (обязательный): Код статуса (1=переотправить, 3=новый код, 6=завершить, 8=отменить)

  • get_active_activations - Получить список всех активных активаций

  • get_activation_history - Просмотр истории активаций

Операции с Email

  • purchase_email - Покупка временного email адреса

    • site (обязательный): Целевой сайт (например, "telegram.com")

    • mailDomain (обязательный): Email домен (например, "gmail.com")

  • get_email_status - Проверка статуса email активации и входящих сообщений

    • emailId (обязательный): ID email активации

  • cancel_email - Отмена email активации

    • emailId (обязательный): ID email активации

  • reorder_email - Повторный заказ той же email активации

    • emailId (обязательный): ID email активации

  • get_email_domains - Получить доступные email домены для сайта

    • site (опциональный): Целевой сайт

Информационные инструменты

  • get_balance - Проверка баланса аккаунта

  • get_numbers_status - Получить количество доступных номеров

  • get_countries - Получить список всех доступных стран

  • get_services - Получить список всех доступных сервисов

  • get_operators - Получить операторов для конкретной страны

  • get_prices - Получить цены на сервисы

  • get_top_countries - Получить топ стран для конкретного сервиса

Основные коды сервисов

Код

Сервис

tg

Telegram

wa

WhatsApp

ig

Instagram

fb

Facebook

go

Google

tw

Twitter

vi

Viber

ub

Uber

ot

Любой другой

Основные ID стран

ID

Страна

0

Россия

1

Украина

2

Казахстан

3

Китай

4

Филиппины

5

Мьянма

6

Индонезия

10

Вьетнам

12

США (Виртуальный)

16

Англия

22

Индия

Разработка

# Запуск в режиме разработки
npm run dev

# Сборка проекта
npm run build

# Запуск сервера
npm start

Решение проблем

  • "SMS_ACTIVATE_API_KEY environment variable is required" - Создайте файл .env с вашим API ключом

  • "BAD_KEY" или "ERROR_SQL" - Проверьте API ключ и баланс аккаунта

  • Ошибки подключения - Проверьте интернет-соединение и доступность API


Project Structure

sms-activate-mcp/
├── src/
│   ├── index.ts              # Main MCP server / Основной MCP сервер
│   └── sms-activate-client.ts # SMS-Activate API client / Клиент API
├── dist/                     # Compiled JavaScript / Скомпилированный код
├── docs/                     # API documentation / Документация API
│   ├── SMS-ACTIVATE.postman_collection.json
│   ├── api-protocol-for-working-with-sms-activate.json
│   └── services.json
├── package.json
├── tsconfig.json
├── .env.example
└── README.md

Support / Поддержка

License

MIT License - see LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Author

Created by momentum100

Acknowledgments

Available Tools

17 tools
cancel_emailC

Cancel email activation

Inputs: emailId (required).

get_activation_historyC

Get activation history

Inputs: no named parameters.

get_active_activationsB

Get list of active activations

Inputs: no named parameters.

get_balanceB

Get account balance

Inputs: no named parameters.

get_countriesB

Get list of available countries

Inputs: no named parameters.

get_email_domainsA

Get available email domains for a site

Inputs: site.

get_email_statusC

Get email activation status

Inputs: emailId (required).

get_numbers_statusC

Get available phone numbers quantity by country and service

Inputs: country, operator.

get_operatorsA

Get available operators for a country

Inputs: country (required).

get_pricesA

Get prices for services by country

Inputs: country, service.

get_servicesB

Get list of available services

Inputs: no named parameters.

get_statusC

Get activation status and SMS code

Inputs: activationId (required).

get_top_countriesB

Get top countries for a specific service

Inputs: service (required).

purchase_emailC

Purchase an email activation

Inputs: site (required), mailDomain (required).

reorder_emailC

Reorder email activation

Inputs: emailId (required).

request_numberC

Request a phone number for SMS verification

Inputs: service (required), ref, country, forward, +1 more.

set_statusC

Change activation status

Inputs: status (required), activationId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 17 tools

    Disambiguation4/5

    Most tools have clear, distinct purposes, but some overlap exists between get_countries and get_top_countries, and between get_numbers_status and get_prices. Descriptions help differentiate them, so ambiguity is limited.

    Naming Consistency4/5

    Tool names follow a consistent lowercase_with_underscores convention and mostly use verb_noun (get_balance, request_number, purchase_email). A few names like get_status and set_status are more generic, but the overall pattern is predictable.

    Tool Count4/5

    At 17 tools, the count is slightly above the ideal range but each tool serves a distinct purpose within the dual phone/email activation domain. The scope justifies the number, and no tools feel redundant.

    Completeness5/5

    The server covers the full lifecycle for both phone and email activations: balance, availability, pricing, request, status, history, and cancellation (via set_status). Email-specific operations (purchase, cancel, reorder, domains) complete the picture, leaving no obvious gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      MCP server for provisioning dedicated real-SIM US phone numbers, receiving inbound SMS, and extracting OTP codes. Built for AI agents automating phone verification workflows.
      12
      506 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that enables AI agents to autonomously buy virtual phone numbers and receive SMS verification codes. Supports multiple providers (5sim, SMS-Activate, OnlineSim) with automatic cheapest-provider selection.
      2
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for integrating with Grizzly SMS platform to rent virtual numbers, receive SMS verification codes, and manage activations directly from AI assistants like Cursor, Claude Desktop, and OpenClaw.
      8
      22
      MIT