kwtSMS MCP server

Let AI assistants (Claude, Cursor, VS Code, any MCP client) send SMS, check your balance, Sender IDs and coverage through kwtSMS, the SMS gateway in Kuwait. Safe by default: nothing reaches a phone until you, the account owner, switch live sending on.

Tools

Related MCP server: Twilio SMS MCP Server

Safety

An AI model can be tricked by a web page or an email it reads. The server, not the model, enforces these rules:

• Preview by default. send_sms only checks the numbers and counts parts and credits.

• Test mode (mode: "test") sends with test=1: the message is never delivered, and its credits are held until you delete it from the Queue in your kwtSMS account.

• Live sending works only when you set KWTSMS_MCP_ALLOW_LIVE=1, and every live send needs confirm: true.

• Limits: 10 numbers per call, 50 numbers an hour, 100 credits a day, Kuwait numbers only (change with the settings below).

• Your Sender ID is fixed in your settings; the model cannot choose another one.

• No double sends: a repeated client_ref returns the first result.

• Your password is never logged or shown, and phone numbers are masked in results.

Use a dedicated kwtSMS API user for AI tools, not your main login.

Install

Needs Node.js 18 or newer. Get your API username and password from your kwtSMS account (sign up).

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "kwtsms": {
      "command": "npx",
      "args": ["-y", "kwtsms-mcp"],
      "env": {
        "KWTSMS_USERNAME": "your_api_username",
        "KWTSMS_PASSWORD": "your_api_password",
        "KWTSMS_SENDER_ID": "YOUR-SENDER"
      }
    }
  }
}

Claude Code:

claude mcp add kwtsms --env KWTSMS_USERNAME=your_api_username --env KWTSMS_PASSWORD=your_api_password \
  --env KWTSMS_SENDER_ID=YOUR-SENDER -- npx -y kwtsms-mcp

Cursor, VS Code and other clients: the same command (npx -y kwtsms-mcp) and environment variables.

Settings

Run npx -y kwtsms-mcp --help for the same list.

Example

"Send 'Your order is ready' to 965XXXXXXXX"

The assistant previews first: one number, 1 part, 1 credit, Sender ID YOUR-SENDER. You approve, it sends in test or live mode as you allowed.

بالعربي

يتيح هذا الخادم لمساعدات الذكاء الاصطناعي إرسال رسائل SMS عبر kwtSMS ومعرفة الرصيد واسم المرسل. الوضع الافتراضي معاينة فقط دون إرسال. الإرسال التجريبي لا يصل إلى الهاتف، وتبقى نقاطه محجوزة حتى تحذفه من طابور الارسال. الإرسال الفعلي لا يعمل إلا إذا فعّله صاحب الحساب بالإعداد KWTSMS_MCP_ALLOW_LIVE=1.

Support

kwtsms.com/support.html. Security reports: see SECURITY.md.

License

MIT