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

worlds_status

Read only

The game's persistent worlds: each room kind's world settings (scope, writers, wipe, flush cadence) and whether they reached the game's worlds, every world per environment (public, and preview behind the preview host) with its size, chunks, players in it now, when it was created, last opened and changed, and its next wipe; storage across them as a share of the free world storage each game gets (never a dollar figure for the free part; past it, the paid bytes and what they cost a month), whether worlds may grow (past the free amount with no hosting credits, changes that would grow a world are not saved), warnings to relay, and the ceilings (64 KiB a chunk, 256 MiB a world, 50 named worlds a game).

GET/api/agent/worlds/status

Behavior#

The game's persistent worlds: each room kind's world settings (scope, writers, wipe, flush cadence) and whether they reached the game's worlds, every world per environment (public, and preview behind the preview host) with its size, chunks, players in it now, when it was created, last opened and changed, and its next wipe; storage across them as a share of the free world storage each game gets (never a dollar figure for the free part; past it, the paid bytes and what they cost a month), whether worlds may grow (past the free amount with no hosting credits, changes that would grow a world are not saved), warnings to relay, and the ceilings (64 KiB a chunk, 256 MiB a world, 50 named worlds a game).

Give world (and env) for one world with its seed and newest 50 changes (who changed which chunk, when): read it before world_revert. A world nobody opens for 365 days, with a notice 30 days before, is deleted.

Input parameters#

worldOptional
string
  • Pattern: ^[a-z0-9][a-z0-9-]{0,62}$
envOptional
"public" | "preview"

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": {
    "world": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]{0,62}$"
    },
    "env": {
      "type": "string",
      "enum": [
        "public",
        "preview"
      ]
    }
  },
  "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

Other tools

BehaviorInput parametersJSON Schema