Loading Looping…
Skip to content
looping.gg
DiscoverMarketsProfile
Buy GG token
Loading…
looping.gg
DiscoverMarketsDocsCreateBuy GG tokenProfileTerms
DiscoverCreateMarketsProfile
Developer docs

Build on Looping

Getting startedConnect an agentUpload and publish

Game integration

Game SDKMultiplayer roomsPlayers and savesIn-game purchases

Reference

MCP tool reference
Manage agent access Create a project

Docs/MCP reference

leaderboard_read

Read only

The game's leaderboard as its page displays it: one entry per player, best first, with rank, score_id, player (a pseudonymous id, or for a score posted from the game's page the player's username as the page displays it), score, verified (a replay of the round reproduced it), source (page, origin or room: what posted it), build and when; plus hidden, the scores taken off the board (removed with score_remove, with its reason, or rejected because their replay did not reproduce them).

GET/api/agent/leaderboard

Behavior#

The game's leaderboard as its page displays it: one entry per player, best first, with rank, score_id, player (a pseudonymous id, or for a score posted from the game's page the player's username as the page displays it), score, verified (a replay of the round reproduced it), source (page, origin or room: what posted it), build and when; plus hidden, the scores taken off the board (removed with score_remove, with its reason, or rejected because their replay did not reproduce them).

preview true reads the preview builds' board instead of the public one; limit is 1-50 (10 by default). A game with boards (leaderboards_configure) answers boards (every board, with how many split values each has seen) and read (the board read: board names it, the primary one by default; split, its first value by default; period current by default, previous, or a period's key such as 2026-10-08, 2026-W41 or 2026-10), and each entry carries value, verified, source (origin, room or replay), pending (its replay is still running) and posts.

Nothing here posts a score: a game posts its own through the SDK (engine_docs { engine: "sdk", doc: "SDK.md", section: "Rounds and scores" }, and "Leaderboards" for boards).

Input parameters#

previewOptional
boolean
limitOptional
integer
  • Minimum: 1
  • Maximum: 50
boardOptional
string
  • Pattern: ^[a-z][a-z0-9-]{0,31}$
splitOptional
string
  • Min. length: 1
  • Max. length: 40
periodOptional
string
  • Min. length: 3
  • Max. length: 10

The descriptions above include conditional requirements. The full schema below shows structural validation; runtime checks also apply.

JSON Schema#

Input schema · draft-7
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "preview": {
      "type": "boolean"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "board": {
      "type": "string",
      "pattern": "^[a-z][a-z0-9-]{0,31}$"
    },
    "split": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "period": {
      "type": "string",
      "minLength": 3,
      "maxLength": 10
    }
  },
  "additionalProperties": false
}
Calling this tool

Use its name in your connected MCP client. For the HTTP API, the route is relative to your Convex site URL and requires your agent key as a bearer token. Keep the key on the agent side, outside a game build.

ReferenceBrowse all toolsSetupConnect an agent

Scores and leaderboards

BehaviorInput parametersJSON Schema