Adjust points
Add loyalty points to a viewer, or take points away with a negative amount.
MCP tool streamelements_write → adjust_points
write Confirm
Adds the amount to the viewer's current balance, like Give Points on the Leaderboard tab, and returns the new balance. A negative amount removes points. A viewer can hold at most 2,147,483,647 points. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| username string required | string | Viewer username, as on the leaderboard. |
| amount integer required | integer | Points to add. Negative removes points. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "streamelements_write",
"arguments": {
"operation": "adjust_points",
"arguments": {
"username": "mika_r",
"amount": 500
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"username": "mika_r",
"added": 500,
"points": 2340
},
"isError": false
}