SMS-Activate MCP Server

English | Русский

<a name="english"></a>

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

<a name="russian"></a>

Русский

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