create_scoreboard

Create a public, shareable two-team scoreboard at zero. Requires explicit user intent to create; title and team names are public. Free boards allow 50 total spectator views and show branding. Retry the identical requestId and input after a timeout.

Argument	Type	Description
teams*	array
title*	string
requestId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "requestId",
    "title",
    "teams"
  ],
  "properties": {
    "teams": {
      "type": "array",
      "items": [
        {
          "type": "object",
          "required": [
            "name"
          ],
          "properties": {
            "name": {
              "$ref": "#/properties/title"
            }
          },
          "additionalProperties": false
        },
        {
          "type": "object",
          "required": [
            "name"
          ],
          "properties": {
            "name": {
              "$ref": "#/properties/title"
            }
          },
          "additionalProperties": false
        }
      ],
      "maxItems": 2,
      "minItems": 2
    },
    "title": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
    },
    "requestId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{8,128}$"
    }
  },
  "additionalProperties": false
}

get_scoreboard

Read a scoreboard created through this API by the connected account, including stable team IDs and current revision.

read-only

Argument	Type	Description
id*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,128}$"
    }
  },
  "additionalProperties": false
}

hand_off_scoreboard

Return the connected account owner’s private management link. Share it only with the intended scorer, never spectators. Does not transfer ownership. Reuse requestId on retry.

Argument	Type	Description
id*	string
requestId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id",
    "requestId"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,128}$"
    },
    "requestId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{8,128}$"
    }
  },
  "additionalProperties": false
}

list_scoreboards

List the connected account's API-created generic scoreboards. Does not list unrelated legacy boards. Pass nextCursor as cursor to continue until null; a filtered page can be empty.

read-only

Argument	Type	Description
limit	integer
cursor	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "cursor": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,128}$"
    }
  },
  "additionalProperties": false
}

update_scoreboard

Atomically set exact scores, increment scores, rename teams or change title. Use stable team IDs and the last read revision. Updates immediately appear publicly. On revision_conflict read the board and decide again; do not blindly replay a stale increment. Identical retry IDs return the previous result.

destructive

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

Scorekeeper

Try it

create_scoreboard

Tools

Scorekeeper

Try it

create_scoreboard

Tools