List segments
Saved segments of a list with the conditions each one is built from.
MCP tool emailoctopus_read → list_segments
read
Returns the reusable segments shown on the Segments tab of the Contacts page: name, match type (all, any or none) and the conditions in the words of the segment editor. Use a segment name as the segment parameter of list_contacts, set_campaign_recipients and unsubscribe_contacts. One-off segments built inside a campaign are not saved, so they do not appear.
Parameters
| Name | Type | Description |
|---|---|---|
| list_id string required | string | List ID from list_lists. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "emailoctopus_read",
"arguments": {
"operation": "list_segments",
"arguments": {
"list_id": "list_8c41d2"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"segments": [
{
"name": "Clicked in last 90 days",
"match": "all",
"conditions": [
"Campaign activity: clicked, any campaign within the last 90 days"
]
},
{
"name": "Did not open: Autumn offer",
"match": "all",
"conditions": [
"Campaign activity: did not open, Autumn offer",
"Campaign activity: was sent, Autumn offer"
]
}
]
},
"isError": false
}