Grizzly SMS MCP Server
OfficialAllows requesting virtual phone numbers to receive SMS verification codes for Facebook.
Allows requesting virtual phone numbers to receive SMS verification codes for Google.
Allows requesting virtual phone numbers to receive SMS verification codes for Instagram.
Allows requesting virtual phone numbers to receive SMS verification codes for Telegram.
Allows requesting virtual phone numbers to receive SMS verification codes for Uber.
Allows requesting virtual phone numbers to receive SMS verification codes for WhatsApp.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Grizzly SMS MCP Server rent a virtual number for Telegram"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Grizzly SMS — MCP Server & OpenClaw Skill
English
MCP (Model Context Protocol) server and OpenClaw Skill for integrating with Grizzly SMS — a platform for SMS verification codes and virtual phone numbers. Compatible with Cursor, Claude Desktop, OpenClaw (MCP and Skill modes).
What This Project Provides
Mode | Description | Use Case |
MCP Server | Standards-based MCP server exposing Grizzly API tools | Cursor, Claude Desktop, OpenClaw with mcpServers |
OpenClaw Skill | Instruction-based skill using exec + CLI script | OpenClaw skills-only setup (no mcpServers) |
Features
MCP Server
Phone operations:
request_number,get_status,set_statusAccount:
get_balanceInfo:
get_countries,get_services,get_prices
OpenClaw Skill
Dialog-based API key: Bot asks for the key during the conversation
Balance & top-up: Check balance and provide crypto wallet (USDT TRC-20) for top-up
Number lifecycle: Request number, poll for SMS, complete or cancel activation
Full registration workflow: Resolve service/country codes → rent number → open browser → fill forms → enter SMS code
Formatted output: Phone, activation ID, and SMS in copy-friendly format (monospace on Telegram)
OpenClaw Skill Pipeline
API key — Bot asks: Please provide your Grizzly SMS API key
Balance & top-up — Bot can show balance and crypto wallet address for USDT TRC-20 top-up
Number — Bot rents a number for the requested service and country
Status — Bot can cancel an activation or request a new SMS
SMS — Bot polls and returns the verification code
Complete — Bot marks activation complete after code is used
See CONFIG.md for OpenClaw skill setup.
Prerequisites
Node.js 18+
Grizzly SMS API key — register at grizzlysms.com, then get it from the API section
Installation
git clone https://github.com/GrizzlySMS-Git/grizzly-sms-mcp.git
cd grizzly-sms-mcp
npm install
npm run buildConfiguration: MCP Server (Cursor, Claude Desktop, OpenClaw mcpServers)
Cursor
Location: %APPDATA%\Cursor\User\globalStorage\mcp.json (Windows) | ~/Library/Application Support/Cursor/User/globalStorage/mcp.json (macOS) | ~/.config/Cursor/User/globalStorage/mcp.json (Linux)
{
"mcpServers": {
"grizzly-sms": {
"command": "node",
"args": ["/absolute/path/to/grizzly-sms-mcp/dist/index.js"],
"env": {
"GRIZZLY_SMS_API_KEY": "your_api_key",
"GRIZZLY_SMS_BASE_URL": "https://api.grizzlysms.com"
}
}
}
}OpenClaw (mcpServers)
Location: ~/.openclaw/openclaw.json (macOS/Linux) | %APPDATA%\.openclaw\openclaw.json (Windows)
{
"agents": {
"list": [{
"id": "main",
"mcpServers": {
"grizzly-sms": {
"command": "node",
"args": ["/absolute/path/to/grizzly-sms-mcp/dist/index.js"],
"env": {
"GRIZZLY_SMS_API_KEY": "your_api_key",
"GRIZZLY_SMS_BASE_URL": "https://api.grizzlysms.com"
}
}
}
}
}
}Use absolute paths. Restart after changes: openclaw gateway restart
Configuration: OpenClaw Skill (skills-only, no mcpServers)
Add skill path to
openclaw.json:
{
"skills": {
"load": {
"extraDirs": ["/absolute/path/to/grizzly-sms-mcp"]
},
"entries": {
"grizzly_sms": {
"enabled": true
}
}
}
}Enable exec and optionally browser tools for the agent
Restart:
npx openclaw gateway restart
Full setup (exec approvals, browser tool, API key in dialog) — see CONFIG.md.
MCP Tools Reference
Tool | Parameters | Description |
| service (required), country (optional), maxPrice, providerIds, exceptProviderIds | Rent a virtual number |
| activationId (required) | Get activation status and SMS code |
| activationId, status (6=complete, 8=cancel) | Change activation status |
| — | Check balance |
| — | Get USDT TRC-20 wallet address for top-up |
| — | List countries |
| — | List services |
| service, country (optional) | Get prices |
Common Service Codes
Code | Service |
tg | Telegram |
wa | |
ig | |
fb | |
go | |
ub | Uber |
Common Country IDs
ID | Country |
73 | Brazil |
1 | Ukraine |
16 | England |
187 | USA |
22 | India |
Project Structure
grizzly-sms-mcp/
├── SKILL.md # OpenClaw skill instructions
├── CONFIG.md # OpenClaw skill config guide
├── clawhub.json # ClawHub metadata
├── scripts/
│ └── grizzly-cli.mjs # CLI for OpenClaw exec
├── src/ # MCP server (TypeScript)
│ ├── index.ts
│ └── grizzly-sms-client.ts
├── docs/
├── package.json
└── README.mdDevelopment
npm run dev # Development mode
npm run build # Build MCP server
npm start # Run MCP server
npm test # Run tests
npm run test:api # Test API methodsTroubleshooting
GRIZZLY_SMS_API_KEY required — Set in
.env, config, or provide in chat (Skill mode)BAD_KEY — Verify API key at grizzlysms.com
NO_BALANCE — Top up at grizzlysms.com (USDT TRC-20 supported)
exec not permitted — Configure exec approvals; see CONFIG.md
Support
API docs: grizzlysms.com/docs
Website: grizzlysms.com
Issues: GitHub Issues
License
MIT — see LICENSE
Related MCP server: MCP Agents SMS
Русский
MCP (Model Context Protocol) сервер и OpenClaw Skill для интеграции с Grizzly SMS — платформой SMS верификации и виртуальных номеров. Совместимо с Cursor, Claude Desktop, OpenClaw (режимы MCP и Skill).
Что предоставляет проект
Режим | Описание | Когда использовать |
MCP Server | MCP‑сервер с инструментами Grizzly API | Cursor, Claude Desktop, OpenClaw с mcpServers |
OpenClaw Skill | Skill на exec + CLI‑скрипт | OpenClaw только со skills (без mcpServers) |
Возможности
MCP Server
Номера:
request_number,get_status,set_statusАккаунт:
get_balanceСправочники:
get_countries,get_services,get_prices
OpenClaw Skill
API‑ключ в диалоге: бот запрашивает ключ в чате
Баланс и пополнение: показывает баланс и криптокошелёк (USDT TRC-20) для пополнения
Жизненный цикл номера: аренда номера, ожидание SMS, завершение или отмена активации
Полный workflow регистрации: определение сервиса/страны → аренда номера → браузер → заполнение форм → ввод SMS‑кода
Форматированный вывод: номер, ID активации и SMS в удобном для копирования виде (моноширинный текст в Telegram)
Пайплайн OpenClaw Skill
API‑ключ — бот спрашивает: Выдайте API ключ Grizzly SMS
Баланс и пополнение — бот показывает баланс и адрес кошелька USDT TRC-20
Номер — бот арендует номер для указанного сервиса и страны
Статус — бот может отменить активацию или запросить новый SMS
SMS — бот опрашивает статус и возвращает код
Завершение — бот помечает активацию выполненной после использования кода
Подробная настройка — в CONFIG.md.
Требования
Node.js 18+
API‑ключ Grizzly SMS — регистрация на grizzlysms.com, ключ в разделе API
Установка
git clone https://github.com/GrizzlySMS-Git/grizzly-sms-mcp.git
cd grizzly-sms-mcp
npm install
npm run buildКонфигурация: MCP Server (Cursor, Claude Desktop, OpenClaw mcpServers)
Cursor
Путь: %APPDATA%\Cursor\User\globalStorage\mcp.json (Windows) | ~/Library/Application Support/Cursor/User/globalStorage/mcp.json (macOS) | ~/.config/Cursor/User/globalStorage/mcp.json (Linux)
{
"mcpServers": {
"grizzly-sms": {
"command": "node",
"args": ["/абсолютный/путь/к/grizzly-sms-mcp/dist/index.js"],
"env": {
"GRIZZLY_SMS_API_KEY": "ваш_api_ключ",
"GRIZZLY_SMS_BASE_URL": "https://api.grizzlysms.com"
}
}
}
}OpenClaw (mcpServers)
Путь: ~/.openclaw/openclaw.json (macOS/Linux) | %APPDATA%\.openclaw\openclaw.json (Windows)
{
"agents": {
"list": [{
"id": "main",
"mcpServers": {
"grizzly-sms": {
"command": "node",
"args": ["/абсолютный/путь/к/grizzly-sms-mcp/dist/index.js"],
"env": {
"GRIZZLY_SMS_API_KEY": "ваш_api_ключ",
"GRIZZLY_SMS_BASE_URL": "https://api.grizzlysms.com"
}
}
}
}
}
}Используйте абсолютные пути. После изменений: openclaw gateway restart
Конфигурация: OpenClaw Skill (только skills, без mcpServers)
Добавьте путь к skill в
openclaw.json:
{
"skills": {
"load": {
"extraDirs": ["/абсолютный/путь/к/grizzly-sms-mcp"]
},
"entries": {
"grizzly_sms": {
"enabled": true
}
}
}
}Включите инструменты exec и по необходимости browser
Перезапуск:
npx openclaw gateway restart
Полная настройка (exec approvals, browser, API key в диалоге) — в CONFIG.md.
Справка по MCP‑инструментам
Инструмент | Параметры | Описание |
| service (обяз.), country (опц.), maxPrice, providerIds, exceptProviderIds | Аренда виртуального номера |
| activationId (обяз.) | Статус активации и SMS‑код |
| activationId, status (6=завершить, 8=отменить) | Изменение статуса |
| — | Баланс |
| — | Адрес кошелька USDT TRC-20 для пополнения |
| — | Список стран |
| — | Список сервисов |
| service, country (опц.) | Цены |
Коды сервисов
Код | Сервис |
tg | Telegram |
wa | |
ig | |
fb | |
go | |
ub | Uber |
ID стран
ID | Страна |
73 | Бразилия |
1 | Украина |
16 | Англия |
187 | США |
22 | Индия |
Решение проблем
GRIZZLY_SMS_API_KEY required — Задайте в
.env, конфиге или передайте в чате (Skill)BAD_KEY — Проверьте ключ на grizzlysms.com
NO_BALANCE — Пополните на grizzlysms.com (USDT TRC-20)
exec not permitted — Настройте exec approvals в CONFIG.md
Поддержка
API: grizzlysms.com/docs
Сайт: grizzlysms.com
Issues: GitHub Issues
Лицензия
MIT — см. LICENSE
Available Tools
8 toolsget_balanceB
Get account balance
Inputs: no named parameters.
get_countriesB
Get list of available countries
Inputs: no named parameters.
get_pricesB
Get prices for services by country
Inputs: country, service, version.
get_servicesB
Get list of available services
Inputs: no named parameters.
get_statusC
Get activation status and SMS code
Inputs: activationId (required).
get_walletA
Get USDT TRC-20 crypto wallet address for balance top-up. Send USDT to this address (min 50 USD). Funds credit automatically.
Inputs: no named parameters.
request_numberB
Request a phone number for SMS verification
Inputs: service (required), ref, ref_id, country, +8 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
Scored across 8 tools
Each tool targets a distinct aspect of the SMS verification workflow: account finances, number requests, status management, and reference data. There is no meaningful overlap between any pair of tools.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., get_balance, request_number). The naming is uniform and predictable across the entire set.
With 8 tools, the server is well-scoped for an SMS verification service. Every tool serves a clear function without unnecessary bloat or missing essentials.
The tools cover the core lifecycle: top-up (get_wallet, get_balance), request a number (request_number), poll for SMS (get_status, set_status), and reference data (get_prices, get_countries, get_services). This appears sufficient for the stated purpose.
Maintenance
Related MCP Connectors
ORDan's MCP server: calls, SMS and phone numbers for AI agents, under their owner's spend controls
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Hosted Telegram MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Hosted MCP server connecting AI assistants to 9,000+ apps and 40,000+ actions via Zapier.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for provisioning dedicated real-SIM US phone numbers, receiving inbound SMS, and extracting OTP codes. Built for AI agents automating phone verification workflows.12506 npm1MIT
- AlicenseNot gradedqualityDmaintenanceMCP 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.2MIT

agentsim-mcpofficial
AlicenseAqualityBmaintenanceMCP server that enables AI coding assistants to provision temporary US phone numbers and receive SMS OTPs for verification workflows.51MIT- AlicenseBqualityDmaintenanceMCP server for sending SMS via the SMSPM API. Send transactional SMS from Claude Desktop, Cursor, Windsurf, Cline, or any MCP client.132 npmMIT