bsm-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@bsm-mcp start the bedrock server"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Bedrock Server Manager MCP Server (bsm-mcp)
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/tokenendpoint 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 |
| Base URL of your Bedrock Server Manager web instance |
|
| BSM user account with appropriate permissions |
|
| Password for the user account |
|
| Optional pre-existing JWT access token |
|
| Path or URL to OpenAPI spec (if using local file) |
|
| Request timeout in seconds |
|
| Verify SSL certificates when connecting over HTTPS |
|
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-mcpLicense
This project is licensed under the MIT License.
Available Tools
17 toolsadd_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
Scored across 17 tools
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.
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.
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.
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
Related MCP Connectors
Manage NodePal Minecraft servers, worlds, mods, backups and console from AI agents.
1MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
Secure and manage MCP servers through the Speakeasy AI Control Plane from your agent.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to manage Minecraft servers through MCSManager, including instance control (start/stop/restart), file management, scheduled tasks, user management, and backup operations.5-
- FlicenseNot gradedqualityDmaintenanceEnables control of a Minecraft server through RCON commands via natural language, including game commands, chat-based AI interactions, and server management capabilities.6-
- FlicenseNot gradedqualityDmaintenanceEnables natural language management of Minecraft Bedrock Edition servers through AI assistants. Supports server lifecycle operations, player/world management, backups, add-ons, and automated tasks via the Bedrock Server Manager API.1-
- AlicenseBqualityDmaintenanceEnables AI assistants to interact with and manage Minecraft servers through a standardized interface, supporting server monitoring, player management, log analysis, and command execution.111MIT