GovTribe

Show geo map MCP tool

Minimal: {"series":[{"id":"offices","markers":[{"id":"office-1","lat":38.9,"lng":-77,"label":"Office"}]}]}. Display a simple map with marker popups and routes; it does not collect selections. Basemap access is configured by GovTribe, never supplied in tool arguments. Presentation ID and series labels default; descriptions, colors, styling, clustering and viewport options are optional. Preserve marker, series, route and record IDs. Use it for geographic review, not boundary-layer or heatmap analysis.

Examples

Use maps when the user needs to inspect named facilities, buyer offices, vendor locations, or routes spatially. Pan and zoom to navigate; click a marker for a small popup. Bounds fit the supplied locations automatically unless an optional viewport is provided. Multi-series maps include a legend, and clustering is available for dense point sets.

Maps display locations without selection controls, submission actions, or permanent detail panels. Basemap access belongs to GovTribe application configuration; agents never supply keys or tile-provider URLs. When the basemap is unavailable or unconfigured, the map explains the problem while keeping markers and routes visible. Existing conversations retain saved map-selection receipts.

Minimal working example

{
  "tool": "Show_Geo_Map",
  "arguments": {
    "series": [
      {
        "id": "offices",
        "markers": [
          {
            "id": "office-1",
            "lat": 38.9,
            "lng": -77,
            "label": "Office"
          }
        ]
      }
    ]
  }
}

The presentation id is generated when omitted or null. A series label defaults to its id with words separated. Titles, descriptions, colors, styles, clustering and viewport options are optional. Keep stable series, marker and route IDs and real recordRef identifiers; they identify geographic records.

Show overseas facility locations for review

{
  "tool": "Show_Geo_Map",
  "arguments": {
    "id": "overseas-facility-review",
    "title": "Overseas facilities",
    "description": "Candidate places of performance from the current opportunity set.",
    "viewport": {
      "mode": "fit_all",
      "padding": 40,
      "maxZoom": 8
    },
    "series": [
      {
        "id": "facilities",
        "label": "Facilities",
        "style": {
          "color": "#125475",
          "size": "md",
          "icon": "circle"
        },
        "markers": [
          {
            "id": "facility-guam",
            "lat": 13.4443,
            "lng": 144.7937,
            "label": "Guam facility",
            "subLabel": "Place of performance"
          },
          {
            "id": "facility-okinawa",
            "lat": 26.3344,
            "lng": 127.8056,
            "label": "Okinawa facility",
            "subLabel": "Place of performance"
          }
        ]
      }
    ]
  }
}

Inspect a dense map of target locations

{
  "tool": "Show_Geo_Map",
  "arguments": {
    "id": "target-location-review",
    "title": "Target locations",
    "clustering": {
      "enabled": true,
      "radius": 40,
      "maxZoom": 12,
      "spiderfy": true
    },
    "series": [
      {
        "id": "buyer-sites",
        "label": "Buyer sites",
        "markers": [
          {
            "id": "navsea-hq",
            "lat": 38.8836,
            "lng": -77.0164,
            "label": "NAVSEA HQ"
          },
          {
            "id": "norfolk-naval-shipyard",
            "lat": 36.8085,
            "lng": -76.2971,
            "label": "Norfolk Naval Shipyard"
          }
        ]
      }
    ]
  }
}

Payload patterns

Use series for marker groups and routes for paths between known points. Keep marker IDs stable so location references remain meaningful.

Show a buyer-to-facility route

{
  "tool": "Show_Geo_Map",
  "arguments": {
    "id": "buyer-facility-route",
    "title": "Buyer office to facility",
    "series": [
      {
        "id": "locations",
        "label": "Locations",
        "markers": [
          {
            "id": "buyer-office",
            "lat": 38.8836,
            "lng": -77.0164,
            "label": "Buyer office"
          },
          {
            "id": "target-facility",
            "lat": 36.8085,
            "lng": -76.2971,
            "label": "Target facility"
          }
        ]
      }
    ],
    "routes": [
      {
        "id": "buyer-to-facility",
        "label": "Coordination route",
        "points": [
          {
            "lat": 38.8836,
            "lng": -77.0164
          },
          {
            "lat": 36.8085,
            "lng": -76.2971
          }
        ],
        "style": {
          "color": "#125475",
          "weight": 3,
          "dash": "dashed"
        }
      }
    ]
  }
}