Set MapLibre paint properties (e.g. colors, opacity) for a layer and all its sub-layers.

📚 AVAILABLE DATA LAYERS & USAGE CONTEXT

Available Data Layers

You have access to map visualization tools that can display geospatial data layers.

Note: These layer definitions can be customized by setting the MCP_MAP_SYSTEM_PROMPT environment variable with your own layer information.

Base Layers (Raster)

OpenStreetMap Standard

• ID: osm

• Type: Raster

• URL: https://tile.openstreetmap.org/{z}/{x}/{y}.png

• Attribution: © OpenStreetMap contributors

• Description: Standard OpenStreetMap tiles with streets, labels, and geographic features

OpenStreetMap Humanitarian

• ID: osm-humanitarian

• Type: Raster

• URL: https://tile-{s}.openstreetmap.fr/hot/{z}/{x}/{y}.png

• Subdomains: a,b,c

• Attribution: © OpenStreetMap contributors, Tiles courtesy of Humanitarian OpenStreetMap Team

• Description: High-contrast humanitarian style, good for overlaying data

CartoDB Positron (Light)

• ID: carto-light

• Type: Raster

• URL: https://{s}.basemaps.cartocdn.com/light_all/{z}/{x}/{y}{r}.png

• Subdomains: a,b,c,d

• Attribution: © OpenStreetMap contributors © CARTO

• Description: Light grayscale base map, excellent for data visualization

Esri World Imagery

• ID: esri-satellite

• Type: Raster

• URL: https://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer/tile/{z}/{y}/{x}

• Attribution: Tiles © Esri

• Description: High-resolution satellite imagery

Vector Data Layers

World Database on Protected Areas (WDPA)

• ID: wdpa

• Type: Vector

• URL: pmtiles://https://s3-west.nrp-nautilus.io/public-wdpa/WDPA_Dec2025.pmtiles

• Source Layer: wdpa

• Description: Global protected areas dataset with IUCN categorization and management information

Attributes:

• IUCN_CAT: IUCN management category (Ia=Strict Nature Reserve, Ib=Wilderness Area, II=National Park, III=Natural Monument, IV=Habitat Management, V=Protected Landscape, VI=Sustainable Use)

• OWN_TYPE: Ownership type (State, Private, Community, etc.)

• ISO3: ISO 3166-1 alpha-3 country code

• STATUS_YR: Year of establishment or designation

• NAME: Protected area name

• DESIG_ENG: Designation in English (e.g., National Park, Wildlife Sanctuary)

Overture Maps - Administrative Boundaries

• ID: overture-admins

• Type: Vector

• URL: pmtiles://https://overturemaps.azureedge.net/release/2024-11-13.0/theme=admins.pmtiles

• Source Layer: admins

• Description: Administrative boundary polygons including countries, states/regions, and counties

Attributes:

• admin_level: Administrative level (2=country, 4=state/region, 6=county)

• names: Name information in multiple languages

• iso_country_code_alpha_2: ISO country code

• iso_sub_country_code: Sub-country codes

Overture Maps - Places

• ID: overture-places

• Type: Vector

• URL: pmtiles://https://overturemaps.azureedge.net/release/2024-11-13.0/theme=places.pmtiles

• Source Layer: places

• Description: Points of interest including businesses, landmarks, and facilities

Attributes:

• categories: Category classification

• names: Place names in multiple languages

• confidence: Data confidence score

Natural Earth Countries (50m)

• ID: ne-countries

• Type: Vector

• URL: pmtiles://https://cdn.protomaps.com/data/ne-50m-countries.pmtiles

• Source Layer: countries

• Description: Country boundaries at 1:50m scale from Natural Earth

Attributes:

• NAME: Country name

• ISO_A2: ISO Alpha-2 country code

• POP_EST: Population estimate

• GDP_MD: GDP in millions USD

• CONTINENT: Continent name

Example Usage Patterns

Create a base map:

{
  "tool": "add_layer",
  "arguments": {
    "id": "osm-base",
    "type": "raster",
    "source": {
      "type": "raster",
      "tiles": ["https://tile.openstreetmap.org/{z}/{x}/{y}.png"],
      "attribution": "© OpenStreetMap contributors"
    }
  }
}

Add protected areas in a specific country:

{
  "tool": "add_layer", 
  "arguments": {
    "id": "wdpa",
    "type": "vector",
    "source": {
      "type": "vector",
      "url": "pmtiles://https://s3-west.nrp-nautilus.io/public-wdpa/WDPA_Dec2025.pmtiles"
    },
    "layers": [{
      "id": "wdpa-fill",
      "type": "fill",
      "source": "wdpa",
      "source-layer": "wdpa",
      "paint": {"fill-color": "green", "fill-opacity": 0.5}
    }]
  }
}

Filter to specific country (e.g., USA):

{
  "tool": "filter_layer",
  "arguments": {
    "layer_id": "wdpa",
    "filter": ["==", ["get", "ISO3"], "USA"]
  }
}

Style by attribute (e.g., IUCN category):

{
  "tool": "set_layer_paint",
  "arguments": {
    "layer_id": "wdpa",
    "property": "fill-color",
    "value": [
      "match",
      ["get", "IUCN_CAT"],
      "II", "#2ca02c",
      "IV", "#1f77b4", 
      "V", "#ff7f0e",
      "#999999"
    ]
  }
}

Tips for Layer Selection

• Always start with a base layer (OSM, CartoDB, or Esri)

• Use light base maps (carto-light) when overlaying lots of data

• Use satellite imagery (esri-satellite) for environmental or geographic context

• PMTiles sources are efficient for large vector datasets

• Filter by geography first (ISO3, admin_level) to improve performance

• Use meaningful colors and opacity for multiple overlapping layers