Minecraft MCP server

Endpoint: https://api.pugtools.com/mcp. It uses stateless MCP Streamable HTTP and supports the current discovery flow plus the widely deployed 2025-11-25 initialize flow. There is no legacy HTTP+SSE endpoint.

Tools

• minecraft_search: find candidate identifiers from everyday language. Kinds are block, item, entity, recipe, trade, ore, asset, enchantment, loot, and structure. Search reports exact, high-confidence, ambiguous, weak, or no-match status and retains ranked candidates when a phrase has more than one plausible meaning.
• minecraft_get: fetch one normalized record by kind and canonical id. For trade the id is the villager profession.
• minecraft_query: run up to ten of the same lookups in one call, where a single unknown id does not fail the batch.
• minecraft_get_player: fetch a Java profile or skin reference for a username or UUID.

Every tool is read-only and non-destructive. Static-data tools do not use the open internet. The player tool accurately declares that it contacts the configured Mojang provider and may be disabled until upstream access is approved.

Response shape

Tool calls return both a concise text summary and validated structuredContent in the shared response envelope. MCP omits the REST-only requestId on success.

{
  "schemaVersion": "1",
  "minecraftVersion": "26.2",
  "data": { "id": "minecraft:diamond_ore", "type": "block" },
  "warnings": [],
  "meta": {
    "edition": "java",
    "provider": "pugtools",
    "canonicalUrl": "https://pugtools.com/tools/assets/?q=Diamond%20Ore",
    "contentClass": "DATA"
  },
  "provenance": {
    "source": "mc-datahub",
    "sourceCommit": "2ed9c96",
    "generatedAt": "2026-07-27T20:22:44.579Z"
  }
}

A failed tool call returns an error result whose structured content is { "ok": false, "requestId": "...", "error": { "code", "message" } }.

Test with MCP Inspector

npx @modelcontextprotocol/inspector@latest --cli \
  --server-url https://api.pugtools.com/mcp \
  --transport http \
  --method tools/list

The Inspector should enumerate all four tools. In saved Inspector configuration, use type: "http", this URL, and protocolEra: "auto".

Good uses

Use Pugtools when an agent needs factual Minecraft game information, a namespaced identifier, recipe, enchantment rules, condition-aware mob drops, structure metadata, villager trade pool, ore-generation data, Minecraft asset metadata, or an approved player skin/profile reference. It is not appropriate for unrelated games, arbitrary URL downloads, or bulk vanilla asset redistribution.

See the service policies and REST API reference.