Skip to main content
Glama
BudgetSMS MCP server

BudgetSMS MCP server

Official
by budgetsms

BudgetSMS MCP server

An MCP server that gives Claude, ChatGPT and other MCP clients access to the BudgetSMS SMS API: send SMS to 900+ operators worldwide, validate a message and its price without sending, check the account credit, look up the network of a number and read your prices.

Needs Node.js 18 or newer and a BudgetSMS account (free test credit on signup). The credentials come from the control panel, API details.

Tools

Tool

What it does

Charged

test_sms

simulates a send (no SMS is sent) to check credentials and connectivity (random id and price, sometimes a simulated error)

no

send_sms

sends a real SMS, returns the message id, price and remaining credit

yes

check_credit

prepaid credit in euro

no

lookup_number

network of a number (NP), or NP plus reachability (HLR)

per lookup

message_status

delivery status of a sent message

no

pricing

your price per operator, optionally filtered by country

no

Related MCP server: commune-mcp

Claude Code

claude mcp add budgetsms -e BUDGETSMS_USERNAME=USERNAME -e BUDGETSMS_USERID=USERID -e BUDGETSMS_HANDLE=HANDLE -- npx -y budgetsms-mcp

Claude Desktop and other clients

Add to the MCP configuration (claude_desktop_config.json for Claude Desktop):

{
  "mcpServers": {
    "budgetsms": {
      "command": "npx",
      "args": ["-y", "budgetsms-mcp"],
      "env": {
        "BUDGETSMS_USERNAME": "USERNAME",
        "BUDGETSMS_USERID": "USERID",
        "BUDGETSMS_HANDLE": "HANDLE"
      }
    }
  }
}

Then ask, for example: "Send an SMS to 31612345678 from MyShop saying the order has shipped", "What does an SMS to Germany cost?" or "Is 31612345678 a Vodafone number?". Ask for the price with pricing before a real send; send_sms costs money, so keep the account credit modest for an experiment.

Notes

  • Numbers are written in international format without + or 00: 31612345678.

  • Some countries require registration of alphanumeric sender ids; see the country pages on budgetsms.net.

  • BUDGETSMS_BASE_URL overrides the API base URL (default https://api.budgetsms.net/).

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables AI assistants and MCP-compatible clients to send and manage SMS messages through the 46elks API, leveraging Swedish telecommunications infrastructure.
      6
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Give Claude (or any MCP client) a real email inbox and SMS. Your AI agent can read and send email, manage inboxes, track delivery, and handle SMS.
      27
      1
      Apache 2.0
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables Claude to read, organize, and send SMS messages through your ClickSend account.
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables MCP clients such as Claude and Cursor to purchase virtual phone numbers, wait for SMS verification codes, and resend, complete, or cancel activations using the user's API key.
      9
      13 npm
      MIT