Playloop is an MCP server published by com.tryplayloop, hosted at mcp.tryplayloop.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 8 tools, including get_authoring_context, list_quizzes, get_quiz, create_quiz, update_quiz.
Make group quiz games: create and edit quizzes, invite friends to add questions, reuse rounds.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Use first when making a quiz or game. Get supported formats, defaults, account hosting limits and access, and what people do only in Playloop. create_quiz creates a lobby; promise invitation links only when the result contains them.
No parameters.
{
"name": "get_authoring_context",
"title": "Get quiz authoring capabilities",
"description": "Use first when making a quiz or game. Get supported formats, defaults, account hosting limits and access, and what people do only in Playloop. create_quiz creates a lobby; promise invitation links only when the result contains them.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
Inferred from the host name and headers: what a server runs on, not who runs it.
Use when the user wants to find, edit, reuse or replay a game they hosted earlier. Returns their own games newest first, with player counts and replayEditionId when a finished game can be played again exactly; get_quiz retrieves the full content.
| Parameter | Type | Description |
|---|---|---|
| query | string |
{
"name": "list_quizzes",
"title": "Find my games",
"description": "Use when the user wants to find, edit, reuse or replay a game they hosted earlier. Returns their own games newest first, with player counts and replayEditionId when a finished game can be played again exactly; get_quiz retrieves the full content.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"query": {
"type": "string",
"maxLength": 120
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use before editing or reusing an owned game, or to check who has joined its lobby and is ready. Returns the prepared-content revision, rounds, question count, validation issues, links, and each joined player with readiness and how many questions they submitted. Replay definitions read the frozen edition: prepared rounds include questions; private contribution rounds expose only positions and counts with contentHidden true. Never returns other players' contribution content or gameplay.
| Parameter | Type | Description |
|---|---|---|
| runId * | string | The game ID (runId) returned by create_quiz, list_quizzes or get_quiz. |
{
"name": "get_quiz",
"title": "Read a game's prepared rounds",
"description": "Use before editing or reusing an owned game, or to check who has joined its lobby and is ready. Returns the prepared-content revision, rounds, question count, validation issues, links, and each joined player with readiness and how many questions they submitted. Replay definitions read the frozen edition: prepared rounds include questions; private contribution rounds expose only positions and counts with contentHidden true. Never returns other players' contribution content or gameplay.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"runId"
],
"properties": {
"runId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The game ID (runId) returned by create_quiz, list_quizzes or get_quiz."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for requests to make a quiz or game for friends, or to reuse an earlier quiz as a new game. Supply complete rounds, questions and answers. Creates a real editable lobby and returns host and invitation links. Free access and no contributions are defaults. Use paid single-edition access only with user authorization. Retry identical input with the same requestId, including after timeouts; never create a replacement quiz. Never starts gameplay. Summarize without revealing answers; follow-up edits target the returned runId.
| Parameter | Type | Description |
|---|---|---|
| title * | string | |
| access | any | Free access by default. Select an owned paid grant only with the user’s authorization; single-edition access is bound to the new game. |
| blocks * | array | |
| nickname | string | Host player name. Use Host when no name was supplied. |
| settings | object | |
| requestId * | string | Stable UUID for this intent. Reuse it with identical arguments after a lost response; use a new UUID for a different action. |
{
"name": "create_quiz",
"title": "Create a quiz and invite friends",
"description": "Use for requests to make a quiz or game for friends, or to reuse an earlier quiz as a new game. Supply complete rounds, questions and answers. Creates a real editable lobby and returns host and invitation links. Free access and no contributions are defaults. Use paid single-edition access only with user authorization. Retry identical input with the same requestId, including after timeouts; never create a replacement quiz. Never starts gameplay. Summarize without revealing answers; follow-up edits target the returned runId.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"title",
"requestId",
"blocks"
],
"properties": {
"title": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"access": {
"oneOf": [
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"type": "string",
"const": "demo"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"grantId"
],
"properties": {
"kind": {
"type": "string",
"const": "grant"
},
"grantId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}
],
"default": {
"kind": "demo"
},
"description": "Free access by default. Select an owned paid grant only with the user’s authorization; single-edition access is bound to the new game."
},
"blocks": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"questions"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"title": {
"type": "string",
"maxLength": 120
},
"questions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"id",
"schemaVersion",
"prompt",
"timeLimitSeconds",
"points",
"type",
"choices",
"solution"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"type": {
"type": "string",
"const": "single_choice"
},
"image": {
"type": "object",
"required": [
"assetId",
"alt"
],
"properties": {
"alt": {
"type": "string",
"maxLength": 300
},
"assetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"points": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"prompt": {
"type": "string",
"maxLength": 1000
},
"choices": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"text"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+$",
"maxLength": 64,
"minLength": 1
},
"text": {
"type": "string",
"maxLength": 300
},
"image": {
"type": "object",
"required": [
"assetId",
"alt"
],
"properties": {
"alt": {
"type": "string",
"maxLength": 300
},
"assetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"maxItems": 6,
"minItems": 2
},
"solution": {
"type": "object",
"required": [
"correctChoiceId"
],
"properties": {
"correctChoiceId": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+$",
"maxLength": 64,
"minLength": 1
}
},
"additionalProperties": false
},
"schemaVersion": {
"type": "number",
"const": 1
},
"timeLimitSeconds": {
"type": "integer",
"maximum": 300,
"minimum": 5
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"id",
"schemaVersion",
"prompt",
"timeLimitSeconds",
"points",
"type",
"choices",
"solution"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"type": {
"type": "string",
"const": "multi_select"
},
"image": {
"type": "object",
"required": [
"assetId",
"alt"
],
"properties": {
"alt": {
"type": "string",
"maxLength": 300
},
"assetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"points": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"prompt": {
"type": "string",
"maxLength": 1000
},
"choices": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"text"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+$",
"maxLength": 64,
"minLength": 1
},
"text": {
"type": "string",
"maxLength": 300
},
"image": {
"type": "object",
"required": [
"assetId",
"alt"
],
"properties": {
"alt": {
"type": "string",
"maxLength": 300
},
"assetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"maxItems": 6,
"minItems": 2
},
"solution": {
"type": "object",
"required": [
"correctChoiceIds"
],
"properties": {
"correctChoiceIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+$",
"maxLength": 64,
"minLength": 1
},
"maxItems": 6
}
},
"additionalProperties": false
},
"schemaVersion": {
"type": "number",
"const": 1
},
"timeLimitSeconds": {
"type": "integer",
"maximum": 300,
"minimum": 5
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"id",
"schemaVersion",
"prompt",
"timeLimitSeconds",
"points",
"type",
"maxLength",
"solution"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"type": {
"type": "string",
"const": "text"
},
"image": {
"type": "object",
"required": [
"assetId",
"alt"
],
"properties": {
"alt": {
"type": "string",
"maxLength": 300
},
"assetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"points": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"prompt": {
"type": "string",
"maxLength": 1000
},
"solution": {
"type": "object",
"required": [
"acceptedAnswers"
],
"properties": {
"evaluation": {
"enum": [
"automatic",
"review_unmatched"
],
"type": "string",
"default": "review_unmatched"
},
"caseSensitive": {
"type": "boolean",
"default": false
},
"acceptedAnswers": {
"type": "array",
"items": {
"type": "string",
"maxLength": 1000
},
"maxItems": 30
}
},
"additionalProperties": false
},
"maxLength": {
"type": "integer",
"maximum": 1000,
"minimum": 1
},
"schemaVersion": {
"type": "number",
"const": 1
},
"timeLimitSeconds": {
"type": "integer",
"maximum": 300,
"minimum": 5
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"id",
"schemaVersion",
"prompt",
"timeLimitSeconds",
"points",
"type",
"min",
"max",
"step",
"solution"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"max": {
"type": "number",
"maximum": 1000000000,
"minimum": -1000000000
},
"min": {
"type": "number",
"maximum": 1000000000,
"minimum": -1000000000
},
"step": {
"type": "number",
"maximum": 1000000000,
"minimum": 0.000001
},
"type": {
"type": "string",
"const": "numeric"
},
"image": {
"type": "object",
"required": [
"assetId",
"alt"
],
"properties": {
"alt": {
"type": "string",
"maxLength": 300
},
"assetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"points": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"prompt": {
"type": "string",
"maxLength": 1000
},
"solution": {
"type": "object",
"required": [
"expected",
"tolerance"
],
"properties": {
"expected": {
"type": "number",
"maximum": 1000000000,
"minimum": -1000000000
},
"tolerance": {
"type": "number",
"maximum": 1000000000,
"minimum": 0
}
},
"additionalProperties": false
},
"schemaVersion": {
"type": "number",
"const": 1
},
"timeLimitSeconds": {
"type": "integer",
"maximum": 300,
"minimum": 5
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"id",
"schemaVersion",
"prompt",
"timeLimitSeconds",
"points",
"type",
"items",
"solution"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"type": {
"type": "string",
"const": "ordering"
},
"image": {
"type": "object",
"required": [
"assetId",
"alt"
],
"properties": {
"alt": {
"type": "string",
"maxLength": 300
},
"assetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"text"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+$",
"maxLength": 64,
"minLength": 1
},
"text": {
"type": "string",
"maxLength": 300
},
"image": {
"type": "object",
"required": [
"assetId",
"alt"
],
"properties": {
"alt": {
"type": "string",
"maxLength": 300
},
"assetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"maxItems": 6,
"minItems": 2
},
"points": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"prompt": {
"type": "string",
"maxLength": 1000
},
"solution": {
"type": "object",
"required": [
"correctItemIds"
],
"properties": {
"correctItemIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+$",
"maxLength": 64,
"minLength": 1
},
"maxItems": 6
}
},
"additionalProperties": false
},
"schemaVersion": {
"type": "number",
"const": 1
},
"timeLimitSeconds": {
"type": "integer",
"maximum": 300,
"minimum": 5
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"id",
"schemaVersion",
"prompt",
"timeLimitSeconds",
"points",
"type",
"choices",
"solution"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"type": {
"type": "string",
"const": "poll"
},
"image": {
"type": "object",
"required": [
"assetId",
"alt"
],
"properties": {
"alt": {
"type": "string",
"maxLength": 300
},
"assetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"points": {
"type": "number",
"const": 0
},
"prompt": {
"type": "string",
"maxLength": 1000
},
"choices": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"text"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+$",
"maxLength": 64,
"minLength": 1
},
"text": {
"type": "string",
"maxLength": 300
},
"image": {
"type": "object",
"required": [
"assetId",
"alt"
],
"properties": {
"alt": {
"type": "string",
"maxLength": 300
},
"assetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"maxItems": 6,
"minItems": 2
},
"solution": {
"type": "null"
},
"schemaVersion": {
"type": "number",
"const": 1
},
"timeLimitSeconds": {
"type": "integer",
"maximum": 300,
"minimum": 5
}
},
"additionalProperties": false
}
]
},
"maxItems": 500
}
},
"additionalProperties": false
},
"maxItems": 20
},
"nickname": {
"type": "string",
"default": "Host",
"maxLength": 40,
"minLength": 1,
"description": "Host player name. Use Host when no name was supplied."
},
"settings": {
"type": "object",
"default": {
"getReady": true,
"comboBonus": false,
"speedBonus": false,
"rulesScreen": true,
"scoreReveal": "each_block",
"contributions": "disabled",
"authorGuessing": false,
"questionSeconds": 30,
"authorGuessPoints": 500,
"authorGuessSeconds": 30,
"blockIntroductions": false,
"doubleLastQuestion": false,
"separateAnswerReveal": false,
"questionsPerContributor": 2
},
"properties": {
"getReady": {
"type": "boolean",
"default": true
},
"comboBonus": {
"type": "boolean",
"default": false
},
"speedBonus": {
"type": "boolean",
"default": false
},
"rulesScreen": {
"type": "boolean",
"default": true
},
"scoreReveal": {
"enum": [
"each_block",
"end"
],
"type": "string",
"default": "each_block"
},
"contributions": {
"enum": [
"required",
"optional",
"disabled"
],
"type": "string",
"default": "disabled"
},
"authorGuessing": {
"type": "boolean",
"default": false
},
"questionSeconds": {
"type": "integer",
"default": 30,
"maximum": 300,
"minimum": 5
},
"authorGuessPoints": {
"type": "integer",
"default": 500,
"maximum": 10000,
"minimum": 0
},
"authorGuessSeconds": {
"type": "integer",
"default": 30,
"maximum": 300,
"minimum": 5
},
"blockIntroductions": {
"type": "boolean",
"default": false
},
"doubleLastQuestion": {
"type": "boolean",
"default": false
},
"separateAnswerReveal": {
"type": "boolean",
"default": false
},
"questionsPerContributor": {
"type": "integer",
"default": 2,
"maximum": 10,
"minimum": 1
}
},
"additionalProperties": false
},
"requestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Stable UUID for this intent. Reuse it with identical arguments after a lost response; use a new UUID for a different action."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Use for follow-up edits after get_quiz. Updates the game at expectedRevision while it is still an editable lobby. Keep stable question/round IDs. Accepts title, blocks and partial settings; omitted fields are preserved. Set contributions to optional with questionsPerContributor for a requested per-person maximum, or disabled to close submissions while retaining existing content. Reuse requestId for identical retries.
| Parameter | Type | Description |
|---|---|---|
| runId * | string | The game ID (runId) returned by create_quiz, list_quizzes or get_quiz. |
| content * | object | |
| requestId * | string | Stable UUID for this intent. Reuse it with identical arguments after a lost response; use a new UUID for a different action. |
| expectedRevision * | integer | Use the prepared-content revision returned by get_quiz. |
{
"name": "update_quiz",
"title": "Edit a game's prepared rounds",
"description": "Use for follow-up edits after get_quiz. Updates the game at expectedRevision while it is still an editable lobby. Keep stable question/round IDs. Accepts title, blocks and partial settings; omitted fields are preserved. Set contributions to optional with questionsPerContributor for a requested per-person maximum, or disabled to close submissions while retaining existing content. Reuse requestId for identical retries.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"requestId",
"runId",
"expectedRevision",
"content"
],
"properties": {
"runId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The game ID (runId) returned by create_quiz, list_quizzes or get_quiz."
},
"content": {
"type": "object",
"properties": {
"title": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"blocks": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"questions"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"title": {
"type": "string",
"maxLength": 120
},
"questions": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"id",
"schemaVersion",
"prompt",
"timeLimitSeconds",
"points",
"type",
"choices",
"solution"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"type": {
"type": "string",
"const": "single_choice"
},
"image": {
"type": "object",
"required": [
"assetId",
"alt"
],
"properties": {
"alt": {
"type": "string",
"maxLength": 300
},
"assetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"points": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"prompt": {
"type": "string",
"maxLength": 1000
},
"choices": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"text"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+$",
"maxLength": 64,
"minLength": 1
},
"text": {
"type": "string",
"maxLength": 300
},
"image": {
"type": "object",
"required": [
"assetId",
"alt"
],
"properties": {
"alt": {
"type": "string",
"maxLength": 300
},
"assetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"maxItems": 6,
"minItems": 2
},
"solution": {
"type": "object",
"required": [
"correctChoiceId"
],
"properties": {
"correctChoiceId": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+$",
"maxLength": 64,
"minLength": 1
}
},
"additionalProperties": false
},
"schemaVersion": {
"type": "number",
"const": 1
},
"timeLimitSeconds": {
"type": "integer",
"maximum": 300,
"minimum": 5
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"id",
"schemaVersion",
"prompt",
"timeLimitSeconds",
"points",
"type",
"choices",
"solution"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"type": {
"type": "string",
"const": "multi_select"
},
"image": {
"type": "object",
"required": [
"assetId",
"alt"
],
"properties": {
"alt": {
"type": "string",
"maxLength": 300
},
"assetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"points": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"prompt": {
"type": "string",
"maxLength": 1000
},
"choices": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"text"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+$",
"maxLength": 64,
"minLength": 1
},
"text": {
"type": "string",
"maxLength": 300
},
"image": {
"type": "object",
"required": [
"assetId",
"alt"
],
"properties": {
"alt": {
"type": "string",
"maxLength": 300
},
"assetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"maxItems": 6,
"minItems": 2
},
"solution": {
"type": "object",
"required": [
"correctChoiceIds"
],
"properties": {
"correctChoiceIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+$",
"maxLength": 64,
"minLength": 1
},
"maxItems": 6
}
},
"additionalProperties": false
},
"schemaVersion": {
"type": "number",
"const": 1
},
"timeLimitSeconds": {
"type": "integer",
"maximum": 300,
"minimum": 5
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"id",
"schemaVersion",
"prompt",
"timeLimitSeconds",
"points",
"type",
"maxLength",
"solution"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"type": {
"type": "string",
"const": "text"
},
"image": {
"type": "object",
"required": [
"assetId",
"alt"
],
"properties": {
"alt": {
"type": "string",
"maxLength": 300
},
"assetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"points": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"prompt": {
"type": "string",
"maxLength": 1000
},
"solution": {
"type": "object",
"required": [
"acceptedAnswers"
],
"properties": {
"evaluation": {
"enum": [
"automatic",
"review_unmatched"
],
"type": "string",
"default": "review_unmatched"
},
"caseSensitive": {
"type": "boolean",
"default": false
},
"acceptedAnswers": {
"type": "array",
"items": {
"type": "string",
"maxLength": 1000
},
"maxItems": 30
}
},
"additionalProperties": false
},
"maxLength": {
"type": "integer",
"maximum": 1000,
"minimum": 1
},
"schemaVersion": {
"type": "number",
"const": 1
},
"timeLimitSeconds": {
"type": "integer",
"maximum": 300,
"minimum": 5
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"id",
"schemaVersion",
"prompt",
"timeLimitSeconds",
"points",
"type",
"min",
"max",
"step",
"solution"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"max": {
"type": "number",
"maximum": 1000000000,
"minimum": -1000000000
},
"min": {
"type": "number",
"maximum": 1000000000,
"minimum": -1000000000
},
"step": {
"type": "number",
"maximum": 1000000000,
"minimum": 0.000001
},
"type": {
"type": "string",
"const": "numeric"
},
"image": {
"type": "object",
"required": [
"assetId",
"alt"
],
"properties": {
"alt": {
"type": "string",
"maxLength": 300
},
"assetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"points": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"prompt": {
"type": "string",
"maxLength": 1000
},
"solution": {
"type": "object",
"required": [
"expected",
"tolerance"
],
"properties": {
"expected": {
"type": "number",
"maximum": 1000000000,
"minimum": -1000000000
},
"tolerance": {
"type": "number",
"maximum": 1000000000,
"minimum": 0
}
},
"additionalProperties": false
},
"schemaVersion": {
"type": "number",
"const": 1
},
"timeLimitSeconds": {
"type": "integer",
"maximum": 300,
"minimum": 5
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"id",
"schemaVersion",
"prompt",
"timeLimitSeconds",
"points",
"type",
"items",
"solution"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"type": {
"type": "string",
"const": "ordering"
},
"image": {
"type": "object",
"required": [
"assetId",
"alt"
],
"properties": {
"alt": {
"type": "string",
"maxLength": 300
},
"assetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"text"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+$",
"maxLength": 64,
"minLength": 1
},
"text": {
"type": "string",
"maxLength": 300
},
"image": {
"type": "object",
"required": [
"assetId",
"alt"
],
"properties": {
"alt": {
"type": "string",
"maxLength": 300
},
"assetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"maxItems": 6,
"minItems": 2
},
"points": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"prompt": {
"type": "string",
"maxLength": 1000
},
"solution": {
"type": "object",
"required": [
"correctItemIds"
],
"properties": {
"correctItemIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+$",
"maxLength": 64,
"minLength": 1
},
"maxItems": 6
}
},
"additionalProperties": false
},
"schemaVersion": {
"type": "number",
"const": 1
},
"timeLimitSeconds": {
"type": "integer",
"maximum": 300,
"minimum": 5
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"id",
"schemaVersion",
"prompt",
"timeLimitSeconds",
"points",
"type",
"choices",
"solution"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"type": {
"type": "string",
"const": "poll"
},
"image": {
"type": "object",
"required": [
"assetId",
"alt"
],
"properties": {
"alt": {
"type": "string",
"maxLength": 300
},
"assetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"points": {
"type": "number",
"const": 0
},
"prompt": {
"type": "string",
"maxLength": 1000
},
"choices": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"text"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]+$",
"maxLength": 64,
"minLength": 1
},
"text": {
"type": "string",
"maxLength": 300
},
"image": {
"type": "object",
"required": [
"assetId",
"alt"
],
"properties": {
"alt": {
"type": "string",
"maxLength": 300
},
"assetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"maxItems": 6,
"minItems": 2
},
"solution": {
"type": "null"
},
"schemaVersion": {
"type": "number",
"const": 1
},
"timeLimitSeconds": {
"type": "integer",
"maximum": 300,
"minimum": 5
}
},
"additionalProperties": false
}
]
},
"maxItems": 500
}
},
"additionalProperties": false
},
"maxItems": 20
},
"settings": {
"type": "object",
"properties": {
"getReady": {
"type": "boolean"
},
"comboBonus": {
"type": "boolean"
},
"speedBonus": {
"type": "boolean"
},
"rulesScreen": {
"type": "boolean"
},
"scoreReveal": {
"enum": [
"each_block",
"end"
],
"type": "string"
},
"contributions": {
"enum": [
"required",
"optional",
"disabled"
],
"type": "string"
},
"authorGuessing": {
"type": "boolean"
},
"questionSeconds": {
"type": "integer",
"maximum": 300,
"minimum": 5
},
"authorGuessPoints": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"authorGuessSeconds": {
"type": "integer",
"maximum": 300,
"minimum": 5
},
"blockIntroductions": {
"type": "boolean"
},
"doubleLastQuestion": {
"type": "boolean"
},
"separateAnswerReveal": {
"type": "boolean"
},
"questionsPerContributor": {
"type": "integer",
"maximum": 10,
"minimum": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"requestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Stable UUID for this intent. Reuse it with identical arguments after a lost response; use a new UUID for a different action."
},
"expectedRevision": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Use the prepared-content revision returned by get_quiz."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Use when the user wants to play a finished game again with exactly the same questions. Pass replayEditionId from list_quizzes. Creates a new lobby with a fresh invitation; a rematch cannot be edited (use create_quiz with the old rounds for an edited version). Never starts play. Reuse requestId for identical retries.
| Parameter | Type | Description |
|---|---|---|
| nickname | string | Host player name. Use Host when no name was supplied. |
| editionId * | string | replayEditionId from list_quizzes. |
| requestId * | string | Stable UUID for this intent. Reuse it with identical arguments after a lost response; use a new UUID for a different action. |
{
"name": "replay_game",
"title": "Set up a rematch",
"description": "Use when the user wants to play a finished game again with exactly the same questions. Pass replayEditionId from list_quizzes. Creates a new lobby with a fresh invitation; a rematch cannot be edited (use create_quiz with the old rounds for an edited version). Never starts play. Reuse requestId for identical retries.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"requestId",
"editionId"
],
"properties": {
"nickname": {
"type": "string",
"default": "Host",
"maxLength": 40,
"minLength": 1,
"description": "Host player name. Use Host when no name was supplied."
},
"editionId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "replayEditionId from list_quizzes."
},
"requestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Stable UUID for this intent. Reuse it with identical arguments after a lost response; use a new UUID for a different action."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use when the user wants a fresh invitation for an existing editable lobby. Previous invitation links stop admitting new players. Returns the replacement link and expiry. Does not start play. Reuse requestId for identical retries.
| Parameter | Type | Description |
|---|---|---|
| runId * | string | The game ID (runId) returned by create_quiz, list_quizzes or get_quiz. |
| requestId * | string | Stable UUID for this intent. Reuse it with identical arguments after a lost response; use a new UUID for a different action. |
{
"name": "refresh_invitation",
"title": "Renew a lobby invitation",
"description": "Use when the user wants a fresh invitation for an existing editable lobby. Previous invitation links stop admitting new players. Returns the replacement link and expiry. Does not start play. Reuse requestId for identical retries.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"requestId",
"runId"
],
"properties": {
"runId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The game ID (runId) returned by create_quiz, list_quizzes or get_quiz."
},
"requestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Stable UUID for this intent. Reuse it with identical arguments after a lost response; use a new UUID for a different action."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Use only when the user explicitly asks to cancel a lobby that has not started. Its invitation stops working and nobody can play it. A game in progress is stopped in Playloop instead. Reuse requestId for identical retries.
| Parameter | Type | Description |
|---|---|---|
| runId * | string | The game ID (runId) returned by create_quiz, list_quizzes or get_quiz. |
| requestId * | string | Stable UUID for this intent. Reuse it with identical arguments after a lost response; use a new UUID for a different action. |
{
"name": "cancel_lobby",
"title": "Cancel a lobby",
"description": "Use only when the user explicitly asks to cancel a lobby that has not started. Its invitation stops working and nobody can play it. A game in progress is stopped in Playloop instead. Reuse requestId for identical retries.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"requestId",
"runId"
],
"properties": {
"runId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The game ID (runId) returned by create_quiz, list_quizzes or get_quiz."
},
"requestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Stable UUID for this intent. Reuse it with identical arguments after a lost response; use a new UUID for a different action."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"additionalProperties": true
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Apply these instructions only when the user requests Playloop or when Playloop tools are selected to fulfill the request. For quiz or game creation, call get_authoring_context first, then call create_quiz with complete structured content. create_quiz returns a lobby. Present “Open game” using hostUrl, “Invite friends” using joinUrl, the invitation expiry, and a short summary without revealing answers. Report blockers honestly. Users start and play the game in Playloop. To edit an existing game, use get_quiz and update_quiz with its runId, including after its link has been shared. To reuse an earlier quiz as a new game, find it with list_quizzes, read it with get_quiz, and call create_quiz using its rounds. For a rematch with the same questions, use replay_game with the replayEditionId returned by list_quizzes. Obtain explicit user authorization before an action that incurs a charge for paid single-edition access. After a timeout, retry identical input with the same requestId. Fetch current content before resolving revision conflicts. These tools do not support the following actions: mark players ready or start, pause, advance or end live gameplay; answer questions or play for anyone; change scores or judge typed answers; connect a TV display; buy hosting access; change or delete a Playloop account. When the user requests an unsupported action, briefly explain that it must be performed in Playloop. Provide the game's hostUrl when available and relevant. Do not attempt to perform unsupported actions through other tools.
Names, descriptions and schemas were written by the server and are shown as data.