SMS-Activate MCP Server

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

| 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

---

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

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

| Код | Сервис | |------|---------| | 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 / Поддержка

• 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