Launch session
gameye_launch_sessionLaunch a containerized Gameye game server session with configurable image, location, TTL, env, and args, returning the session ID, host, and ports for immediate use.
Instructions
Start a containerized game server session on the Gameye platform. Returns the session ID, host and ports. Starts a billable session in the environment shown in the result prefix. When no ttl is given, a 30m TTL is applied and reported. The label launched-by=gameye-mcp is always sent and replaces any launched-by value you pass; if a warm pool serves the image and region, the server ignores request labels (and env and args), so warm-pool sessions do not carry it. The launch is refused, with nothing sent, if any env value, arg or label contains this server's Gameye API token. It is also refused if the ttl is above 4h, if 5 sessions started by this server are already running, or after 20 launches by this server process; these limits are set by the user when the server starts, and a refusal says which one applied. Pass dryRun=true to preview the request. Needs GAMEYE_API_TOKEN; without one, returns setup steps and sends nothing.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"location": "<location>",
"image": "<image>"
},
"name": "gameye_launch_session"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Custom session ID; auto-generated if omitted. IDs are unique across all of Gameye, so derive it from a UUID. A 409 whose describe returns 404 means another customer owns the ID: retry with a fresh one. Warm-pool launches ignore it; always read the ID from the result | |
| env | No | Environment variables passed to the container | |
| ttl | No | Session time-to-live, e.g. '1h', '30m'. Session auto-stops after this duration. Defaults to 30m; at most 4h | |
| args | No | Command-line arguments passed to the container entrypoint | |
| image | Yes | Docker image name to run (e.g. 'csgo', 'tf2') | |
| dryRun | No | Return the exact request that would be sent, with the API token masked, and send nothing | |
| labels | No | Arbitrary key-value labels for filtering/grouping | |
| restart | No | Automatically restart the container on exit | |
| version | No | Docker image tag/version to use | |
| location | Yes | Region/datacenter to host the session (e.g. 'europe', 'us-east') |