add_points
Add (or with a negative number, remove) points for a listener on a RankFuel leaderboard. Needs the board id and its SECRET manage token. The listener is identified by public display name (+ optional town); a new name is added to the board automatically. PRIVACY: names are public, so use a first name plus last initial or a nickname; full names are shortened to "Jane S." and phone numbers or emails are rejected. Returns the listener's new total and rank and the top 10. Free, no key.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"boardId": "<boardId>",
"manageToken": "<manageToken>",
"listener": "<listener>",
"points": "<points>"
},
"name": "add_points"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| town | No | Optional town shown on the board; tells same-name listeners apart | |
| points | Yes | Points to add, -1000..1000, not 0 (negative removes) | |
| reason | No | Optional short label, e.g. call-in, trivia, check-in (max 24 characters) | |
| boardId | Yes | Leaderboard id (10 characters) or its public link, e.g. https://rfwin.uk/lb/abc123defg | |
| listener | Yes | Public display name: first name + last initial, or a nickname/handle. No phone numbers or emails. | |
| manageToken | Yes | SECRET manage token (rlb_…) returned once by create_leaderboard (the manage link also works). Keep private; never show it in public places. |