worlds_status
Read onlyThe 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).
/api/agent/worlds/statusBehavior
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
worldOptionalstring- 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
{
"$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
}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.