# maplibre-mcp (npm · maplibre-mcp)

An MCP server that lets AI agents check, render and show MapLibre styles

- Trust score: 50/100 (low)
- Change this week: −25
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-04

## Components

- npm · `maplibre-mcp`: 50/100 (this document), [markdown](https://verifymcp.io/servers/birkskyum-maplibre-mcp/maplibre-mcp.md), [page](https://verifymcp.io/servers/birkskyum-maplibre-mcp/maplibre-mcp)

## Channel facts

- Registry: `npm`
- Package: `maplibre-mcp`
- Version: `0.9.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-10-04.

- **Supply Chain Security**: 99/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 13 of 46 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 100/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to birkskyum/maplibre-mcp).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 0 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 0/100
  - Schema quality not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- **Tool Coverage**: 0/100
  - Tool coverage not yet verified: we do not have a sandbox capture of the tool definitions this version of the package serves yet.
- **Tool Safety**: 0/100
  - Tool safety not yet verified: we do not have a sandbox capture of the tool definitions this version of the package serves yet.
- **Capabilities**: 0/100
  - Protocol version not yet verified: we do not have a sandbox capture of the MCP handshake this version of the package performs yet.

**Unverified: 5 categories.** Categories scored 0 because our sandbox has not given us the schema these checks need to read. That is a gap on our side rather than a finding about the package, and we only credit what we can confirm, so the score stands at 0 until the capture succeeds. We are working through the fleet, so this normally clears without any action from you.

## Install

### How do I install the maplibre-mcp server?

maplibre-mcp runs locally as an npm package, launched with npx -y maplibre-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add birkskyum-maplibre-mcp -- npx -y maplibre-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "birkskyum-maplibre-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "maplibre-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "birkskyum-maplibre-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "maplibre-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add birkskyum-maplibre-mcp -- npx -y maplibre-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "birkskyum-maplibre-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "maplibre-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add birkskyum-maplibre-mcp --command npx --arg -y --arg maplibre-mcp
```

### Hermes

```yaml
mcp_servers:
  birkskyum-maplibre-mcp:
    command: "npx"
    args: ["-y", "maplibre-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "birkskyum-maplibre-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "maplibre-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add birkskyum-maplibre-mcp -t stdio -c npx -a -y maplibre-mcp
```

### Other

```json
{
  "mcpServers": {
    "birkskyum-maplibre-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "maplibre-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-04 (score 50, −28)

- [security regression] Stability: 0.23 → unverified
- [security regression] Tool safety: pass → unverified
- [functional regression] Capabilities: pass → unverified
- [functional regression] Schema quality: 0 → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional] Package version: 0.8.1 → 0.9.1

### 2026-10-03 (score 78, +1)

- [security regression] Stability: 0.20 → unverified
- [security regression] Tool safety: pass → unverified
- [security regression] Malware scan: pass → unverified
- [functional regression] Capabilities: pass → unverified
- [functional regression] Schema quality: 0 → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional] Package version: 0.7.1 → 0.8.1
- [functional] Package version: 0.7.1 → 0.8.0

### 2026-10-01 (score 77, +16)

- [security improvement] Malware scan: unverified → pass

### 2026-09-30 (score 61, 0)

- [security improvement] Malware scan: unverified → pass
- [functional] Package version: 0.7.0 → 0.7.1

### 2026-09-29 (score 61, −14)

- [security regression] Malware scan: pass → unverified
- [functional regression] Schema quality: 2025 → 2416
- [functional] Package version: 0.6.1 → 0.7.0

### 2026-09-28 (score 75, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-09-27 (score 75, +1)

- [functional improvement] Stability: unverified → 0.03
- [functional] Package version: 0.6.0 → 0.6.1

### 2026-09-26 (score 74)

First indexed and scored.

## MCP tools (13)

### `validate_style` (~104 tokens)

Validate style

Checks a MapLibre style against the MapLibre Style Specification and lists every problem, each with the path to the property it is about. Run it after editing a style. Pass the style as an object, a URL or a file path.

Input parameters:

- `path` (string): Path to a style JSON file, relative to the directory the server runs in.
- `style` (object): The style as a JSON object.
- `url` (string): URL of a style JSON document.

Output parameters:

- `problems` (array)

### `describe_style_spec` (~132 tokens)

Describe style spec

Looks up a name in the MapLibre Style Specification: a layer type (like "fill"), a layer or root property (like "fill-extrusion-height" or "sky"), a source type (like "geojson") or an expression operator (like "interpolate"). Returns its documentation, type, default, allowed values, expression support and which MapLibre GL JS and MapLibre Native versions support it. Check here before using a property you are not sure exists in MapLibre, since Mapbox GL JS has properties that MapLibre does not.

Input parameters:

- `name` (string, required): The name to look up.

### `describe_sources` (~153 tokens)

Describe sources

Reads the metadata of every source in a MapLibre style (TileJSON, PMTiles headers and GeoJSON data) and lists the source layers and fields each one provides. Then checks that every layer uses a source, source layer and fields that exist. Use it before writing layers against data you do not know. inspect_tile shows the values the fields take, and debug_layers says what each layer draws at a place. Pass the style as an object, a URL or a file path.

Input parameters:

- `path` (string): Path to a style JSON file, relative to the directory the server runs in.
- `style` (object): The style as a JSON object.
- `url` (string): URL of a style JSON document.

### `inspect_tile` (~321 tokens)

Inspect tile

Reads the vector tile of a source at a place and zoom, and lists each source layer with its number of features, their geometry types, the values of each field and a few example features. It also gives the zoom range of the source and the source layers its metadata lists that the tile lacks. Use it to learn the values data really has, like the classes of roads, before writing filters and expressions. The source is either the id of a source in the style you pass, or the URL of a vector source: a TileJSON URL like a Martin source, a PMTiles archive, or a tile URL with {z}, {x} and {y}. Reads MVT and MLT tiles.

Input parameters:

- `center` (array): [longitude, latitude] of the place to read. Defaults to the center of the style or the source.
- `examples` (integer): How many example features to show for each source layer. Defaults to 3.
- `layer` (string): Only list this source layer.
- `path` (string): Path to a style JSON file, relative to the directory the server runs in.
- `source` (string): The id of a source in the style, or the URL of a vector source. Defaults to the only vector source of the style.
- `style` (object): The style as a JSON object.
- `url` (string): URL of a style JSON document.
- `zoom` (number): Zoom level of the tile. Defaults to the zoom of the style, or the highest zoom of the source.

### `debug_layers` (~269 tokens)

Debug layers

Says for each layer of a style whether it draws anything at a place and zoom, and when it draws nothing, why: it is hidden or outside its zoom range, the tile lacks its source layer, its filter matches no feature (listed with the values the tile has), a fill layer gets no polygons, its opacity, width or size is 0 or its color transparent, or icons are missing from the sprite. It also notes text that GL JS draws with local fonts and MapLibre Native leaves out, because the style has no glyphs URL or the glyph server lacks its font stack. It reads the vector tiles and GeoJSON data at the place. Use it when a layer draws nothing. Pass the style as an object, a URL or a file path.

Input parameters:

- `center` (array): [longitude, latitude] of the place. Defaults to the center of the style.
- `layers` (array): Only check these layers, by id. Defaults to every layer.
- `path` (string): Path to a style JSON file, relative to the directory the server runs in.
- `style` (object): The style as a JSON object.
- `url` (string): URL of a style JSON document.
- `zoom` (number): Zoom level. Defaults to the zoom of the style.

### `format_style` (~103 tokens)

Format style

Formats a MapLibre style with the keys in the order of the style specification and two space indentation, the same way as gl-style-format. A style given as a file path is formatted in place, otherwise the formatted JSON is returned.

Input parameters:

- `path` (string): Path to a style JSON file, relative to the directory the server runs in.
- `style` (object): The style as a JSON object.
- `url` (string): URL of a style JSON document.

### `migrate_style` (~114 tokens)

Migrate style

Migrates an old style to the current MapLibre Style Specification, the same way as gl-style-migrate: version 7 styles become version 8, and legacy functions and filters become expressions. A style given as a file path is migrated in place, otherwise the migrated JSON is returned.

Input parameters:

- `path` (string): Path to a style JSON file, relative to the directory the server runs in.
- `style` (object): The style as a JSON object.
- `url` (string): URL of a style JSON document.

### `describe_gl_js_api` (~212 tokens)

Describe GL JS API

Looks up a class, method, option, event or function of MapLibre GL JS, like "Map", "Map#flyTo", "MapOptions.maxPitch", "click" or "addProtocol", in the type definitions that GL JS ships. Returns its signature, documentation, parameters, default and examples, and for a class or an options type, its members. Answers for the GL JS version this server renders with, or for another version, like the one a project uses. Check here before using a method or option you are not sure exists in MapLibre, since Mapbox GL JS has some that MapLibre GL JS does not.

Input parameters:

- `name` (string, required): The name to look up, like "Map#flyTo", "flyTo" or "MapOptions".
- `version` (string): A GL JS version or range, like "5.6.0" or "5", whose type definitions are fetched from jsDelivr. Defaults to the version this server renders with.

### `show_map` (~143 tokens)

Show map

Shows the user an interactive MapLibre map in the chat, with GeoJSON layers and markers on an OpenFreeMap basemap. The user sees the map and you do not; to look at a map yourself, use render_style. Without center and zoom, the map fits the layers and markers. Needs a client that supports MCP Apps.

Input parameters:

- `basemap` (string): The OpenFreeMap style to draw on.
- `bearing` (number)
- `center` (array): [longitude, latitude] of the map center.
- `layers` (array)
- `markers` (array)
- `pitch` (number)
- `zoom` (number)

### `search_ecosystem` (~278 tokens)

Search the MapLibre ecosystem

Searches Make with MapLibre (makewithmaplibre.com), a curated directory of what works with MapLibre: SDKs and framework bindings, GL JS plugins, routing and navigation, geocoding, styling and tiling tools, AI tools (MCP servers and agent skills), hosted APIs, the products built with MapLibre, and consultancies. Use it to pick an SDK for a platform or framework, find a plugin or a service, find a platform or data source to build on, or see which products use a library. Each result has its links and a page with more. Follow up with find_basemaps for style URLs to render.

Input parameters:

- `kind` (string): Only entries of this kind. ai is MCP servers and agent skills for MapLibre. plugin includes the routing and geocoding controls for MapLibre GL JS. routing, geocoding, styling and tiling include the h…
- `limit` (integer): The most results to return.
- `platform` (string): Only entries that run on this platform. Hosted services and consultancies have no platform and are kept.
- `query` (string): Words that each result has to contain, like "react", "draw" or "routing". Leave it out to list the most prominent entries.

### `find_basemaps` (~159 tokens)

Find basemaps

Lists the basemaps in Make with MapLibre (makewithmaplibre.com): ready-made MapLibre styles from OpenFreeMap, Protomaps, MapTiler, Stadia Maps, VersaTiles and others, with their style URLs and whether they need an API key, plus raster and elevation tiles. Pass a style URL as url to render_style or compare_styles to see it, or start a style from it.

Input parameters:

- `free` (boolean): true for only the basemaps that need no API key, false for only those that do.
- `query` (string): Words that each basemap has to contain, in its name, provider or description, like "dark", "satellite" or "openfreemap".

### `render_style` (~247 tokens)

Render style

Renders a MapLibre style to a PNG image, so you can see what the style looks like, for example after changing it. Also reports what the renderer noticed, such as style errors, failed requests, and fonts and icons that are missing. Pass the style as an object, a URL or a file path. Without center, zoom or bounds, the camera stored in the style is used.

Input parameters:

- `bearing` (number): The compass direction at the top of the map, in degrees.
- `bounds` (array): [west, south, east, north] to fit the map to, instead of center and zoom.
- `center` (array): [longitude, latitude] of the map center.
- `height` (integer)
- `path` (string): Path to a style JSON file, relative to the directory the server runs in.
- `pitch` (number): Tilt in degrees from looking straight down.
- `renderer` (string): The MapLibre renderer to draw with.
- `style` (object): The style as a JSON object.
- `url` (string): URL of a style JSON document.
- `width` (integer)
- `zoom` (number)

### `compare_styles` (~226 tokens)

Compare styles

Renders two versions of a MapLibre style at the same camera, and returns one image with the style before, the style after, and their differences in red. Use it after changing a style, to check that the change did what you meant and nothing else, at a few places and zoom levels. Pass each style as an object, a URL or a file path.

Input parameters:

- `after` (object, required): The style after the change.
- `bearing` (number): The compass direction at the top of the map, in degrees.
- `before` (object, required): The style before the change.
- `bounds` (array): [west, south, east, north] to fit the map to, instead of center and zoom.
- `center` (array): [longitude, latitude] of the map center.
- `height` (integer)
- `pitch` (number): Tilt in degrees from looking straight down.
- `renderer` (string): The MapLibre renderer to draw both with.
- `width` (integer): Width of each of the three images.
- `zoom` (number)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/birkskyum-maplibre-mcp/maplibre-mcp#diagnostics

## Score history

- 2026-10-04: 50
- 2026-10-03: 78
- 2026-10-02: 77
- 2026-10-01: 77
- 2026-09-30: 61
- 2026-09-29: 61
- 2026-09-28: 75
- 2026-09-27: 75
- 2026-09-26: 74

## Common questions

### What is the maplibre-mcp server?

maplibre-mcp is listed in the public MCP registry as io.github.birkskyum/maplibre-mcp. An MCP server that lets AI agents check, render and show MapLibre styles. This page covers its npm package (maplibre-mcp).

### Is the maplibre-mcp server safe to use?

maplibre-mcp scores 50 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 4 October 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the maplibre-mcp server expose?

maplibre-mcp exposes 13 tools: validate_style, describe_style_spec, describe_sources, inspect_tile, debug_layers, and 8 more. Their descriptions and schemas cost roughly 2,461 tokens of context every time the server is loaded.

### Is the maplibre-mcp server still maintained?

maplibre-mcp is still listed as active in the MCP registry. We last reached this channel on 4 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the maplibre-mcp server under?

maplibre-mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- npm package: https://www.npmjs.com/package/maplibre-mcp
- Socket report: https://socket.dev/npm/package/maplibre-mcp
- Repository: https://github.com/birkskyum/maplibre-mcp
- Website: https://birkskyum.github.io/maplibre-mcp/
- Changelog RSS feed: https://verifymcp.io/servers/birkskyum-maplibre-mcp/maplibre-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/birkskyum-maplibre-mcp/maplibre-mcp.json
- HTML version of this page: https://verifymcp.io/servers/birkskyum-maplibre-mcp/maplibre-mcp