Tool tree
Minecraft server hosting with no subscription — pay for the time your server is online. Java + Bedrock crossplay, 1-click mods, 10 free hours to try, no card.
mc_list_serversanswer
List every Minecraft server owned by the signed-in user, including id, name, domain, region, status and online players.
View tool JSON
{
"name": "mc_list_servers",
"kind": "answer",
"impl": "imperative",
"description": "List every Minecraft server owned by the signed-in user, including id, name, domain, region, status and online players.",
"inputSchema": {
"type": "object",
"properties": {}
},
"page": "/"
}mc_get_serveranswer
Get full details for one server by id (status, config, instance size, connection address, players).
View tool JSON
{
"name": "mc_get_server",
"kind": "answer",
"impl": "imperative",
"description": "Get full details for one server by id (status, config, instance size, connection address, players).",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"serverId": {
"type": "string",
"minLength": 1,
"description": "The target server id (ULID), as returned by mc_list_servers."
}
},
"required": [
"serverId"
]
},
"page": "/"
}mc_create_serveract
Create a new Minecraft server. `region` must be an awsRegion id from mc_list_regions. Per-account server limits and wallet balance are enforced server-side; a 402/403 result means the action was blocked, not that it failed transiently.
View tool JSON
{
"name": "mc_create_server",
"kind": "act",
"impl": "imperative",
"description": "Create a new Minecraft server. `region` must be an awsRegion id from mc_list_regions. Per-account server limits and wallet balance are enforced server-side; a 402/403 result means the action was blocked, not that it failed transiently.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"region": {
"type": "string",
"minLength": 1
},
"config": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"VANILLA",
"FABRIC",
"FORGE",
"NEOFORGE",
"PAPER",
"PUFFERFISH",
"PURPUR",
"LEAF",
"FOLIA",
"QUILT"
]
},
"version": {
"type": "string",
"maxLength": 20
},
"serverImage": {
"type": "string",
"enum": [
"itzg/minecraft-server:java25-alpine",
"itzg/minecraft-server:java21-alpine",
"itzg/minecraft-server:java17",
"itzg/minecraft-server:java8"
]
},
"motd": {
"type": "string",
"maxLength": 256
},
"maxPlayers": {
"type": "integer",
"minimum": 0,
"maximum": 1000
},
"difficulty": {
"type": "string",
"enum": [
"peaceful",
"easy",
"normal",
"hard"
]
},
"onlineMode": {
"default": true,
"type": "boolean"
},
"modrinthProjects": {
"type": "string",
"maxLength": 8096
},
"modrinthModpack": {
"type": "string",
"maxLength": 1024
},
"plugins": {
"type": "string",
"maxLength": 8096
},
"whitelist": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uuid": {
"type": "string",
"minLength": 1
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 16
}
},
"required": [
"name"
]
}
},
"ops": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uuid": {
"type": "string",
"minLength": 1
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 16
},
"level": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"bypassesPlayerLimit": {
"type": "boolean"
}
},
"required": [
"name",
"level",
"bypassesPlayerLimit"
]
}
},
"bannedPlayers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uuid": {
"type": "string",
"minLength": 1
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 16
},
"created": {
"type": "string"
},
"source": {
"type": "string"
},
"expires": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"required": [
"uuid",
"name",
"created",
"source",
"expires",
"reason"
]
}
},
"bannedIps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"ip": {
"type": "string",
"minLength": 1
},
"created": {
"type": "string"
},
"source": {
"type": "string"
},
"expires": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"required": [
"ip",
"created",
"source",
"expires",
"reason"
]
}
},
"whitelistEnabled": {
"type": "boolean"
},
"gamemode": {
"type": "string",
"enum": [
"survival",
"creative",
"adventure",
"spectator"
]
},
"forceGamemode": {
"type": "boolean"
},
"allowFlight": {
"type": "boolean"
},
"enableCommandBlock": {
"type": "boolean"
},
"spawnProtection": {
"type": "integer",
"minimum": 0,
"maximum": 256
},
"viewDistance": {
"type": "integer",
"minimum": 3,
"maximum": 32
},
"simulationDistance": {
"type": "integer",
"minimum": 3,
"maximum": 32
},
"playerIdleTimeout": {
"type": "integer",
"minimum": 0,
"maximum": 1440
},
"pvp": {
"type": "boolean"
},
"hardcore": {
"type": "boolean"
},
"bedrockEnabled": {
"type": "boolean"
},
"voiceChatEnabled": {
"type": "boolean"
},
"voiceChatProvider": {
"type": "string",
"enum": [
"simple-voice-chat",
"plasmo-voice"
]
},
"reviewNotice": {
"type": "string",
"maxLength": 2048
}
}
},
"instanceType": {
"type": "string",
"enum": [
"c6g.medium",
"m6g.medium",
"c6g.large",
"m6g.large",
"r6g.large",
"c6g.xlarge",
"m6g.xlarge",
"r6g.xlarge",
"m6g.2xlarge",
"r6g.2xlarge"
]
}
},
"required": [
"name",
"region"
]
},
"page": "/"
}mc_update_serveract
Update a server's name, instance size, autostart, or world config (MOTD, max players, difficulty, version, mods, etc.). Some fields require a restart to take effect.
View tool JSON
{
"name": "mc_update_server",
"kind": "act",
"impl": "imperative",
"description": "Update a server's name, instance size, autostart, or world config (MOTD, max players, difficulty, version, mods, etc.). Some fields require a restart to take effect.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"serverId": {
"type": "string",
"minLength": 1,
"description": "The target server id (ULID), as returned by mc_list_servers."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"config": {
"type": "object",
"properties": {
"type": {
"anyOf": [
{
"type": "string",
"enum": [
"VANILLA",
"FABRIC",
"FORGE",
"NEOFORGE",
"PAPER",
"PUFFERFISH",
"PURPUR",
"LEAF",
"FOLIA",
"QUILT"
]
},
{
"type": "null"
}
]
},
"version": {
"anyOf": [
{
"type": "string",
"maxLength": 20
},
{
"type": "null"
}
]
},
"serverImage": {
"anyOf": [
{
"type": "string",
"enum": [
"itzg/minecraft-server:java25-alpine",
"itzg/minecraft-server:java21-alpine",
"itzg/minecraft-server:java17",
"itzg/minecraft-server:java8"
]
},
{
"type": "null"
}
]
},
"motd": {
"anyOf": [
{
"type": "string",
"maxLength": 256
},
{
"type": "null"
}
]
},
"maxPlayers": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 1000
},
{
"type": "null"
}
]
},
"difficulty": {
"anyOf": [
{
"type": "string",
"enum": [
"peaceful",
"easy",
"normal",
"hard"
]
},
{
"type": "null"
}
]
},
"onlineMode": {
"type": "boolean"
},
"modrinthProjects": {
"anyOf": [
{
"type": "string",
"maxLength": 8096
},
{
"type": "null"
}
]
},
"modrinthModpack": {
"anyOf": [
{
"type": "string",
"maxLength": 1024
},
{
"type": "null"
}
]
},
"plugins": {
"anyOf": [
{
"type": "string",
"maxLength": 8096
},
{
"type": "null"
}
]
},
"whitelist": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"uuid": {
"type": "string",
"minLength": 1
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 16
}
},
"required": [
"name"
]
}
},
{
"type": "null"
}
]
},
"ops": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"uuid": {
"type": "string",
"minLength": 1
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 16
},
"level": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"bypassesPlayerLimit": {
"type": "boolean"
}
},
"required": [
"name",
"level",
"bypassesPlayerLimit"
]
}
},
{
"type": "null"
}
]
},
"bannedPlayers": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"uuid": {
"type": "string",
"minLength": 1
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 16
},
"created": {
"type": "string"
},
"source": {
"type": "string"
},
"expires": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"required": [
"uuid",
"name",
"created",
"source",
"expires",
"reason"
]
}
},
{
"type": "null"
}
]
},
"bannedIps": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"ip": {
"type": "string",
"minLength": 1
},
"created": {
"type": "string"
},
"source": {
"type": "string"
},
"expires": {
"type": "string"
},
"reason": {
"type": "string"
}
},
"required": [
"ip",
"created",
"source",
"expires",
"reason"
]
}
},
{
"type": "null"
}
]
},
"whitelistEnabled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"gamemode": {
"anyOf": [
{
"type": "string",
"enum": [
"survival",
"creative",
"adventure",
"spectator"
]
},
{
"type": "null"
}
]
},
"forceGamemode": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"allowFlight": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"enableCommandBlock": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"spawnProtection": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 256
},
{
"type": "null"
}
]
},
"viewDistance": {
"anyOf": [
{
"type": "integer",
"minimum": 3,
"maximum": 32
},
{
"type": "null"
}
]
},
"simulationDistance": {
"anyOf": [
{
"type": "integer",
"minimum": 3,
"maximum": 32
},
{
"type": "null"
}
]
},
"playerIdleTimeout": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 1440
},
{
"type": "null"
}
]
},
"pvp": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"hardcore": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"bedrockEnabled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"voiceChatEnabled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"voiceChatProvider": {
"anyOf": [
{
"type": "string",
"enum": [
"simple-voice-chat",
"plasmo-voice"
]
},
{
"type": "null"
}
]
}
}
},
"instanceType": {
"anyOf": [
{
"type": "string",
"enum": [
"c6g.medium",
"m6g.medium",
"c6g.large",
"m6g.large",
"r6g.large",
"c6g.xlarge",
"m6g.xlarge",
"r6g.xlarge",
"m6g.2xlarge",
"r6g.2xlarge"
]
},
{
"type": "null"
}
]
},
"autoStartEnabled": {
"type": "boolean"
},
"resetWorld": {
"description": "Confirms a version downgrade by resetting the world in the same save",
"type": "boolean"
}
},
"required": [
"serverId"
]
},
"page": "/"
}mc_server_actionact
Run a lifecycle action on a server: start, stop, restart (full EC2 reboot) or restart-container (in-place). `start` may return a 402 billing error when the wallet balance is too low.
View tool JSON
{
"name": "mc_server_action",
"kind": "act",
"impl": "imperative",
"description": "Run a lifecycle action on a server: start, stop, restart (full EC2 reboot) or restart-container (in-place). `start` may return a 402 billing error when the wallet balance is too low.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"serverId": {
"type": "string",
"minLength": 1,
"description": "The target server id (ULID), as returned by mc_list_servers."
},
"action": {
"type": "string",
"enum": [
"start",
"stop",
"restart",
"restart-container"
]
}
},
"required": [
"serverId",
"action"
]
},
"page": "/"
}mc_delete_servertransact
Permanently delete a server and its world data. Irreversible. Prompts the user to confirm before proceeding.
View tool JSON
{
"name": "mc_delete_server",
"kind": "transact",
"impl": "imperative",
"description": "Permanently delete a server and its world data. Irreversible. Prompts the user to confirm before proceeding.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"serverId": {
"type": "string",
"minLength": 1,
"description": "The target server id (ULID), as returned by mc_list_servers."
}
},
"required": [
"serverId"
]
},
"page": "/"
}mc_reset_worldact
Wipe the server's world and provision a fresh empty one (a backup is taken first). Domain and settings are preserved. Irreversible. Prompts the user to confirm.
View tool JSON
{
"name": "mc_reset_world",
"kind": "act",
"impl": "imperative",
"description": "Wipe the server's world and provision a fresh empty one (a backup is taken first). Domain and settings are preserved. Irreversible. Prompts the user to confirm.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"serverId": {
"type": "string",
"minLength": 1,
"description": "The target server id (ULID), as returned by mc_list_servers."
}
},
"required": [
"serverId"
]
},
"page": "/"
}mc_console_logsanswer
Fetch recent console log lines for a server. Pass `cursor` (from a previous call's nextCursor) to page further back.
View tool JSON
{
"name": "mc_console_logs",
"kind": "answer",
"impl": "imperative",
"description": "Fetch recent console log lines for a server. Pass `cursor` (from a previous call's nextCursor) to page further back.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"serverId": {
"type": "string",
"minLength": 1,
"description": "The target server id (ULID), as returned by mc_list_servers."
},
"cursor": {
"description": "Pagination cursor.",
"type": "string"
}
},
"required": [
"serverId"
]
},
"page": "/"
}mc_list_backupsanswer
List the backups (EBS snapshots) for a server, with state, size, reason and export status.
View tool JSON
{
"name": "mc_list_backups",
"kind": "answer",
"impl": "imperative",
"description": "List the backups (EBS snapshots) for a server, with state, size, reason and export status.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"serverId": {
"type": "string",
"minLength": 1,
"description": "The server id (ULID) that owns the backup."
}
},
"required": [
"serverId"
]
},
"page": "/"
}mc_create_backupact
Take a new on-demand backup (snapshot) of a server's world. Billable; may return a 402 when the balance is too low.
View tool JSON
{
"name": "mc_create_backup",
"kind": "act",
"impl": "imperative",
"description": "Take a new on-demand backup (snapshot) of a server's world. Billable; may return a 402 when the balance is too low.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"serverId": {
"type": "string",
"minLength": 1,
"description": "The server id (ULID) that owns the backup."
}
},
"required": [
"serverId"
]
},
"page": "/"
}mc_restore_backupact
Restore a server's world from a backup snapshot, replacing the current world. Irreversible. Prompts the user to confirm.
View tool JSON
{
"name": "mc_restore_backup",
"kind": "act",
"impl": "imperative",
"description": "Restore a server's world from a backup snapshot, replacing the current world. Irreversible. Prompts the user to confirm.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"serverId": {
"type": "string",
"minLength": 1,
"description": "The server id (ULID) that owns the backup."
},
"snapshotId": {
"type": "string",
"minLength": 1,
"description": "The EBS snapshot id of the backup, from mc_list_backups."
}
},
"required": [
"serverId",
"snapshotId"
]
},
"page": "/"
}mc_delete_backuptransact
Delete a backup snapshot. Irreversible. Prompts the user to confirm.
View tool JSON
{
"name": "mc_delete_backup",
"kind": "transact",
"impl": "imperative",
"description": "Delete a backup snapshot. Irreversible. Prompts the user to confirm.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"serverId": {
"type": "string",
"minLength": 1,
"description": "The server id (ULID) that owns the backup."
},
"snapshotId": {
"type": "string",
"minLength": 1,
"description": "The EBS snapshot id of the backup, from mc_list_backups."
}
},
"required": [
"serverId",
"snapshotId"
]
},
"page": "/"
}mc_export_backupact
Start exporting a backup snapshot to a downloadable ZIP. Poll mc_list_backups for exportState=ready, then call mc_backup_download_url.
View tool JSON
{
"name": "mc_export_backup",
"kind": "act",
"impl": "imperative",
"description": "Start exporting a backup snapshot to a downloadable ZIP. Poll mc_list_backups for exportState=ready, then call mc_backup_download_url.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"serverId": {
"type": "string",
"minLength": 1,
"description": "The server id (ULID) that owns the backup."
},
"snapshotId": {
"type": "string",
"minLength": 1,
"description": "The EBS snapshot id of the backup, from mc_list_backups."
}
},
"required": [
"serverId",
"snapshotId"
]
},
"page": "/"
}mc_backup_download_urlanswer
Get a time-limited signed download URL for a backup that has finished exporting (exportState=ready).
View tool JSON
{
"name": "mc_backup_download_url",
"kind": "answer",
"impl": "imperative",
"description": "Get a time-limited signed download URL for a backup that has finished exporting (exportState=ready).",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"serverId": {
"type": "string",
"minLength": 1,
"description": "The server id (ULID) that owns the backup."
},
"snapshotId": {
"type": "string",
"minLength": 1,
"description": "The EBS snapshot id of the backup, from mc_list_backups."
}
},
"required": [
"serverId",
"snapshotId"
]
},
"page": "/"
}mc_delete_backup_exporttransact
Delete the exported ZIP for a backup (the snapshot itself is kept).
View tool JSON
{
"name": "mc_delete_backup_export",
"kind": "transact",
"impl": "imperative",
"description": "Delete the exported ZIP for a backup (the snapshot itself is kept).",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"serverId": {
"type": "string",
"minLength": 1,
"description": "The server id (ULID) that owns the backup."
},
"snapshotId": {
"type": "string",
"minLength": 1,
"description": "The EBS snapshot id of the backup, from mc_list_backups."
}
},
"required": [
"serverId",
"snapshotId"
]
},
"page": "/"
}mc_list_regionsanswer
List the regions available for hosting servers, with their awsRegion id, display name and enabled flag. Use an awsRegion value as the `region` when creating a server.
View tool JSON
{
"name": "mc_list_regions",
"kind": "answer",
"impl": "imperative",
"description": "List the regions available for hosting servers, with their awsRegion id, display name and enabled flag. Use an awsRegion value as the `region` when creating a server.",
"inputSchema": {
"type": "object",
"properties": {}
},
"page": "/"
}mc_region_pinganswer
Measure round-trip latency (in milliseconds) from the user's browser to a region's router. Lower is better; use it to recommend the fastest region before creating a server.
View tool JSON
{
"name": "mc_region_ping",
"kind": "answer",
"impl": "imperative",
"description": "Measure round-trip latency (in milliseconds) from the user's browser to a region's router. Lower is better; use it to recommend the fastest region before creating a server.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"awsRegion": {
"type": "string",
"minLength": 1,
"description": "The awsRegion id from mc_list_regions, e.g. ap-southeast-1."
}
},
"required": [
"awsRegion"
]
},
"page": "/"
}mc_pricing_cataloganswer
Get the full pricing catalog: per-region, per-instance-type and per-plan-tier hourly/monthly prices. Use it to quote costs or pick a plan size before creating a server.
View tool JSON
{
"name": "mc_pricing_catalog",
"kind": "answer",
"impl": "imperative",
"description": "Get the full pricing catalog: per-region, per-instance-type and per-plan-tier hourly/monthly prices. Use it to quote costs or pick a plan size before creating a server.",
"inputSchema": {
"type": "object",
"properties": {}
},
"page": "/"
}mc_recommended_regionanswer
Get the server-recommended region id for the current user (geo/latency heuristic). A good default for `region` when creating a server.
View tool JSON
{
"name": "mc_recommended_region",
"kind": "answer",
"impl": "imperative",
"description": "Get the server-recommended region id for the current user (geo/latency heuristic). A good default for `region` when creating a server.",
"inputSchema": {
"type": "object",
"properties": {}
},
"page": "/"
}mc_get_walletanswer
Get the signed-in user's wallet: current balance plus credited/debited totals. Useful to explain a 402 'insufficient balance' result from a start/create action.
View tool JSON
{
"name": "mc_get_wallet",
"kind": "answer",
"impl": "imperative",
"description": "Get the signed-in user's wallet: current balance plus credited/debited totals. Useful to explain a 402 'insufficient balance' result from a start/create action.",
"inputSchema": {
"type": "object",
"properties": {}
},
"page": "/"
}mc_current_billanswer
Get the current month's running cost estimate and per-server breakdown (accrual-based, no CUR query).
View tool JSON
{
"name": "mc_current_bill",
"kind": "answer",
"impl": "imperative",
"description": "Get the current month's running cost estimate and per-server breakdown (accrual-based, no CUR query).",
"inputSchema": {
"type": "object",
"properties": {}
},
"page": "/"
}mc_list_billsanswer
List the user's past monthly bills with per-server line items.
View tool JSON
{
"name": "mc_list_bills",
"kind": "answer",
"impl": "imperative",
"description": "List the user's past monthly bills with per-server line items.",
"inputSchema": {
"type": "object",
"properties": {}
},
"page": "/"
}