Submit a story
submit_storySubmits a finished Plot Speaks story for human review, credited to the name the writer chooses. Runs the format checks, a safety screen and a daily limit, then stores it; nothing is public until a person approves it. Returns a submission id and a one-time claim code for withdrawing or updating it. With replaces_id and claim_code, it replaces an earlier submission. 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": {
"story_md": "<story_md>",
"author_name": "<author_name>"
},
"name": "submit_story"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| contact | No | Optional: how the reviewer can reach the writer (email or handle). Seen only by the reviewer. | |
| story_md | Yes | The full text of story.md | |
| claim_code | No | Only to update an earlier submission: the claim code from its receipt | |
| secrets_md | No | The full text of secrets.md (kept private on the server; mysteries need one) | |
| author_name | Yes | The name credited publicly as "Written by" (2 to 60 characters; a pen name is fine). Checked by the reviewer with the story. | |
| replaces_id | No | Only to update an earlier submission: its submission id | |
| email_when_approved | No | True records the writer's request for one email, to the verified Google address of the account they signed in with, when a person approves the story (default false: no email). It takes effect only on the account connector with a verified address, is ignored on the open connector, and the receipt says whether it was accepted. The writer can turn it off at plotspeaks.com/account |