BudgetSMS MCP server
Officialby 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
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessOutdated data