Skip to main content
Glama

MCP Map Server

A Model Context Protocol (MCP) server that provides a dynamic map interface.

start button

Quick Start

Add the hosted MCP endpoint to your LLM client, like so:

Using VSCode

create a .vscode/mcp.json like this: (as in this repo)

{
	"servers": {
		"map-server": {
			"command": "uv",
			"args": [
				"run",
				"mcp-map-server",
				"--transport",
				"stdio",
				"--prompt-file",
				"system-prompt.example.md"
			]
		},
	}
}

You should see a little icon appear above the entry to "Start" server, like so:

start button

claude call

alt text

Configuring Data Layer Information

The server supports MCP prompts to provide AI agents with information about available data layers. This helps agents understand which layers are available, their attributes, and how to use them effectively.

Recommended: Use a Markdown file

You can provide a system prompt as a plain markdown file:

mcp-map-server --prompt-file my-layers.md

Related MCP server: MCP Boilerplate

Tooling & API

Every map-modifying tool returns the full, updated map configuration in JSON format.

Available Tools

  • add_layer: Adds a raster (XYZ/Tiles) or vector (MVT/PMTiles) layer.

  • set_map_view: Moves the camera to a specific center and zoom.

  • filter_layer: Applies MapLibre filter expressions to an existing layer.

  • set_layer_paint: Dynamically modifies paint properties (colors, opacity, etc.).

  • remove_layer: Deletes a layer by ID.

  • get_map_config: Returns the current session/provided state as JSON.

MCP Client Configuration

To use this with MCP-compatible clients like Claude Desktop or VSCode extensions, point them to the server.

Local Development (Recommended):

Local clients like Claude Desktop and VSCode expect StdIO transport when launching a command. The server now defaults to stdio.

{
  "mcpServers": {
    "map-server": {
      "command": "uv run mcp-map-server"
    }
  }
}

Passing CLI Arguments (Transport, Prompts, etc.):

If you need to specify the transport explicitly or provide a custom system prompt file, use the args array.

IMPORTANT

Arguments must be passed as individual elements in theargs array, NOT as part of the command string.

{
  "mcpServers": {
    "map-server": {
      "command": "uv run mcp-map-server",
      "args": [
        "--transport", "stdio",
        "--prompt-file", "/path/to/my-layers.md"
      ]
    }
  }
}

Note: The server defaults to stdio when run as a command.

Using the Shared Production Server:

Web-based or remote clients connect via HTTP.

{
  "mcpServers": {
    "map-server": {
      "url": "https://mcp-map.nrp-nautilus.io/mcp/"
    }
  }
}

License

MIT

Available Tools

7 tools
add_layerA

Add a MapLibre source and one or more layers. Maps to map.addSource() and map.addLayer().


📚 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


Inputs: id (required), type (required), source (required), state, +3 more.

filter_layerA

Apply a MapLibre filter expression to 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


Inputs: filter (required), layer_id (required), state, session_id.

get_map_configA

Return the current map configuration as a JSON string for inspection or as 'state' for other tools.

Inputs: state, session_id.

list_layersA

List all currently active layers in the session.

Inputs: state, session_id.

remove_layerA

Remove a layer and its associated source from the map.

Inputs: id (required), state, session_id.

set_layer_paintB

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


Inputs: value (required), layer_id (required), property (required), state, +1 more.

set_map_viewB

Move the map camera to a specific center and zoom level.


📚 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


Inputs: zoom, state, center, session_id.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a distinct operation: add/remove layers, set view, list layers, filter layers, set paint, and get config. There is no overlap that would cause an agent to misselect between tools.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun snake_case pattern (add_layer, remove_layer, set_map_view, list_layers, filter_layer, set_layer_paint, get_map_config), making the naming predictable and uniform.

    Tool Count5/5

    With 7 tools, the server is well-scoped for map visualization, covering essential operations without unnecessary bloat. This is within the ideal 3-15 tool range.

    Completeness5/5

    The layer lifecycle is thoroughly covered: add, remove, list, filter, and style layers, plus camera control and full configuration inspection. There are no obvious gaps for typical map manipulation tasks.

    Related MCP Connectors

    Related MCP Servers