Documentation

Everything you need to connect your AI agent to your Minecraft server.

How it works

BlockMind is a proxy between your AI agent and your host's panel API. When your agent calls an MCP tool, the request goes to a Cloudflare Worker that forwards it to PebbleHost using your API key. Your key is never stored: it flows from your agent's config, over HTTPS, through the Worker, to your host on every request, and is forgotten instantly.

Why a prompt instead of a config file?

Every AI client stores MCP configs in a different place, in a different format. Instead of teaching you twelve config formats, BlockMind gives your agent one prompt. The agent already knows its own config file (or can find it), so it installs BlockMind itself, verifies the connection, and reports back. If your agent cannot edit its own config, it prints the exact snippet and tells you where to paste it.

Multiple servers on one account

Your API key is account-wide: it can reach every server on your PebbleHost account, not just the one you name in setup. The server ID you enter is a default target, not a permission boundary. That is why the install prompt tells your agent to touch only the server you named, and to stop and ask you whenever it is unsure which server you mean, or when a server you mention is not on the account.

Available tools

The exact set depends on your host. Pterodactyl hosts (PebbleHost, BisectHosting) get the 13 tools below. exaroton gets a leaner set of 9 matching its API, including send_command for console commands.

Read-only (safe)

  • list_servers: list every server on your account
  • get_server: details for one server
  • get_server_resources: CPU, memory, disk, uptime
  • list_files: list files in a directory
  • read_file: read a text file (credential files are blocked)
  • download_file: get a temporary download URL
  • get_console_logs: read recent server logs
  • get_startup_variables: read startup config

Mutating (guarded by the safety rules)

  • write_file: write or replace a file
  • upload_file: get a signed upload URL
  • delete_files: delete files (destructive)
  • power_action: start, stop, restart, kill
  • update_startup_variable: change a startup variable

Getting your PebbleHost API key

  1. Log in to the PebbleHost panel (panel.pebblehost.com).
  2. Open Account, then API Credentials.
  3. Create a client API key. It starts with ptlc_.
  4. Copy it now. The panel only shows it once.

Finding your server ID

The 8-character ID in your panel URL: panel.pebblehost.com/server/<server ID>. You can also leave it blank: your agent will call list_servers and pick it up on its own.

Troubleshooting

My agent says 401 Unauthorized

Check that your API key is correct and starts with ptlc_. If the key was ever exposed, revoke it in the panel and create a new one, then regenerate the prompt.

Console logs come back empty

Make sure the server is running. get_console_logs reads logs/latest.log by default; if your server logs elsewhere, ask the agent to list_files first.

My client does not support HTTP MCP servers

Open step 4 on the setup page, choose "Any stdio client", and paste the generated config. It bridges the HTTP endpoint through npx mcp-remote.

The prompt contains my API key. Is that safe?

The key has to reach your own agent for it to authenticate. That is the same trust as pasting the key into a config file. Only paste the prompt into agents you trust, and revoke the key if you ever paste it somewhere wrong.

Ready to connect your AI?

Get started

Not affiliated with Mojang, Microsoft, or any hosting provider. Minecraft is a trademark of Mojang Synergies AB.