# maproll

Lets an assistant turn your data into a static map and hand back a permanent URL you can embed in a README or dashboard.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 4
- Author: maproll-io
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/maproll-io/mcp
- Updated: 2026-10-12
- HTML: https://affpapa.org/en/nevibecode/mcp/maproll

## What it does

maproll is an MCP server that renders maps from data and returns them as links. Numeric values produce a choropleth, colours fill regions flat, and text values give qualitative buckets. Regions use ISO 3166-1 alpha-2 codes at world scope (`US`, `DE`, `BR`) and ISO 3166-2 inside a country (`RO-B`, `RO-CJ`).

Four tools ship with it. `create_map` builds a map from your data, `add_layers` puts markers, routes, circles and labels onto one you already have, `find_places` resolves a place name to coordinates and an id, and `describe_options` lists the themes, icons and projections the renderer accepts. You pass structured data — the server owns the URL grammar, so nothing gets assembled by hand.

Every call returns a PNG to look at plus `svg_url`, the permanent link that is the map itself. That same URL is the handle for the next edit, so a map can grow across several turns. Node 20 or newer is required. No API key is needed, though anonymous maps carry the maproll wordmark in the corner; a key from the editor removes it and lasts 90 days, after which published embeds start showing the wordmark again. OpenStreetMap attribution stays either way.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add maproll -- npx -y @maproll/mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add maproll -- npx -y @maproll/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "maproll": {
            "command": "npx",
            "args": [
                "-y",
                "@maproll/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "maproll": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@maproll/mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add maproll npx -y @maproll/mcp
```

## When to use it
- turn a spreadsheet into a map with a shareable link
- draw a sea route through Suez with both ports marked
- highlight EU member states on a light map
- add markers to an existing map over several turns
- embed a map in a README without JavaScript

## Example prompts
- Draw the sea route from Shanghai to Rotterdam and mark both ports.
- Add airport markers to that map and give me a URL I can embed.

## Similar
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mapbox-mcp-server.md) — MCP server · ★ 363
- [mapbox-data-visualization-patterns](https://affpapa.org/en/nevibecode/skills/mapbox-data-visualization-patterns.md) — skill · 2100 installs
- [syncfusion-react-maps](https://affpapa.org/en/nevibecode/skills/syncfusion-react-maps.md) — skill · 707 installs
- [maplibre-tile-sources](https://affpapa.org/en/nevibecode/skills/maplibre-tile-sources.md) — skill · 982 installs
- [geospatial-and-cartographic-visualization](https://affpapa.org/en/nevibecode/skills/geospatial-and-cartographic-visualization.md) — skill · 13 installs
- [chart-designer](https://affpapa.org/en/nevibecode/skills/chart-designer.md) — skill · 5700 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md