Docs/MCP reference

project_create

Write

Create a new game project (nothing is launched): a name, a brief of a few sentences, and optionally the kind of game: threejs, unity (a Unity Web build), or web (any other browser game).

POST/api/agent/projects

Behavior

Create a new game project (nothing is launched): a name, a brief of a few sentences, and optionally the kind of game: threejs, unity (a Unity Web build), or web (any other browser game). It reserves the project's own address (its game host in this environment; site_status names it), where game_publish puts the creator's build. Returns the slug and selects it. Creating costs nothing; an account holds at most 25 projects and creates at most 10 an hour.

Input parameters

nameRequired
string
  • Min. length: 2
  • Max. length: 48
briefRequired
string
  • Min. length: 20
  • Max. length: 1200
kindOptional
"threejs" | "unity" | "web"

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": {
    "name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 48
    },
    "brief": {
      "type": "string",
      "minLength": 20,
      "maxLength": 1200
    },
    "kind": {
      "type": "string",
      "enum": [
        "threejs",
        "unity",
        "web"
      ]
    }
  },
  "required": [
    "name",
    "brief"
  ],
  "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.