Crafty Mcp Server MCP Server

An MCP (Model Context Protocol) server for Crafty Controller 4 — manage your Minecraft servers via AI assistants.

Local serverstdioAGPL-3.0-or-later

What is the Crafty Mcp Server?

Crafty Mcp Server is an MCP project maintained in the hadicherkaoui/crafty-mcp repository. The maintainer describes its purpose as “An MCP (Model Context Protocol) server for Crafty Controller 4 — manage your Minecraft servers via AI assistants”. Read the project documentation for the complete scope.

Installation

The documented npm package is crafty-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares CRAFTY_URL, CRAFTY_API_TOKEN, CRAFTY_ALLOW_INSECURE. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
crafty_loginLogin with username/password to get a bearer token
crafty_api_infoGet API version info and MOTD
crafty_list_schemasList available JSON schema names
crafty_get_schemaGet a specific JSON schema by name
crafty_get_statsGet host CPU, RAM, disk, and boot time
crafty_get_configGet Crafty panel configuration
crafty_update_configUpdate Crafty panel configuration
server_listList all managed Minecraft servers
server_getGet a server's full configuration
server_createCreate a new Minecraft server (Java, Bedrock, custom)
server_updateUpdate server configuration
server_deletePermanently delete a server
server_get_statsGet live stats: CPU/RAM, players online, version, world
server_get_logsGet server console log lines
server_get_historyGet historical stats for graphing
server_startStart a server
server_stopStop a server
server_restartRestart a server
server_killForce-kill a server process
server_backupTrigger an immediate backup
server_update_executableUpdate the server jar/executable
server_cloneClone an existing server
server_send_commandSend a command to the server console
server_list_filesList files/directories in a server directory
server_get_fileRead a file's contents
server_update_fileWrite or update a file
server_delete_fileDelete files or directories
server_create_fileCreate a new file
server_create_directoryCreate a new directory
server_rename_fileRename or move a file
server_decompress_fileDecompress an archive
server_list_backupsList all backups with timestamps and sizes
server_get_backup_configGet backup configuration
server_update_backup_configUpdate backup settings
server_restore_backupRestore a specific backup
server_delete_backupDelete a backup
server_list_tasksList all scheduled tasks
server_get_taskGet a task's configuration
server_create_taskCreate a scheduled task (interval or cron)
server_update_taskUpdate a scheduled task
server_delete_taskDelete a scheduled task
server_run_taskManually trigger a task
server_list_webhooksList all webhooks
server_get_webhookGet a webhook's details
server_create_webhookCreate a webhook (Discord, etc.)
server_update_webhookUpdate a webhook
server_delete_webhookDelete a webhook
server_test_webhookSend a test webhook message
user_listList all Crafty users
user_getGet a user's details (use @me for yourself)
user_createCreate a new user
user_updateUpdate a user
user_deleteDelete a user
user_get_permissionsGet user permissions
user_update_permissionsUpdate user permissions
user_get_api_keysList a user's API keys
user_create_api_keyGenerate a new API key
user_delete_api_keyRevoke an API key
role_listList all roles
role_getGet a role's details
role_createCreate a new role
role_updateUpdate a role
role_deleteDelete a role

How to install the Crafty Mcp Server

{
  "mcpServers": {
    "crafty": {
      "command": "npx",
      "args": [
        "-y",
        "crafty-mcp"
      ],
      "env": {
        "CRAFTY_URL": "https://localhost:8443",
        "CRAFTY_API_TOKEN": "YOUR_CRAFTY_API_TOKEN",
        "CRAFTY_ALLOW_INSECURE": "true"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
CRAFTY_URLDeclared in the maintainer’s client configuration.Yes
CRAFTY_API_TOKENDeclared in the maintainer’s client configuration.Optional
CRAFTY_ALLOW_INSECUREDeclared in the maintainer’s client configuration.Optional