Grizzly SMS — MCP Server & OpenClaw Skill

English | Русский

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_status
• Account: get_balance
• Info: 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

1. API key — Bot asks: Please provide your Grizzly SMS API key
2. Balance & top-up — Bot can show balance and crypto wallet address for USDT TRC-20 top-up
3. Number — Bot rents a number for the requested service and country
4. Status — Bot can cancel an activation or request a new SMS
5. SMS — Bot polls and returns the verification code
6. 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 build

Configuration: 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)

1. Add skill path to openclaw.json:

{
  "skills": {
    "load": {
      "extraDirs": ["/absolute/path/to/grizzly-sms-mcp"]
    },
    "entries": {
      "grizzly_sms": {
        "enabled": true
      }
    }
  }
}

2. Enable exec and optionally browser tools for the agent
3. Restart: npx openclaw gateway restart

Full setup (exec approvals, browser tool, API key in dialog) — see CONFIG.md.

MCP Tools Reference

| Tool | Parameters | Description | |------|------------|-------------| | request_number | service (required), country (optional), maxPrice, providerIds, exceptProviderIds | Rent a virtual number | | get_status | activationId (required) | Get activation status and SMS code | | set_status | activationId, status (6=complete, 8=cancel) | Change activation status | | get_balance | — | Check balance | | get_wallet | — | Get USDT TRC-20 wallet address for top-up | | get_countries | — | List countries | | get_services | — | List services | | get_prices | service, country (optional) | Get prices |

Common Service Codes

| Code | Service | |------|---------| | tg | Telegram | | wa | WhatsApp | | ig | Instagram | | fb | Facebook | | go | Google | | 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.md

Development

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 methods

Troubleshooting

• 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

Русский

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

1. API‑ключ — бот спрашивает: Выдайте API ключ Grizzly SMS
2. Баланс и пополнение — бот показывает баланс и адрес кошелька USDT TRC-20
3. Номер — бот арендует номер для указанного сервиса и страны
4. Статус — бот может отменить активацию или запросить новый SMS
5. SMS — бот опрашивает статус и возвращает код
6. Завершение — бот помечает активацию выполненной после использования кода

Подробная настройка — в 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)

1. Добавьте путь к skill в openclaw.json:

{
  "skills": {
    "load": {
      "extraDirs": ["/абсолютный/путь/к/grizzly-sms-mcp"]
    },
    "entries": {
      "grizzly_sms": {
        "enabled": true
      }
    }
  }
}

2. Включите инструменты exec и по необходимости browser
3. Перезапуск: npx openclaw gateway restart

Полная настройка (exec approvals, browser, API key в диалоге) — в CONFIG.md.

Справка по MCP‑инструментам

| Инструмент | Параметры | Описание | |------------|-----------|----------| | request_number | service (обяз.), country (опц.), maxPrice, providerIds, exceptProviderIds | Аренда виртуального номера | | get_status | activationId (обяз.) | Статус активации и SMS‑код | | set_status | activationId, status (6=завершить, 8=отменить) | Изменение статуса | | get_balance | — | Баланс | | get_wallet | — | Адрес кошелька USDT TRC-20 для пополнения | | get_countries | — | Список стран | | get_services | — | Список сервисов | | get_prices | service, country (опц.) | Цены |

Коды сервисов

| Код | Сервис | |-----|--------| | tg | Telegram | | wa | WhatsApp | | ig | Instagram | | fb | Facebook | | go | Google | | 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