List timers
Chat timers with their messages, online interval, chat lines and whether they are on.
MCP tool streamelements_read → list_timers
read
Returns the chat timers of your channel. A timer can hold several messages that it cycles through. Online interval is in minutes while the stream is live, and chat lines is the least number of chat messages in the last 5 minutes that lets the timer fire. Pass timer_id to update_timer.
Parameters
| Name | Type | Description |
|---|---|---|
| enabled boolean | boolean | Only timers that are on (true) or off (false). |
| limit integer | integer | 1 to 100. Default: 50. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "streamelements_read",
"arguments": {
"operation": "list_timers",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"timers": [
{
"timer_id": "t_20c7aa",
"name": "Charity stream",
"messages": [
"Charity stream on Saturday! Details in !schedule"
],
"online_interval_minutes": 30,
"chat_lines": 5,
"enabled": true
}
],
"next_cursor": null
},
"isError": false
}