Frequently asked questions

Which AI tools work with this? #

Anything that speaks the stdio MCP protocol. Claude Code, Codex, opencode, Cursor and Hermes are documented on the client setup page. Any other MCP client works with the same two-line config.

Why does the browser need to log in? #

The Minehut dashboard is behind Cloudflare and its API session system changes frequently. A real browser login solves the challenges for you and captures the session automatically. The API tools then work directly without a browser.

Where does it store my credentials? #

Only the session token is stored, in ~/.minehut-mcp/session.json with file permissions 600. Email and password are used in memory for the browser login and never written to disk, unless you put them into environment variables yourself.

The browser opens but nothing gets typed. #

Cloudflare may show a challenge before the login form exists. Use browser_wait_manual and solve the challenge in the visible window. Set MINEHUT_HEADLESS=0 so the window is visible while you work through it.

API tools say the session was rejected. #

The session expired. Run browser_login_panel again. The stored browser profile usually makes the second login a single click.

Can the AI read the dashboard visually? #

Yes. browser_screenshot returns a screenshot as an image the AI can actually look at, plus a PNG file saved under ~/.minehut-mcp/.

Can the AI install plugins? #

Through the browser layer, yes: it opens the plugin page, clicks, and confirms like a human would. Whether a given plugin supports bulk install from the console is a Minehut feature question, not a limitation of this server.

What happens to my server when the MCP server stops? #

Nothing. The MCP server only sends actions when the AI calls a tool. Your Minehut server keeps running on its own. browser_close only closes the local browser window.

Is this allowed by Minehut? #

The server uses the same public login flow and dashboard a human uses, over its own API endpoints. It does not bypass anything. Review the Minehut terms of service and use it on your own account only.

Can I use it with multiple Minehut accounts? #

Not in one running instance. One instance owns one session file. Start a second MCP server with HOME pointed at a different directory, or swap the environment variables between sessions.

Do I need to pay for anything? #

No. The server is MIT licensed and the runtime is plain Node.js with a free Chromium download via minehut-mcp-setup.