List SMS history
Sent, failed and scheduled texts from SMS > History, newest first, with status, number and date.
MCP tool clicksend_read → list_sms_history
read
Returns one page of SMS > History, 50 messages to a page; pass next_cursor back as cursor for older ones. History shows two statuses: Sent means ClickSend handed the message to the carrier, not that it arrived. Quick SMS messages scheduled for later show here with their send time; scheduled campaigns do not, use list_sms_campaigns. ClickSend keeps full message data for four months.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | sent or failed. Default: both. |
| to string | string | Recipient number. |
| from string | string | Sender number or alpha tag. |
| contact_name string | string | Name of a contact. |
| date_from date | date | Messages on or after this date. |
| date_to date | date | Messages on or before this date. A future date shows messages scheduled to send. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "clicksend_read",
"arguments": {
"operation": "list_sms_history",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"messages": [
{
"message_id": "7D2F4C1E-8B3A-4F6D-9E21-5A0C7B1D3E92",
"to": "+447700900142",
"from": "+15550100188",
"status": "failed",
"sent_at": "2026-10-22 18:04"
},
{
"message_id": "3B9A5E70-12C4-4D8F-A6B3-0E7D4C2F1A58",
"to": "+447700900177",
"from": "+15550100188",
"status": "sent",
"sent_at": "2026-10-22 18:04"
}
],
"next_cursor": null
},
"isError": false
}