Truetick Gg MCP server

TrueTick MCP Server

Manage TrueTick Minecraft servers directly from an AI agent. This MCP server exposes 29 tools covering the server-facing part of the TrueTick public API — lifecycle, console, metrics and tick history, files, backups, mods, templates and wallet — to Claude and other compatible AI clients.

It is not the whole API: the public surface is 97 operations. Networks, capacity and regions have no tools here at all, and of the account-scoped operations only the wallet is covered (get_wallet) — the ledger, account limits and checkout links are not. For those, call the REST API directly.

Installation & Setup

1. Get an API Key

Visit truetick.gg/dashboard/api-keys to create an API key. Select the scopes you need (e.g., servers:read, servers:write, billing:read).

2. Configure Claude Desktop

Add the following to your Claude Desktop config file (%APPDATA%\Claude\claudedesktopconfig.json on Windows, ~/Library/Application Support/Claude/claudedesktopconfig.json on Mac, or ~/.config/Claude/claudedesktopconfig.json on Linux):

{
  "mcpServers": {
    "truetick": {
      "command": "npx",
      "args": ["-y", "@truetick/mcp"],
      "env": {
        "TRUETICK_API_KEY": "ttk_your_key_here"
      }
    }
  }
}

Replace ttkyourkey_here with your actual API key.

3. Configuration

The MCP server reads its configuration from environment variables:

• TRUETICKAPIKEY (required): Your TrueTick API key with appropriate scopes.
• TRUETICKAPIURL (optional, defaults to https://api.truetick.gg): The API endpoint. Override for testing against a different environment.

Tool Catalog

Account & Wallet

• whoami — Show the account your API key is bound to.
• listservers** — List all your Minecraft servers.
• getwallet** — Show your wallet balance and recent transactions.

Server Management

• createserver** — Create a new Minecraft server (specify name, RAM, server type, version, region, billing plan).
• getserver** — Get details of a specific server.
• startserver** — Start a stopped server.
• stopserver** — Stop a running server.
• restartserver** — Restart a running server.
• deleteserver** — Permanently delete a server and all its data.
• updateserverversion — Change the server type and/or version (server must be stopped).
• setserverproperties — Update server.properties keys and optional idle timeout.
• setservermotd — Set the server's Message of the Day (MOTD).
• listtemplates** — List the server templates (presets) you can create from.
• createserverfromtemplate** — Create a server from a template preset.

Console & Metrics

together with tpsSource: TPSSOURCEUNSPECIFIED means there is no reading, not zero performance.

• runcommand** — Run a console (RCON) command on a running server.
• getservermetrics — Get live TPS/MSPT/player count metrics for a server. Read tps

Minutes the server slept through have no row at all — a gap is a real gap, never a zero.

• getservertickhistory** — One-minute buckets of tick health (default 24h, max 720).

• getrecentlogs — Fetch the most recent container log lines for a server (snapshot).

File Management

• listfiles** — List files in a directory on the server.
• readfile** — Read the contents of a file on the server.
• writefile** — Write content to a file on the server.
• deletefile** — Delete a file on the server.

Backups

• createbackup** — Create an on-demand backup of the server.
• listbackups** — List available backups for the server.
• restorebackup** — Restore a backup (server must be stopped; overwrites current data).

Mods & Plugins

Shortened. The full README is on GitHub.