mcpField
S
sms-ru-mcp

sms-ru-mcp

Local
github.com/theYahiaCommunication0Updated 8w ago
Repository

About sms-ru-mcp

sms-ru-mcp connects the SMS.RU messaging API to MCP for users who need to send texts and check account details. Its tools cover sending, delivery status, balance, cost estimates, and sender names.

Key features

  1. 01Send SMS with an optional sender name
  2. 02Check message status by ID
  3. 03View account balance
  4. 04Estimate SMS cost before sending
  5. 05List approved sender names

Use cases

  1. 01Send a text to a specified number
  2. 02Verify whether a message was delivered
  3. 03Estimate message cost before sending
  4. 04Check balance and available sender names

MCP support

It exposes five SMS.RU API tools to MCP clients. It requires SMS_RU_API_ID and supports stdio and Streamable HTTP.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "theyahia-sms-ru": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/sms-ru-mcp"
      ],
      "env": {
        "SMS_RU_API_ID": "<SMS_RU_API_ID>"
      }
    }
  }
}
Run commandnpx -y @theyahia/sms-ru-mcp
Environment variables to set
SMS_RU_API_IDSecretAPI key for the service

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@theyahia/sms-ru-mcp1.0.1

Tools

3

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
tostringYesRecipient number (format: 79XXXXXXXXX)
msgstringYesMessage text
fromstringNoSender name (if approved)

Details

From the project README

SMS.RU MCP — отправка СМС из нейросети без написания кода

Если вы искали, как отправить SMS прямо из диалога с ИИ-ассистентом, проверить доставку сообщения или узнать остаток на счету не заходя в кабинет — это оно. 5 инструментов поверх API SMS.RU: отправка SMS, статус сообщения, баланс, расчёт стоимости и список отправителей.

npm License: MIT

Часть серии Russian API MCP (50 серверов) by @theYahia.

Установка

Claude Desktop
{
  "mcpServers": {
    "sms-ru": {
      "command": "npx",
      "args": ["-y", "@theyahia/sms-ru-mcp"],
      "env": { "SMS_RU_API_ID": "your-api-id" }
    }
  }
}
Claude Code
claude mcp add sms-ru -e SMS_RU_API_ID=your-api-id -- npx -y @theyahia/sms-ru-mcp
VS Code / Cursor
{ "servers": { "sms-ru": { "command": "npx", "args": ["-y", "@theyahia/sms-ru-mcp"], "env": { "SMS_RU_API_ID": "your-api-id" } } } }
Streamable HTTP
SMS_RU_API_ID=your-api-id npx @theyahia/sms-ru-mcp --http
# POST http://localhost:8080/mcp
# GET  http://localhost:8080/health
Smithery

smithery badge

npx -y @smithery/cli install @theyahia/sms-ru-mcp --client claude

Требуется SMS_RU_API_ID. Получите на sms.ru.

Инструменты (5)

ИнструментОписание
send_smsОтправить SMS (номер, текст, опционально имя отправителя)
check_statusПроверить статус SMS по ID
get_balanceБаланс аккаунта SMS.RU
get_costРассчитать стоимость SMS до отправки
get_sendersСписок одобренных имён отправителей

Skills (Claude Code)

SkillТриггер
/send-sms«Отправь SMS на номер...»
/check-balance«Проверь баланс SMS.ru»

Примеры

Отправь SMS на 79001234567 с текстом "Привет"
Сколько будет стоить SMS на 79001234567 "Тестовое сообщение"?
Проверь статус сообщения 123456
Какой баланс на SMS.RU?
Покажи список отправителей

Разработка

npm install
npm run build
npm test

Лицензия

MIT

Telegram: @vhodvai

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.