List SMS conversations
SMS threads of your numbers, most recent first, with the last message and unread count.
MCP tool ringover_read → list_sms_conversations
read
Lists the threads of the SMS inbox for the mobile numbers your user can use, most recent first. Each thread shows the other number, the contact when known, the last message with its direction and the unread count the app shows as a red badge. conversation_id goes into get_sms_conversation. Needs the Business plan, as SMS does in the app.
Parameters
| Name | Type | Description |
|---|---|---|
| unread_only boolean | boolean | Only threads with unread messages. Default: false. |
| your_number string | string | Only threads of this mobile number of yours. |
| limit integer | integer | How many threads per page. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "ringover_read",
"arguments": {
"operation": "list_sms_conversations",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"conversations": [
{
"conversation_id": "sms_3301",
"number": "+15550100142",
"contact": "Dana Whitfield",
"your_number": "+15550100100",
"last_message": {
"direction": "incoming",
"text": "Thursday at 10 works.",
"at": "2026-10-22T11:02:00Z"
},
"unread": 1
}
],
"next_cursor": null
},
"isError": false
}