List contacts
Contacts of one list with name, phone number and email.
MCP tool clicksend_read → list_contacts
read
Returns the contacts of one list, 50 to a page; pass next_cursor back as cursor for the next page. query matches a phone number, an email or a name inside the list. Phone numbers come back as ClickSend stores them, with the country code. contact_id goes into remove_contact.
Parameters
| Name | Type | Description |
|---|---|---|
| list_id integer required | integer | Contact list ID from list_contact_lists. |
| query string | string | Phone number, email or name to find inside the list. |
| 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_contacts",
"arguments": {
"list_id": 1
}
}
}
} Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"contacts": [
{
"contact_id": 9012841,
"first_name": "Lena",
"last_name": "Ortiz",
"phone_number": "+447700900142",
"email": "lena@example.com"
}
],
"next_cursor": null
},
"isError": false
}