# maplibre-mcp

> maplibre-mcp is an MCP server that lets AI agents check, render and show MapLibre styles. It validates styles against the MapLibre Style Specification, renders them with MapLibre GL JS, MapLibre Native or a Martin server, compares two versions of a style or two renderers, and shows interactive maps in clients that support MCP Apps. It runs locally with npx and needs no API key.

Add it to an AI client with one of these commands:

- Claude Code: `claude mcp add maplibre -- npx -y maplibre-mcp`
- Codex: `codex mcp add maplibre -- npx -y maplibre-mcp`
- Gemini CLI: `gemini mcp add maplibre npx -- -y maplibre-mcp`
- Grok: `grok mcp add maplibre -- npx -y maplibre-mcp`
- VS Code: `code --add-mcp '{"name": "maplibre", "command": "npx", "args": ["-y", "maplibre-mcp"]}'`
- Claude Desktop, Cursor, Windsurf and most other clients: `{"mcpServers": {"maplibre": {"command": "npx", "args": ["-y", "maplibre-mcp"]}}}`

## Documentation Sets

- [Abridged documentation](https://birkskyum.github.io/maplibre-mcp/llms-small.txt): a compact version of the documentation for maplibre-mcp, with non-essential content removed
- [Complete documentation](https://birkskyum.github.io/maplibre-mcp/llms-full.txt): the full documentation for maplibre-mcp

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation

## Optional

- [Source code](https://github.com/birkskyum/maplibre-mcp)