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

Common Country IDs

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 - Получить топ стран для конкретного сервиса

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

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

Разработка

# Запуск в режиме разработки
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 / Поддержка

• Issues: GitHub Issues

• SMS-Activate Support: sms-activate.io/support

• API Documentation: sms-activate.io/api2

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

• SMS-Activate for providing the SMS verification service

• Anthropic for the MCP protocol specification