Skip to main content
Glama
BudgetSMS MCP server

BudgetSMS MCP server

Official
by budgetsms
README.md
# BudgetSMS MCP server

An [MCP](https://modelcontextprotocol.io/) server that gives Claude, ChatGPT and other MCP clients access to the [BudgetSMS SMS API](https://www.budgetsms.net/sms-http-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](https://www.budgetsms.net/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 |

## Claude Code

```bash
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):

```json
{
  "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](https://www.budgetsms.net/sms-gateway-pricing/).
- `BUDGETSMS_BASE_URL` overrides the API base URL (default `https://api.budgetsms.net/`).

## License

MIT