Tool reference
19 tools in two groups. The API tools need a captured session (see
authentication); the browser tools need Chromium
(minehut-mcp-setup).
API tools #
Direct REST calls against api.minehut.com. Fast, deterministic, and ideal for
anything the AI needs to script. Every server argument accepts either the server
name or its 24-character id.
| Tool | Arguments | Description |
|---|---|---|
minehut_status |
server |
Status, player count, RAM, MOTD, version and plugin list |
minehut_servers |
none | Every server on the account with live status |
minehut_start |
server |
Power on the server service |
minehut_stop |
server |
Save and power off the server |
minehut_restart |
server |
Stop, wait briefly, start again |
minehut_command |
server, command |
Send a console command with operator privileges, e.g. say hello, give Inxx diamond 64, time set day |
minehut_logs |
server, lines |
Most recent console output, capped at 500 lines |
minehut_upgrade_ram |
server, ram |
Change RAM allocation in GB. The server may restart. Plan limits apply |
Browser tools #
Playwright automation against the real dashboard. This layer has no dependency on the Minehut API and works even when the API changes underneath.
| Tool | Arguments | Description |
|---|---|---|
browser_open |
url |
Open a page and return its title, current URL and visible text so the AI can read the state of the panel |
browser_login_panel |
email, password |
Log into the dashboard and capture the API session automatically. Falls back to MINEHUT_EMAIL / MINEHUT_PASSWORD |
browser_wait_manual |
seconds |
Wait while a human finishes a Cloudflare challenge, 2FA or password manager, then capture the session |
browser_click |
selector |
Click the first visible element matching a CSS selector |
browser_type |
selector, text, press_enter |
Type into an element, optionally pressing Enter afterwards |
browser_press |
key |
Send a keyboard key such as Enter, Escape, Tab or F5 |
browser_text |
selector, max_chars |
Visible text of an element, or of the whole page when no selector is given |
browser_screenshot |
selector, full_page |
Screenshot of the page or one element, returned as an image the AI can look at, plus a saved PNG path |
browser_evaluate |
js |
Run a JavaScript expression in the dashboard page and return its result |
browser_close |
none | Close the browser and release resources |
Guidance #
| Tool | Description |
|---|---|
minehut_help |
In-server guide with the recommended first-time flow and the current browser mode |
Names vs ids. Exact 24-character values are treated as server ids;
anything shorter is resolved by name with the Minehut
?byName=true lookup.