Skip to main content
Glama

Create a Minecraft server

createServer

Creates a server, asleep and free until startServer or a joining player wakes it, and returns it with its id and join address. Region sets player latency and cannot change later: ask where players are if unknown; regions and size prices come from getPricingCatalog. Optional content from Modrinth, CurseForge or a link downloads on first start; uploaded files are added afterwards with the asset or modpack upload tools. Accounts hold a limited number of servers; at the limit, delete one with deleteServer.

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": {
      "body": "<body>"
    },
    "name": "createServer"
  }
}

Input Schema

NameRequiredDescriptionDefault
bodyYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / body / properties / config / properties / modpack / properties / members
      Added value: +{
      +  "additionalProperties": {
      +    "description": "include: install the member even when the server would skip it as client-only; exclude: never install it",
      +    "enum": [
      +      "include",
      +      "exclude"
      +    ],
      +    "type": "string"
      +  },
      +  "description": "Per-member install choices, keyed by member. A member not listed installs as the pack decides. Change it through modpackMemberChanges.",
      +  "properties": {},
      +  "required": [],
      +  "type": "object"
      +}
  2. Changed1 schema field changed
    • addedInput schema / properties / body / properties / config / properties / entityBroadcastRangePercentage
      Added value: +{
      +  "description": "How far away players see mobs, items and other players, as a percentage of the normal range; default 100.",
      +  "maximum": 1000,
      +  "minimum": 10,
      +  "type": "integer"
      +}
  3. Changed2 schema fields changed
    • changedInput schema / properties / body / properties / config / properties / projects / description
      Previous value: -"Mods, plugins and datapacks to install from Modrinth, CurseForge or a direct download link, which the server downloads when it starts. A string is a Modrinth project id; an object names its source (modrinth, curseforge or url) and coord (the project id or the link). A Modrinth datapack uses the coord datapack:<project id> with kind datapack. Uploaded files are managed through the asset upload operations and kept as they are."New value: +"Mods, plugins and datapacks to install from Modrinth, CurseForge or a direct download link, which the server downloads when it starts. A string is a Modrinth project id; an object names its source (modrinth, curseforge or url) and coord (the project id or the link). A Modrinth datapack uses the coord datapack:<project id> with kind datapack. Uploaded files are added through the asset upload operations; an existing server's list is changed through projectChanges."
    • changedInput schema / properties / body / properties / config / properties / projects / items / anyOf
      Previous value: -[
      -  {
      -    "maxLength": 1024,
      -    "minLength": 1,
      -    "type": "string"
      -  },
      -  {
      -    "properties": {
      -      "bytes": {
      -        "minimum": 1,
      -        "type": "integer"
      -      },
      -      "coord": {
      -        "maxLength": 1024,
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "crc64nvme": {
      -        "pattern": "^[A-Za-z0-9+/]{11}=$",
      -        "type": "string"
      -      },
      -      "kind": {
      -        "enum": [
      -          "mod",
      -          "modpack",
      -          "plugin",
      -          "datapack",
      -          "resourcepack"
      -        ],
      -        "type": "string"
      -      },
      -      "metadata": {
      -        "properties": {
      -          "author": {
      -            "type": "string"
      -          },
      -          "description": {
      -            "anyOf": [
      -              {
      -                "type": "string"
      -              },
      -              {
      -                "properties": {
      -                  "bold": {
      -                    "type": "boolean"
      -                  },
      -                  "color": {
      -                    "type": "string"
      -                  },
      -                  "extra": {
      -                    "items": {
      -                      "properties": {
      -                        "bold": {
      -                          "type": "boolean"
      -                        },
      -                        "color": {
      -                          "type": "string"
      -                        },
      -                        "italic": {
      -                          "type": "boolean"
      -                        },
      -                        "obfuscated": {
      -                          "type": "boolean"
      -                        },
      -                        "strikethrough": {
      -                          "type": "boolean"
      -                        },
      -                        "text": {
      -                          "type": "string"
      -                        },
      -                        "underlined": {
      -                          "type": "boolean"
      -                        }
      -                      },
      -                      "required": [
      -                        "text"
      -                      ],
      -                      "type": "object"
      -                    },
      -                    "type": "array"
      -                  },
      -                  "italic": {
      -                    "type": "boolean"
      -                  },
      -                  "obfuscated": {
      -                    "type": "boolean"
      -                  },
      -                  "strikethrough": {
      -                    "type": "boolean"
      -                  },
      -                  "text": {
      -                    "type": "string"
      -                  },
      -                  "underlined": {
      -                    "type": "boolean"
      -                  }
      -                },
      -                "required": [
      -                  "text"
      -                ],
      -                "type": "object"
      -              }
      -            ]
      -          },
      -          "iconId": {
      -            "maxLength": 32,
      -            "type": "string"
      -          },
      -          "id": {
      -            "maxLength": 96,
      -            "type": "string"
      -          },
      -          "loader": {
      -            "enum": [
      -              "fabric",
      -              "quilt",
      -              "forge",
      -              "neoforge",
      -              "bukkit",
      -              "paper"
      -            ],
      -            "type": "string"
      -          },
      -          "minecraft": {
      -            "maxLength": 48,
      -            "type": "string"
      -          },
      -          "name": {
      -            "maxLength": 96,
      -            "type": "string"
      -          },
      -          "side": {
      -            "enum": [
      -              "client",
      -              "server",
      -              "both"
      -            ],
      -            "type": "string"
      -          },
      -          "version": {
      -            "maxLength": 48,
      -            "type": "string"
      -          }
      -        },
      -        "required": [],
      -        "type": "object"
      -      },
      -      "settings": {
      -        "additionalProperties": {
      -          "anyOf": [
      -            {
      -              "maxLength": 256,
      -              "type": "string"
      -            },
      -            {
      -              "type": "number"
      -            },
      -            {
      -              "type": "boolean"
      -            }
      -          ]
      -        },
      -        "properties": {},
      -        "required": [],
      -        "type": "object"
      -      },
      -      "source": {
      -        "enum": [
      -          "modrinth",
      -          "curseforge",
      -          "url",
      -          "upload"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "coord"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "maxLength": 1024,
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  {
      +    "properties": {
      +      "bytes": {
      +        "minimum": 1,
      +        "type": "integer"
      +      },
      +      "coord": {
      +        "maxLength": 1024,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "crc64nvme": {
      +        "pattern": "^[A-Za-z0-9+/]{11}=$",
      +        "type": "string"
      +      },
      +      "disabled": {
      +        "description": "Kept in the list but not installed, as if removed, until enabled again.",
      +        "type": "boolean"
      +      },
      +      "kind": {
      +        "enum": [
      +          "mod",
      +          "modpack",
      +          "plugin",
      +          "datapack",
      +          "resourcepack"
      +        ],
      +        "type": "string"
      +      },
      +      "metadata": {
      +        "properties": {
      +          "author": {
      +            "type": "string"
      +          },
      +          "description": {
      +            "anyOf": [
      +              {
      +                "type": "string"
      +              },
      +              {
      +                "properties": {
      +                  "bold": {
      +                    "type": "boolean"
      +                  },
      +                  "color": {
      +                    "type": "string"
      +                  },
      +                  "extra": {
      +                    "items": {
      +                      "properties": {
      +                        "bold": {
      +                          "type": "boolean"
      +                        },
      +                        "color": {
      +                          "type": "string"
      +                        },
      +                        "italic": {
      +                          "type": "boolean"
      +                        },
      +                        "obfuscated": {
      +                          "type": "boolean"
      +                        },
      +                        "strikethrough": {
      +                          "type": "boolean"
      +                        },
      +                        "text": {
      +                          "type": "string"
      +                        },
      +                        "underlined": {
      +                          "type": "boolean"
      +                        }
      +                      },
      +                      "required": [
      +                        "text"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    "type": "array"
      +                  },
      +                  "italic": {
      +                    "type": "boolean"
      +                  },
      +                  "obfuscated": {
      +                    "type": "boolean"
      +                  },
      +                  "strikethrough": {
      +                    "type": "boolean"
      +                  },
      +                  "text": {
      +                    "type": "string"
      +                  },
      +                  "underlined": {
      +                    "type": "boolean"
      +                  }
      +                },
      +                "required": [
      +                  "text"
      +                ],
      +                "type": "object"
      +              }
      +            ]
      +          },
      +          "iconId": {
      +            "maxLength": 32,
      +            "type": "string"
      +          },
      +          "id": {
      +            "maxLength": 96,
      +            "type": "string"
      +          },
      +          "loader": {
      +            "enum": [
      +              "fabric",
      +              "quilt",
      +              "forge",
      +              "neoforge",
      +              "bukkit",
      +              "paper"
      +            ],
      +            "type": "string"
      +          },
      +          "minecraft": {
      +            "maxLength": 48,
      +            "type": "string"
      +          },
      +          "name": {
      +            "maxLength": 96,
      +            "type": "string"
      +          },
      +          "side": {
      +            "enum": [
      +              "client",
      +              "server",
      +              "both"
      +            ],
      +            "type": "string"
      +          },
      +          "version": {
      +            "maxLength": 48,
      +            "type": "string"
      +          }
      +        },
      +        "required": [],
      +        "type": "object"
      +      },
      +      "settings": {
      +        "additionalProperties": {
      +          "anyOf": [
      +            {
      +              "maxLength": 256,
      +              "type": "string"
      +            },
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "boolean"
      +            }
      +          ]
      +        },
      +        "properties": {},
      +        "required": [],
      +        "type": "object"
      +      },
      +      "source": {
      +        "enum": [
      +          "modrinth",
      +          "curseforge",
      +          "url",
      +          "upload"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "coord"
      +    ],
      +    "type": "object"
      +  }
      +]
  4. Changed1 schema field changed
    • addedInput schema / properties / body / properties / config / properties / modpack / properties / curseforgeProjectId
      Added value: +{
      +  "maxLength": 20,
      +  "pattern": "^\\d+$",
      +  "type": "string"
      +}
  5. Changed1 schema field changed
    • changedInput schema / properties / body / properties / config / properties / modpack / description
      Previous value: -"A Modrinth or CurseForge modpack to run, downloaded from that site when the server starts. An uploaded .mrpack is set through the modpack upload operations instead."New value: +"A Modrinth or CurseForge modpack to run, downloaded from that site when the server starts. An uploaded .mrpack or CurseForge .zip is set through the modpack upload operations instead."
  6. First observed

TDQS

A4.8/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only declare the generic write/open-world profile; the description adds real behavioral context the annotations cannot convey: the server is created asleep and incurs no cost until woken, content downloads only on first start, region is permanently immutable, and accounts have a server cap. These are operational facts an agent must know before calling.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four dense sentences, front-loaded with what the call does and its cost profile, then region, then content, then the account limit. No sentence is redundant with another and none restates the title.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex, deeply nested creation tool with no output schema, the description covers the return value (id and join address), billing/deferred-start semantics, immutability of region, and content timing. It stops short of stating creation latency or whether the call is synchronous, which would help an agent set expectations on a provisioning call.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The nested schema is already extremely descriptive (region immutability, size pricing, modpack source enum), so the baseline is 3. The description still adds meaning: region determines player latency and must be asked rather than inferred from request origin, and uploaded .mrpack/zip content is explicitly out of scope for this call's content fields. It does not walk through name/size/config tradeoffs itself, so a point is withheld.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ("Creates a server") plus the key lifecycle qualifier "asleep and free until startServer or a joining player wakes it," and returns what the caller gets back (id and join address). It also distinguishes itself from siblings startServer, deleteServer, getPricingCatalog and the asset/modpack upload tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit routing rules: region must be asked from the user and never guessed, prices come from getPricingCatalog, uploaded files go through the asset or modpack upload tools instead of this call, and at the account limit use deleteServer. Both when-to-use and when-not-to-use this tool are covered.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources