Start a story
start_storyLoads a Plot Speaks story or game, of any kind (mystery, choose-your-path, trivia, dice or word game, Team Trivia, campaign), by slug or title. Returns its script as text (setting, cast, scenes or board, and how it is narrated; one chapter at a time for multi-chapter stories) and a play id the play's other tools take. Records an anonymous play (story, connecting assistant, time; no conversation text), and on the account connector adds it to the player's history. An unknown slug or title returns an error naming close matches or the available stories; a chapter past the last returns an error; an unreleased chapter returns its release date. 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>"
},
"name": "start_story"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | The story's slug or title, matched loosely, 2 to 80 characters, e.g. example-dinner-party or The Last Toast | |
| team | No | For the team-trivia story: the team as the player said it, e.g. Steelers, Pittsburgh or PIT; "Yankees vs Red Sox" gives a rivalry board. Several matches or an unsupported team return a message instead of a board | |
| chapter | No | Chapter number for a multi-chapter story, e.g. 2 for the second chapter (default 1); an error if the story has fewer chapters | |
| minutes | No | For a trivia game: minutes the player has, e.g. 25, so the game is sized to fit | |
| play_id | No | With chapter above 1: the play id returned for chapter 1, e.g. 3f2b8c1e-9d4a-4e7b-a1c2-5b6d7e8f9a0b, so both chapters count as one play; ignored if it belongs to another story | |
| path_code | No | For a choose-your-path story: the three-word path code a friend received at an ending, e.g. brave-river-stone, to follow that friend's choices; codes last 30 days, an unknown one returns an error | |
| resume_code | No | For a campaign: the three-word code given at the end of an earlier session, e.g. amber-otter-lantern; carries on that campaign's world instead of starting one. An unknown code returns an error | |
| versus_code | No | For a trivia board: the three-word code a friend received at the end of their game, to play the same board and compare scores; pass slug "versus" with it, the code names the game. Codes last 30 days | |
| new_campaign | No | For a campaign, when a signed-in player already has one: true starts a fresh campaign instead of carrying on their latest (default false) |