Make group quiz games: create and edit quizzes, invite friends to add questions, reuse rounds.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
The game ID (runId) returned by create_quiz, list_quizzes or get_quiz.
Stable UUID for this intent. Reuse it with identical arguments after a lost response; use a new UUID for a different action.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http playloop https://mcp.tryplayloop.com/mcp
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.
| Argument | 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. |
{
"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
}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.
| Argument | 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. |
{
"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
}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 arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": 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.
| Argument | Type | Description |
|---|---|---|
| runId* | string | The game ID (runId) returned by create_quiz, list_quizzes or get_quiz. |
{
"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
}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.
| Argument | Type | Description |
|---|---|---|
| query | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"query": {
"type": "string",
"maxLength": 120
}
},
"additionalProperties": 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.
| Argument | 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. |
{
"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
}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.
| Argument | 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. |
{
"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
}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.
| Argument | 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. |
{
"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
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 21, 2026.