Client setup

Every configuration below launches the same npx -y github:Tobralla/minehut-mcp binary. Pick the tab for your tool, paste, and the AI can start calling tools immediately.

Claude Code #

claude mcp add minehut-mcp \
  --env MINEHUT_EMAIL=you@example.com \
  --env MINEHUT_PASSWORD='your password' \
  -- npx -y github:Tobralla/minehut-mcp

Codex (OpenAI) #

codex mcp add minehut-mcp \
  --env MINEHUT_EMAIL=you@example.com \
  --env MINEHUT_PASSWORD='your password' \
  -- npx -y github:Tobralla/minehut-mcp

opencode #

Add a server block to opencode.json in your project, or to ~/.config/opencode/opencode.json to make it available in every project:

{
  "mcp": {
    "minehut": {
      "type": "local",
      "command": ["npx", "-y", "github:Tobralla/minehut-mcp"],
      "enabled": true,
      "environment": {
        "MINEHUT_EMAIL": "you@example.com",
        "MINEHUT_PASSWORD": "your password"
      }
    }
  }
}

Cursor #

Create .cursor/mcp.json in your project root, or add the server through Settings → MCP:

{
  "mcpServers": {
    "minehut": {
      "command": "npx",
      "args": ["-y", "github:Tobralla/minehut-mcp"],
      "env": {
        "MINEHUT_EMAIL": "you@example.com",
        "MINEHUT_PASSWORD": "your password"
      }
    }
  }
}

Hermes #

Add a server block to hermes.toml (or config.toml):

[mcp.servers.minehut]
command = "npx"
args = ["-y", "github:Tobralla/minehut-mcp"]
env = { MINEHUT_EMAIL = "you@example.com", MINEHUT_PASSWORD = "your password" }

Other MCP clients #

Any client that supports stdio MCP servers works. Point it at:

command: "npx"
args: ["-y", "github:Tobralla/minehut-mcp"]

Clients that need a local executable can use the global install from the installation page and set command to minehut-mcp.