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

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

Common Service Codes

Common Country IDs

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

Related MCP server: VirtualSMS MCP Server

Русский

MCP (Model Context Protocol) сервер и OpenClaw Skill для интеграции с Grizzly SMS — платформой SMS верификации и виртуальных номеров. Совместимо с Cursor, Claude Desktop, OpenClaw (режимы MCP и Skill).

Что предоставляет проект

Возможности

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‑инструментам

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

ID стран

Решение проблем

• 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