← All tools

Maps

Look at a kept map

get_map

Look at a kept map from an earlier conversation: its layers, pin ids and fields. With no map named, list the person's own maps, including the ones they made in the InstaMaps Google Sheets add-on.

Read-only

Use it when

  • ✓ Before update_map, to see what is there
  • ✓ "Show me my maps" or "open my delivery map"
  • ✓ Opening a get-instamaps.com/map/... link from the Sheets add-on

Not for

Nothing close to it: this is the tool for the job.

Coverage: Maps made with render_map or a tool's render, and the signed-in person's own Sheets add-on maps.

Inputs

map

string

The map_id or link. Leave out to list the person's maps.

layer

string

A layer whose pins to list ("pins" for a Sheets add-on map).
The full description, as the server gives it to an agent

A map made with render_map: its link and downloads, its layers with their pin ids and fields, its version and the earlier versions kept; with layer, that layer's pins in full (first 500). Shows the map in the chat. Use it before update_map on a map from an earlier conversation. Also opens maps the person made in the InstaMaps Google Sheets add-on (a get-instamaps.com/map/... link); layer "pins" lists their pins. With no map, lists the person's own maps: use that when they ask to see their maps or give no link. The list in the chat doubles as a picker: the person can tick maps there and delete them, so use it when they want to delete some maps but haven't said which.

A real answer

Captured from the live server on 2026-10-13, trimmed to the first rows.

Request

{
  "map": "9hd9pnytqs"
}

The answer's first line

"Docs example: two depots" version 2: Rows (3 pins)

The answer (trimmed)

{
  "map_id": "9hd9pnytqs",
  "url": "https://get-instamaps.com/v/9hd9pnytqs",
  "geojson": "https://get-instamaps.com/v/9hd9pnytqs.geojson",
  "kml": "https://get-instamaps.com/v/9hd9pnytqs.kml",
  "title": "Docs example: two depots",
  "version": 2,
  "layers": [
    {
      "name": "Rows",
      "points": 3,
      "lines": 0,
      "areas": 0,
      "point_ids": [
        "leeds",
        "york",
        "harrogate"
      ],
      "fields": []
    }
  ],
  "earlier_versions": [
    1
  ]
}

Use it in Claude

Add InstaMaps from Claude's connector directory and ask in plain words. 5,000 tool calls a day per person, reset at midnight UTC; a call counts once however many rows it carries; a sheet by reference is one call; checking a job is free. No billing account sits behind it, so an agent left running cannot run up a bill: at the day's limit it stops until midnight UTC.

Address and map data © OpenStreetMap contributors.