List campaigns
Campaigns with status, subject, list, how many contacts they were sent to and open and click rates.
MCP tool emailoctopus_read → list_campaigns
read
Returns campaigns the way the Campaigns tab lists them, newest first unless you sort. status filters to sent, scheduled or draft. search matches the campaign name or subject; prefix a term with name: or subject: to search one of them. sort is name, date, open_rate, click_rate or sent. date is the day the campaign was sent, or scheduled for, or created for a draft. Pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | all, sent, scheduled or draft. Default: all. |
| search string | string | Text in the campaign name or subject; name: or subject: limits the search. |
| sort enum | enum | date, name, open_rate, click_rate or sent. Default: date. |
| order enum | enum | asc or desc. Default: desc. |
| cursor string | string | next_cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "emailoctopus_read",
"arguments": {
"operation": "list_campaigns",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"campaigns": [
{
"campaign_id": "c7a41b92-0d3e-4f58-b6a1-2e9d8c5f7014",
"name": "Autumn offer",
"subject": "Autumn offer: 20% off the new menu",
"status": "sent",
"list": "Newsletter",
"sent_to": 1840,
"open_rate": 38.2,
"click_rate": 5.2,
"date": "2026-10-14"
},
{
"campaign_id": "a2f9d6e3-81b4-4c07-9e5a-7d1c3b8f2e60",
"name": "Weekly newsletter",
"subject": "This week at Northside",
"status": "scheduled",
"list": "Newsletter",
"sent_to": null,
"open_rate": null,
"click_rate": null,
"date": "2026-10-23"
}
],
"next_cursor": null
},
"isError": false
}