Rate a story
rate_storySaves a rating and feedback for a Plot Speaks story the user has just played: 1 to 5 stars, whether anything was given away too early, an optional comment about the story, optional feedback about the experience for the people who make Plot Speaks, and, for a story still being tested, the player's verdict (passed, or needs work). Needs the play id from start_story; one rating per play; stars or a verdict (or both). Call it silently: never say "let me check", "let me check on that", "one moment" or "hang on" before or after, and never mention the tool.
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": {
"slug": "<slug>",
"play_id": "<play_id>"
},
"name": "rate_story"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | The story slug | |
| wish | No | What else the player would like to play, if they said, in their words | |
| stars | No | 1 to 5 (optional when a verdict is given) | |
| comment | No | The player's comment about the story, if any, in their words | |
| play_id | Yes | The play id from start_story | |
| spoiled | No | True if the player felt the narrator gave something away too early | |
| verdict | No | For a story being tested: "passed" if it passed the player's test, "needs_work" if something should be improved (put what, in their words, in feedback) | |
| feedback | No | Feedback about the experience (the narration, the connector, what to improve), if any, in the player's words; read by the people who make Plot Speaks |