List lists
Lists of your EmailOctopus account with their subscribed, pending and unsubscribed counts.
MCP tool emailoctopus_read → list_lists
read
Returns every list of the account with its list_id, name and the counts of subscribed, pending and unsubscribed contacts. Use list_id as the list_id parameter of the other tools. Pending contacts are those who have not yet confirmed on a list with double opt-in. Contacts live at list level, so the same email address on two lists is counted on both.
Parameters
No parameters.
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "emailoctopus_read",
"arguments": {
"operation": "list_lists",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"lists": [
{
"list_id": "4d1c8e5a-7f2b-4c1e-9a63-0b5d2e8f1a37",
"name": "Newsletter",
"subscribed": 4860,
"pending": 12,
"unsubscribed": 341
},
{
"list_id": "9b6e2f10-3c5a-4d7e-8f21-a1c4e7d90b52",
"name": "Workshop waitlist",
"subscribed": 214,
"pending": 0,
"unsubscribed": 9
}
]
},
"isError": false
}