Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CRAFTY_URL | Yes | Crafty Controller base URL (e.g. https://localhost:8443) | |
| CRAFTY_TIMEOUT | No | Request timeout in milliseconds (default: 30000) | 30000 |
| CRAFTY_API_TOKEN | No | Bearer token from Crafty UI. Optional if you authenticate dynamically using the crafty_login tool, but recommended for most setups. | |
| CRAFTY_ALLOW_INSECURE | No | Set to true to allow self-signed certificates (Crafty's default) |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| crafty_login | Login with username and password to get a bearer token. Use this if you prefer username/password authentication over a pre-generated API token. |
| crafty_api_info | Get Crafty Controller API version information and message of the day (MOTD). Does not require authentication. |
| crafty_list_schemas | List all available JSON schema names in Crafty Controller. Does not require authentication. |
| crafty_get_schema | Get a specific JSON schema by name from Crafty Controller. Use crafty_list_schemas to discover available schema names. |
| crafty_get_stats | Get Crafty Controller host system stats: CPU usage/count/frequency, RAM usage/total/percent, disk data (device, total, used, free, percent, filesystem, mount), and boot time |
| crafty_get_config | Get Crafty Controller panel configuration settings |
| crafty_update_config | Update Crafty Controller panel configuration settings |
| server_list | List all Minecraft servers managed by Crafty Controller with their IDs, names, types, ports, and configurations |
| server_get | Get full configuration details for a specific Minecraft server |
| server_create | Create a new Minecraft server in Crafty Controller. Supports Java (download jar or import), Bedrock, and custom server types. |
| server_update | Update a Minecraft server's configuration (name, ports, auto-start, crash detection, stop command, etc.) |
| server_delete | Delete a Minecraft server from Crafty Controller |
| server_start | Start a Minecraft server |
| server_stop | Stop a Minecraft server (sends configured stop command) |
| server_restart | Restart a Minecraft server |
| server_kill | Force-kill a Minecraft server process immediately |
| server_backup | Trigger an immediate backup of a Minecraft server's files |
| server_update_executable | Update the server jar/executable from the configured download URL |
| server_clone | Clone an existing Minecraft server (server must not be running) |
| server_send_command | Send a command to a running Minecraft server's console. Examples: 'say Hello everyone!', 'op PlayerName', 'whitelist add Player', 'gamemode creative Player', 'time set day', 'weather clear' |
| server_get_logs | Get a Minecraft server's console logs as an array of log lines |
| server_get_stats | Get live runtime statistics for a Minecraft server including CPU/RAM usage, online player count and list, world name/size, MOTD, version, and whether it is running |
| server_get_history | Get historical runtime statistics for a Minecraft server (CPU, RAM over time, useful for graphing trends) |
| server_list_files | List files and directories in a Minecraft server's directory |
| server_get_file | Read the contents of a file on a Minecraft server (e.g., server.properties, ops.json, whitelist.json) |
| server_update_file | Write or update a file on the Minecraft server (e.g., server.properties, ops.json, whitelist.json) |
| server_delete_file | Delete one or more files or directories from a Minecraft server |
| server_create_file | Create a new file on a Minecraft server |
| server_create_directory | Create a new directory on a Minecraft server |
| server_rename_file | Rename or move a file or directory on a Minecraft server |
| server_decompress_file | Decompress/unzip an archive file on a Minecraft server |
| server_list_backups | List all backups for a Minecraft server with timestamps and sizes |
| server_get_backup_config | Get backup configuration for a Minecraft server (compression, exclusions, schedule, max backups) |
| server_update_backup_config | Update backup configuration for a Minecraft server |
| server_restore_backup | Restore a specific backup for a Minecraft server |
| server_delete_backup | Delete a specific backup for a Minecraft server |
| server_list_tasks | List all scheduled tasks for a Minecraft server |
| server_get_task | Get configuration for a specific scheduled task |
| server_create_task | Create a scheduled task for a Minecraft server. Use interval_type with interval for simple schedules (e.g., every 6 hours), or set cron_string with empty interval_type for cron-based schedules (e.g., '0 3 * * *' for 3 AM daily). |
| server_update_task | Update an existing scheduled task for a Minecraft server |
| server_delete_task | Delete a scheduled task from a Minecraft server |
| server_run_task | Manually trigger a scheduled task immediately |
| server_list_webhooks | List all webhooks configured for a Minecraft server |
| server_get_webhook | Get details for a specific webhook |
| server_create_webhook | Create a new webhook for a Minecraft server. Supports Discord and other webhook types. Trigger events: server_start, server_stop, server_backup, player_join, player_leave, etc. |
| server_update_webhook | Update an existing webhook for a Minecraft server |
| server_delete_webhook | Delete a webhook from a Minecraft server |
| server_test_webhook | Send a test message to verify a webhook is working |
| user_list | List all Crafty Controller users. Returns user_id, username, enabled, superuser, lang, and creation date. |
| user_get | Get details for a specific Crafty Controller user. Use '@me' as user_id to get the currently authenticated user. |
| user_create | Create a new Crafty Controller user account. Requires superuser privileges. |
| user_update | Update a Crafty Controller user account |
| user_delete | Permanently delete a Crafty Controller user account. Requires superuser privileges. |
| user_get_permissions | Get a user's Crafty and per-server permissions |
| user_update_permissions | Update a user's Crafty and per-server permissions |
| user_get_api_keys | List API keys for a Crafty Controller user |
| user_create_api_key | Generate a new API key for a Crafty Controller user |
| user_delete_api_key | Revoke/delete an API key for a Crafty Controller user |
| role_list | List all roles in Crafty Controller |
| role_get | Get details for a specific role |
| role_create | Create a new role in Crafty Controller |
| role_update | Update an existing role in Crafty Controller |
| role_delete | Delete a role from Crafty Controller |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |