get_map
Retrieve a current snapshot of the game world map, with optional scopes for your cells, surrounding hexes, specific cells, or a full overview. Includes neighbor connections and resource holdings.
Instructions
Read the live game world. The map is loaded at startup and kept current in the background; this returns a snapshot of it on demand (you only see updates when you call a tool). The map is public — you can see every player. Resources live on cells. Always returns a "summary" (counts + freshness) and, when your wallet is known, a "resourceIndex" (resourceId → your cells holding it, with location). Cells come back as a graph: each carries axial x/y and "neighbors" (the 6 adjacent hexes, each owned/other/empty). Scopes: "mine" (your cells), "around" (cells within a hex radius — scout a region), "cells" (specific tokenIds), "all" (everything), "summary" (no cells). Default: "mine", else "summary". Note units: version/updated are epoch ms, serverTime/startAt are unix seconds, amounts are decimal strings. Also carries "server": { reachable } — false means the game server is unreachable right now and actions will fail; retry once it is true again.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scope | No | mine | around | cells | all | summary. Omit to default to "mine" (or "summary" if no wallet). | |
| tokenIds | No | Required for scope="cells": the cell tokenIds to return. | |
| centerX | No | Axial x of the centre for scope="around". | |
| centerY | No | Axial y of the centre for scope="around". | |
| radius | No | Hex radius for scope="around" (default 2, max 10). |