List contacts
Contacts of one list with their properties, filtered by segment or email address.
MCP tool mailjet_read → list_contacts
read
Lists the contacts of one contact list with their email address, subscription state and contact properties such as first name. segment narrows it to a segment from list_segments, and search matches a complete email address. Pass next_cursor back as cursor for the next page. The response also carries the total number of matching contacts.
Parameters
| Name | Type | Description |
|---|---|---|
| list_id integer required | integer | Contact list ID from list_contact_lists. |
| segment string | string | Name of a segment from list_segments. |
| search string | string | A complete email address to look for. |
| cursor string | string | next_cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "mailjet_read",
"arguments": {
"operation": "list_contacts",
"arguments": {
"list_id": 1
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"total": 197,
"contacts": [
{
"email": "sam@example.com",
"subscribed": true,
"properties": {
"firstname": "Sam",
"country": "GB"
}
},
{
"email": "lena@example.org",
"subscribed": true,
"properties": {
"firstname": "Lena",
"country": "DE"
}
}
],
"next_cursor": "2"
},
"isError": false
}