# Change a kept map (update_map): InstaMaps MCP tool

> Change a kept map in place: add or remove layers, move or add pins, recolour, rename; the link stays the same and earlier versions are kept. Inputs, sources with dates and a real example answer.

Source: https://get-instamaps.com/mcp-server/tools/update_map

[InstaMaps](/)

[Features](#features)[How It Works](#how-it-works)[Tools](/tools)[Store Locator](/store-locator)[Blog](/blog)[Support](/support)

[ Get Started ](https://workspace.google.com/marketplace/app/instamaps/103204565785?utm%5Fsource=get-instamaps&utm%5Fmedium=site&utm%5Fcampaign=header)

[← All tools](/mcp-server/tools)

Maps

# Change a kept map

`update_map`

Change a kept map in place: add or remove layers, move or add pins, recolour, rename; the link stays the same and earlier versions are kept.

## Use it when

* ✓ Correcting or extending a map made earlier
* ✓ Recolouring by a different field

## Not for

* → Making a new map: [render\_map](/mcp-server/tools/render%5Fmap)

Coverage: Worldwide for rows with coordinates; addresses are placed as geocode\_batch places them.

## Inputs

map

string **· required**

The map\_id or link render\_map returned. 

title

string

A new title. 

add\_layers

array

— 

remove\_layers

array

Names of layers to remove. 

update\_layers

array

— 

upsert\_points

array

Move, rename or re-field a pin by its id, or add a new one (new pins need lat/lng or an address). 

remove\_points

array

— 

legend

boolean

— 

flood\_zones

boolean

true: draw the official flood zones under the layers (FEMA in the US, the Environment Agency in England); false: take them off. 

house\_districts

boolean

true: draw the House districts on the Nov 3 2026 ballot under the layers (US; Missouri on its 2022 lines); false: take them off. 

revert\_to

integer

Put this earlier version back (it becomes the newest version; nothing is lost). 

The full description, as the server gives it to an agent

Change a map made with render\_map (or a tool's render): add or remove layers; move, rename or add pins (by id, with lat/lng or an address); remove pins; recolour a layer (one colour, or by a field's values, with colours per value if wanted, or by a number in the user's own bands: bins); show or hide names or a whole layer; rename the map; draw or remove the flood zones or the House districts on the Nov 3 2026 ballot. Several changes in one call. The link stays the same, and every earlier version is kept: revert\_to puts one back. get\_map lists the layers, pin ids and fields.

## A real answer

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

Request

{
  "map": "9hd9pnytqs",
  "upsert_points": [
    {
      "layer": "Rows",
      "id": "harrogate",
      "name": "Harrogate depot",
      "lat": 53.9921,
      "lng": -1.5418
    }
  ]
}

The answer's first line

Updated "Docs example: two depots" to version 2: added harrogate to "Rows". Same link: https://get-instamaps.com/v/9hd9pnytqs

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",
  "version": 2,
  "changes": [
    "added harrogate to \"Rows\""
  ],
  "layers": [
    {
      "name": "Rows",
      "points": 3,
      "lines": 0,
      "areas": 0
    }
  ]
}

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.

[Add to Claude →](https://claude.ai/directory/connectors/instamaps)[ChatGPT, Gemini or Copilot](/mcp-server#add)

 Address and map data © [OpenStreetMap contributors](https://www.openstreetmap.org/copyright).
