Skip to main content
Glama

Bedrock Server Manager MCP Server (bsm-mcp)

License: MIT

A Model Context Protocol (MCP) server for Bedrock Server Manager (BSM), enabling AI assistants (such as Antigravity, Claude Desktop, Cursor, and OpenHands) to manage Minecraft Bedrock Dedicated Servers via natural language.

Features

  • OpenAPI Powered: Automatically discovers and binds all endpoints from Bedrock Server Manager's OpenAPI specification (/openapi.json).

  • Dynamic Endpoint Support: Automatically adapts to any custom endpoints added by BSM plugins or server updates.

  • Automated Authentication: Seamlessly authenticates with BSM's /auth/token endpoint using JWT Bearer tokens and handles automatic token refreshing.

  • Server Lifecycle & Commands: Start, stop, restart, run commands (say, kick, whitelist), monitor resource stats, manage backups, and configure allowlists.

Related MCP server: Minecraft MCP Server

Quick Start

Using uvx (Recommended)

No installation required. Add bsm-mcp directly to your MCP client configuration (e.g. mcp_config.json or claude_desktop_config.json):

{
  "mcpServers": {
    "bedrock-server-manager": {
      "command": "uvx",
      "args": ["bedrock-server-manager-mcp"],
      "env": {
        "BSM_URL": "http://localhost:8000",
        "BSM_USERNAME": "admin",
        "BSM_PASSWORD": "your-password"
      }
    }
  }
}

Environment Variables

Variable

Description

Default

BSM_URL

Base URL of your Bedrock Server Manager web instance

http://localhost:8000

BSM_USERNAME

BSM user account with appropriate permissions

admin

BSM_PASSWORD

Password for the user account

""

BSM_TOKEN

Optional pre-existing JWT access token

None

BSM_OPENAPI_PATH

Path or URL to OpenAPI spec (if using local file)

None (fetches from /openapi.json)

BSM_TIMEOUT

Request timeout in seconds

30.0

BSM_VERIFY_SSL

Verify SSL certificates when connecting over HTTPS

true

Development

# Clone the repository
git clone https://github.com/DrPapaya17/bedrock-server-manager-mcp.git
cd bedrock-server-manager-mcp

# Install dependencies using uv
uv sync --all-extras

# Run the MCP server
uv run bsm-mcp

License

This project is licensed under the MIT License.

Available Tools

17 tools
add_to_allowlistAdd To AllowlistC

Add a player by gamertag and optional XUID to the server allowlist.

Inputs: name (required), server_name (required), xuid, ignoresPlayerLimit.

create_backupCreate BackupC

Create a hot backup of the specified Minecraft server's world and configuration.

Inputs: server_name (required).

get_allowlistGet AllowlistC

Get the allowlist (whitelist) of players permitted to join the server.

Inputs: server_name (required).

get_permissionsGet PermissionsB

Get player permission levels (visitor, member, operator) configured for the server.

Inputs: server_name (required).

get_propertiesGet PropertiesC

Retrieve key-value settings from server.properties (e.g. gamemode, difficulty, max-players, port).

Inputs: server_name (required).

get_server_statusGet Server StatusB

Get detailed runtime status, CPU/RAM usage, and active player counts for a specific server.

Inputs: server_name (required).

get_system_infoGet System InfoA

Retrieve host system resource usage, OS details, and BSM application version.

Inputs: no named parameters.

list_addonsList AddonsC

List all behavior and resource packs installed on the server.

Inputs: server_name (required).

list_all_serversList All ServersA

Retrieve overview and operational status for all managed Minecraft Bedrock servers.

Inputs: no named parameters. Returns: servers

list_backupsList BackupsC

List all available backup archives for a specific server.

Inputs: server_name (required).

obtain_tokenObtain TokenB

Authenticate using username and password to receive a Bearer JWT access token.

Inputs: password (required), username (required), remember_me. Returns: token_type, access_token

remove_from_allowlistRemove From AllowlistB

Remove a player from the server allowlist by gamertag.

Inputs: name (required), server_name (required).

restart_serverRestart ServerB

Restart a running Minecraft Bedrock Dedicated Server.

Inputs: server_name (required).

send_commandSend CommandB

Execute a console command on a running Minecraft server (e.g. 'say Hello', 'whitelist on', 'time set day').

Inputs: command (required), server_name (required).

set_permissionSet PermissionC

Set a player's permission level by XUID.

Inputs: xuid (required), permission (required), server_name (required).

start_serverStart ServerB

Start a stopped Minecraft Bedrock Dedicated Server.

Inputs: server_name (required).

stop_serverStop ServerB

Gracefully stop a running Minecraft Bedrock Dedicated Server.

Inputs: server_name (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 17 tools

    Disambiguation5/5

    Each tool targets a distinct resource or action: auth, host info, server listing, per-server status, lifecycle, console, backups, allowlist, permissions, properties, and addons. Overlaps like list_all_servers versus get_server_status are differentiated by scope (all servers vs one server) and descriptions clarify intent. No two tools appear to do the same thing.

    Naming Consistency5/5

    Names follow a consistent snake_case verb_noun pattern (get_, list_, start_, stop_, add_, remove_, set_, create_). Minor variations like obtain_token versus get_* and get_permissions versus set_permission are still predictable. Overall naming is highly consistent.

    Tool Count4/5

    17 tools is slightly above the typical 3-15 sweet spot but each tool maps to a distinct capability in server management. No obvious redundant tools exist, though the count is on the heavier side.

    Completeness3/5

    Core read and lifecycle coverage exists, but notable gaps remain: properties can be read (get_properties) but not written (no set_properties), backups can be created and listed but not restored or deleted, and there is no server create/delete. These missing operations create dead ends for common administrative workflows.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers