send_sms
Send an SMS through the TopSMS gateway to a phone number; supports optional sender ID, scheduled delivery, and returns message ID, segment count, and price.
Instructions
Send one SMS message via the TopSMS SMS gateway (topsms.eu / topsms.cz). Costs credit: 160 GSM-7 chars = 1 SMS, 70 with other diacritics/emoji. Returns message id, number of segments and price in your account currency (field currency: EUR for topsms.eu accounts, CZK for topsms.cz).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"to": "<to>",
"text": "<text>"
},
"name": "send_sms"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Phone number in international format, e.g. +420601234567 (Czech numbers without prefix are accepted). | |
| from | No | Approved Sender ID (max 11 chars). Omit to use the default sender "TopSMS". | |
| text | Yes | Message text. | |
| send_at | No | Schedule for later: ISO 8601 with timezone, e.g. 2026-10-01T09:00:00+02:00 (max 30 days ahead). Omit to send now. Scheduled sends return a jobId that can be cancelled with cancel_scheduled. | |
| idempotencyKey | No | Optional Idempotency-Key (e.g. a UUID). Repeating a call with the same key never sends the SMS twice; the original response is returned. |