{
  "markdown": "# TrueTick MCP Server\n\nManage TrueTick Minecraft servers directly from an AI agent. This MCP server exposes the full TrueTick public API as tools available to Claude and other compatible AI clients.\n\n## Installation & Setup\n\n### 1. Get an API Key\n\nVisit [truetick.gg/dashboard/api-keys](https://truetick.gg/dashboard/api-keys) to create an API key. Select the scopes you need (e.g., `servers:read`, `servers:write`, `billing:read`).\n\n### 2. Configure Claude Desktop\n\nAdd the following to your Claude Desktop config file (`%APPDATA%\\Claude\\claude_desktop_config.json` on Windows, `~/Library/Application Support/Claude/claude_desktop_config.json` on Mac, or `~/.config/Claude/claude_desktop_config.json` on Linux):\n\n```json\n{\n  \"mcpServers\": {\n    \"truetick\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@truetick/mcp\"],\n      \"env\": {\n        \"TRUETICK_API_KEY\": \"ttk_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nReplace `ttk_your_key_here` with your actual API key.\n\n### 3. Configuration\n\nThe MCP server reads its configuration from environment variables:\n\n- `TRUETICK_API_KEY` (required): Your TrueTick API key with appropriate scopes.\n- `TRUETICK_API_URL` (optional, defaults to `https://api.truetick.gg`): The API endpoint. Override for testing against a different environment.\n\n## Tool Catalog\n\n### Account & Wallet\n\n- **whoami** — Show the account your API key is bound to.\n- **list_servers** — List all your Minecraft servers.\n- **get_wallet** — Show your wallet balance and recent transactions.\n\n### Server Management\n\n- **create_server** — Create a new Minecraft server (specify name, RAM, server type, version, region, billing plan).\n- **get_server** — Get details of a specific server.\n- **start_server** — Start a stopped server.\n- **stop_server** — Stop a running server.\n- **restart_server** — Restart a running server.\n- **delete_server** — Permanently delete a server and all its data.\n- **update_server_version** — Change the server type and/or version (server must be stopped).\n- **set_server_properties** — Update server.properties keys and optional idle timeout.\n- **set_server_motd** — Set the server's Message of the Day (MOTD).\n\n### Console & Metrics\n\n- **run_command** — Run a console (RCON) command on a running server.\n- **get_server_metrics** — Get live TPS/MSPT/player count metrics for a server.\n\n### File Management\n\n- **list_files** — List files in a directory on the server.\n- **read_file** — Read the contents of a file on the server.\n- **write_file** — Write content to a file on the server.\n- **delete_file** — Delete a file on the server.\n\n### Backups\n\n- **create_backup** — Create an on-demand backup of the server.\n- **list_backups** — List available backups for the server.\n- **restore_backup** — Restore a backup (server must be stopped; overwrites current data).\n\n### Mods & Plugins\n\n- **list_mods** — List mods/plugins installed on the server.\n- **add_mod** — Add a mod or plugin from Modrinth or CurseForge.\n- **remove_mod** — Remove a mod or plugin from the server.\n\n## Development\n\n```bash\nnpm run build      # Compile TypeScript\nnpm test           # Run tests\nnpm start          # Run the MCP server (for manual testing)\n```\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\n## About this repository\n\nDevelopment of TrueTick happens in a private monorepo; this repository mirrors\nreleased versions of `@truetick/mcp`. Issues and discussions are welcome right\nhere — for code contributions, please propose the change in an issue first.\n\nRelated: [TypeScript SDK & CLI](https://github.com/truetick-gg/truetick-js) ·\n[developer docs](https://docs.truetick.gg) · [truetick.gg/developers](https://truetick.gg/developers)\n",
  "bytes": 3654,
  "sha": "0061a4b0ff02ad43c3675744a391b2cb6fb407ef1ed7e192ee9379758b565b86",
  "repo_slug": "truetick-gg/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_truetick_gg_mcp_3104e7d7/readme"
}