List tips
Tips your channel received, with amount, currency, tipper, message and time. Read only.
MCP tool streamelements_read → list_tips
read
Returns tips newest first by default, one row per tip. Sort by time or by amount, and filter by username or a date range. Currency is the one set in your Tipping settings. The tool only reads: it moves no money and does not change tip moderation.
Parameters
| Name | Type | Description |
|---|---|---|
| since datetime | datetime | Only tips after this time. |
| until datetime | datetime | Only tips before this time. |
| username string | string | Only tips from this username. |
| sort enum | enum | newest, oldest, amount_desc or amount_asc. Default: newest. |
| limit integer | integer | 1 to 100. Default: 25. |
| 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_tips",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"tips": [
{
"tip_id": "tp_77d1c2",
"username": "mika_r",
"amount": 25,
"currency": "USD",
"message": "Great stream, keep it up!",
"created_at": "2026-10-14T20:11:00Z"
}
],
"next_cursor": null
},
"isError": false
}