Docs/MCP reference

project_status

Read only

Where the selected project stands, in one call: state (draft: no build yet; preview: builds only the creator plays; public: the token launch is registered and a build is released), the released version, every build newest first with its boot (ok, error with the message, or none yet), its check (the platform's boot check, its multiplayer and store checks in check.smoke, and the listing blockers, as site_status reports it; verified says whether it can be released or listed) and whether it is released, listed, hidden, launch_fee (unpaid, credit or used), the launch blocker if any, rooms (enabled, mode, signed_in_only, max_players and the platform's caps), hosting (the game's multiplayer credits: balance, reserved and available cents, runway, open matches and those in their grace, the creator's free preview allowance used against its caps, the published rates, multiplayer: whether the game plays online, an estimate of what its public matches cost per player-hour and whether it can fund them, and buy_url, where the creator buys credits; an agent never pays), warnings (low or empty credits, the allowance spent, a spend cap reached: tell the creator), must_act (a game that plays online and can't fund its public matches: one line with the cost and buy_url, in the future tense before the launch; always tell the creator), preview_url, launch_url, public_url and market_url once public, the listing fields, and next: what to do now.

GET/api/agent/status

Behavior

Where the selected project stands, in one call: state (draft: no build yet; preview: builds only the creator plays; public: the token launch is registered and a build is released), the released version, every build newest first with its boot (ok, error with the message, or none yet), its check (the platform's boot check, its multiplayer and store checks in check.smoke, and the listing blockers, as site_status reports it; verified says whether it can be released or listed) and whether it is released, listed, hidden, launch_fee (unpaid, credit or used), the launch blocker if any, rooms (enabled, mode, signed_in_only, max_players and the platform's caps), hosting (the game's multiplayer credits: balance, reserved and available cents, runway, open matches and those in their grace, the creator's free preview allowance used against its caps, the published rates, multiplayer: whether the game plays online, an estimate of what its public matches cost per player-hour and whether it can fund them, and buy_url, where the creator buys credits; an agent never pays), warnings (low or empty credits, the allowance spent, a spend cap reached: tell the creator), must_act (a game that plays online and can't fund its public matches: one line with the cost and buy_url, in the future tense before the launch; always tell the creator), preview_url, launch_url, public_url and market_url once public, the listing fields, and next: what to do now.

Call it after project_select, after each publish, and while waiting for the creator to launch.

Input parameters

This tool takes no arguments. Send an empty object: {}.

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": {},
  "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.