# Maproll

> Maproll is a free MCP server for maps and travel. Make embeddable static maps from an assistant: choropleths, markers and routes as URLs. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, API
- **Website:** https://www.maproll.io/mcp/
- **Repository:** https://github.com/maproll-io/mcp
- **MCP Registry name:** io.maproll/maproll
- **Categories:** maps and travel, design and media
- **Listing updated:** 2026-11-14

## About

Maproll's server hands back a permanent URL instead of a file in a temp folder, and that URL is the map's state. Pass it to add_layers and you get a new URL with the addition applied, so a map is built up over several turns. Each result includes svg_url, png_url, an editor_url to continue by hand, a ready embed tag and warnings for unrecognised region ids.

Four tools cover the work. create_map shades regions by number, paints flat colours or buckets categories; add_layers adds markers, routes, proportional circles, labels and pattern fills; find_places resolves a place name to coordinates and an ISO or IATA code, because models recall coordinates badly; describe_options lists the scopes, themes, icons and projections the renderer accepts. Sea routes follow the Suez, Panama and Malacca lanes.

It runs from npm with `npx -y @maproll/mcp` on Node 20 or newer, with no signup. Free maps carry a maproll wordmark; an API key from app.maproll.io removes it, while OpenStreetMap attribution stays.

## Features

- **URL as state:** Every map is a permanent URL that later tool calls extend.
- **Choropleths and highlights:** Shade by value, colour regions or sort into categories.
- **Layered additions:** Markers, routes, circles, labels and patterns.
- **Place lookup:** Resolves names to coordinates and region codes.
- **Renderer options:** Lists valid themes, icons and projections.

## Good for

- Map a statistic for the ten largest countries
- Draw a shipping route with port markers
- Compare two country groups on a dark map
- Embed a map in a README or newsletter

## Install

### Claude Code (Terminal)

```sh
claude mcp add maproll -- npx -y @maproll/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "maproll": {
      "command": "npx",
      "args": [
        "-y",
        "@maproll/mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "maproll": {
      "command": "npx",
      "args": [
        "-y",
        "@maproll/mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "maproll": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@maproll/mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "maproll": {
      "command": "npx",
      "args": [
        "-y",
        "@maproll/mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "maproll": {
      "command": "npx",
      "args": [
        "-y",
        "@maproll/mcp"
      ]
    }
  }
}
```

## Tools

- `create_map`: Builds a map from countries, regions or values.
- `add_layers`: Adds markers, routes, circles, labels and patterns to a map URL.
- `find_places`: Resolves place names to coordinates and region codes.
- `describe_options`: Lists accepted scopes, themes, icons and projections.

## FAQ

### Do I need an account?

No. It works without signup or key.

### How do I remove the wordmark?

Create an API key in the editor and set MAPROLL_API_KEY; signing in alone does not remove it.

### What does it need to run?

Node 20 or newer and npx.

### Can I keep editing a map?

Yes, editor_url opens it in the maproll editor.

### Is Maproll free?

Yes. Maproll is free to use.

### How do I add Maproll to Claude Code?

Run this command in your terminal: claude mcp add maproll -- npx -y @maproll/mcp

### What are the best alternatives to Maproll?

The closest alternatives to Maproll are HyperFrames by HeyGen, ffmpeg-skill, Tutu eSIM, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/maproll
