# Combine kept runs on the same places (combine_runs): InstaMaps MCP tool

> Join two to six kept runs on the place ID every tool returns (record_key) and say what changed between them. Inputs, sources with dates and a real example answer.

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

[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)

Runs and jobs

# Combine kept runs on the same places

`combine_runs`

Join two to six kept runs on the place ID every tool returns (record\_key) and say what changed between them.

Read-only

## Use it when

* ✓ "Which sites' nearest A&E got further away since September?"
* ✓ Merging geocode results with facts or risk for the same places

## Not for

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

Coverage: Any runs from earlier answers (run\_ids) or tables you send.

## Inputs

runs

array **· required** · up to 6

Oldest first. 

key

string

The place ID column every run has. Default: "record\_key"

columns

array

Only these columns from each run (default: all). 

compare

array

Columns to compare between runs: numbers get the change, text whether it changed. 

only\_changed

boolean

— Default: false

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

Join two to 6 kept runs (run\_ids from earlier answers, or tables such as dated tabs in Drive) on the place ID every tool returns (record\_key), each run's columns kept separate under its name, and say what changed between the first and last run for the columns named in compare: "sites whose nearest A&E got further away since September". Places in only some runs are kept and say which; only\_changed returns just the rows that changed. Up to 5,000 rows a run; the first 300 combined rows come back.

## A real answer

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

Request

{
  "runs": [
    "run_… (geocode_batch)",
    "run_… (get_area_risk flood)"
  ],
  "key": "record_key"
}

The answer's first line

2 places across 2 runs, 2 in every run

The answer (trimmed)

{
  "key": "record_key",
  "runs": [
    "run run_07c597b8258f61ac (geocode_batch)",
    "run run_ec5e360aa4e6152c (get_area_risk)"
  ],
  "summary": {
    "places": 2,
    "in_every_run": 2
  },
  "rows": [
    {
      "record_key": "rk1_e9ec1ea25045e3a5e393",
      "run run_07c597b8258f61ac (geocode_batch): id": "hq",
      "run run_07c597b8258f61ac (geocode_batch): address": "10 Downing Street, London SW1A 2AA",
      "run run_07c597b8258f61ac (geocode_batch): Placed": "placed",
      "run run_07c597b8258f61ac (geocode_batch): Precision": "rooftop",
      "run run_07c597b8258f61ac (geocode_batch): Confidence": "high",
      "run run_07c597b8258f61ac (geocode_batch): House number": "10",
      "run run_07c597b8258f61ac (geocode_batch): Street": "Downing Street",
      "run run_07c597b8258f61ac (geocode_batch): City": "London",
      "run run_07c597b8258f61ac (geocode_batch): County": "Greater London",
      "run run_07c597b8258f61ac (geocode_batch): State": "England",
      "run run_07c597b8258f61ac (geocode_batch): Postcode": "SW1A 2AA",
      "run run_07c597b8258f61ac (geocode_batch): Country": "GB",
      "run run_07c597b8258f61ac (geocode_batch): Council": "Westminster",
      "run run_07c597b8258f61ac (geocode_batch): UPRN": "100023336956",
      "run run_07c597b8258f61ac (geocode_batch): Record key": "rk1_e9ec1ea25045e3a5e393",
      "run run_ec5e360aa4e6152c (get_area_risk): id": "hq",
      "run run_ec5e360aa4e6152c (get_area_risk): address": "10 Downing Street, London SW1A 2AA",
      "run run_ec5e360aa4e6152c (get_area_risk): flood zone": "Zone 3",
      "run run_ec5e360aa4e6152c (get_area_risk): Confidence": "high",
      "in_runs": [
        "run run_07c597b8258f61ac (geocode_batch)",
        "run run_ec5e360aa4e6152c (get_area_risk)"
      ]
    },
    {
      "record_key": "rk1_fb67d1e967e22b14fe65",
      "run run_07c597b8258f61ac (geocode_batch): id": "york",
      "run run_07c597b8258f61ac (geocode_batch): address": "York Minster, York YO1 7HH",
      "run run_07c597b8258f61ac (geocode_batch): Placed": "placed",
      "run run_07c597b8258f61ac (geocode_batch): Precision": "rooftop",
      "run run_07c597b8258f61ac (geocode_batch): Confidence": "high",
      "run run_07c597b8258f61ac (geocode_batch): Street": "Minster Yard",
      "run run_07c597b8258f61ac (geocode_batch): City": "York",
      "run run_07c597b8258f61ac (geocode_batch): County": "York",
      "run run_07c597b8258f61ac (geocode_batch): State": "England",
      "run run_07c597b8258f61ac (geocode_batch): Postcode": "YO1 7HH",
      "run run_07c597b8258f61ac (geocode_batch): Country": "GB",
      "run run_07c597b8258f61ac (geocode_batch): Council": "York",
      "run run_07c597b8258f61ac (geocode_batch): UPRN": "200004778770",
      "run run_07c597b8258f61ac (geocode_batch): Record key": "rk1_fb67d1e967e22b14fe65",
      "run run_ec5e360aa4e6152c (get_area_risk): id": "york",
      "run run_ec5e360aa4e6152c (get_area_risk): address": "York Minster, York YO1 7HH",
      "run run_ec5e360aa4e6152c (get_area_risk): flood zone": "Zone 1",
      "run run_ec5e360aa4e6152c (get_area_risk): Confidence": "medium",
      "in_runs": [
        "run run_07c597b8258f61ac (geocode_batch)",
        "run run_ec5e360aa4e6152c (get_area_risk)"
      ]
    }
  ]
}

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).
